Gentoo Archives: gentoo-dev

From: Alexandre Rostovtsev <tetromino@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "."
Date: Fri, 19 Oct 2012 20:18:28
Message-Id: 1350677858.29987.41.camel@rook
In Reply to: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." by Pacho Ramos
1 On Fri, 2012-10-19 at 21:01 +0200, Pacho Ramos wrote:
2 > Hello
3 >
4 > At least in spanish, it's mandatory to end phrases with a dot ".", would
5 > you agree with trying to enforce this trivial change with a repoman
6 > warning?
7 >
8 > Thanks for your opinions
9
10 In English, it is also mandatory to end sentences in "."
11
12 But package DESCRIPTION strings are almost never complete sentences; in
13 the vast majority of cases, they are just titles that are noun phrases
14 grammatically, and therefore do not need a "."
15
16 For example, nobody would call descriptions of gcc ("The GNU Compiler
17 Collection"), libX11 ("X.Org X11 library"), or polkit ("Policy framework
18 for controlling privileges for system-wide services") complete English
19 sentences. For one thing, they don't have verbs.
20
21 Some packages do have DESCRIPTIONs that are complete sentences
22 grammatically: x11-libs/qt, for example, has "The Qt toolkit is a
23 comprehensive C++ application development framework." (and it ends in a
24 ".") So for those cases, the ebuild maintainers could append "." if they
25 want to. But even then, I would not make something this trivial into a
26 requirement.