From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 02790138010 for ; Sat, 20 Oct 2012 14:27:51 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3920621C015; Sat, 20 Oct 2012 14:27:41 +0000 (UTC) Received: from foo.stuge.se (foo.stuge.se [212.116.89.98]) by pigeon.gentoo.org (Postfix) with SMTP id 43B5B21C010 for ; Sat, 20 Oct 2012 14:27:06 +0000 (UTC) Received: (qmail 15163 invoked by uid 501); 20 Oct 2012 14:27:05 -0000 Message-ID: <20121020142705.15162.qmail@stuge.se> Date: Sat, 20 Oct 2012 16:27:05 +0200 From: Peter Stuge To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." Mail-Followup-To: gentoo-dev@lists.gentoo.org References: <1350673317.12879.30.camel@belkin4> <20121019223736.33f2ee38@pomiocik.lan> <1350713353.12879.57.camel@belkin4> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="VrqPEDrXMn8OVzN4" Content-Disposition: inline In-Reply-To: <1350713353.12879.57.camel@belkin4> X-Archives-Salt: 61a46b56-9a30-4fef-abd7-5b67a0b1b5a3 X-Archives-Hash: 88270ed4794e60f5c1ef3bce7754b7b9 --VrqPEDrXMn8OVzN4 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Pacho Ramos wrote: > > So, rephrasing the example Alexandre pasted, consider: > >=20 > > x11-libs/qt-core - The Qt toolkit is a comprehensive C++ application > > development framework. > >=20 > > vs. > >=20 > > x11-libs/qt-core - A comprehensive C++ application development framework > >=20 > > Which one is better, in your opinion? >=20 > Well, I my case I would prefer second I agree, I also like the second example. > sentence... http://en.wikipedia.org/wiki/Sentence_(linguistics)#Major_and_minor_sentenc= es Suggests that even a phrase such as the second example above can be called a (minor) sentence. > but it would still end with a dot. I think that looks ugly and is redundant. Especially if we were to require that all DESCRIPTION phrases must always be presented with a full stop, I think it is a very bad idea to enforce that they are written into the ebuilds. Especially if there is a rule that they will always be terminated by a full stop then that should and must be added by tools using the ebuild. It makes absolutely no sense to have so frequent redundant data in ebuilds, and it seems like full stop or no full stop is a matter of presentation policy and should thus happen during presentation. > But if it sounds rare for you, no problem. ebuilds are markup and not formatting IMO, and the two shouldn't be confused. If you want to work on presentation (which is important too!) then go for it, but in any case I don't think a full stop at end of descriptions is really worth the cost. All user interfaces are shitty enough already, and users are unable to deal with information already, so please don't add redundancy like full stops would be to the problem. //Peter --VrqPEDrXMn8OVzN4 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iD8DBQFQgrS5hR3Q0dhIfEgRAv9PAKDkv3sgSkA+kEqxWxazhsTpnpAxcACgtBaV Q1oiv5Uge8WQz/8HKtXHuu4= =/ZPt -----END PGP SIGNATURE----- --VrqPEDrXMn8OVzN4--