Gentoo Archives: gentoo-dev

From: Jeroen Roovers <jer@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "."
Date: Sat, 20 Oct 2012 16:52:17
Message-Id: 20121020185126.2de11f3d@marga.jer-c2.orkz.net
In Reply to: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." by Thomas Sachau
1 On Fri, 19 Oct 2012 21:36:36 +0200
2 Thomas Sachau <tommy@g.o> wrote:
3
4 > Pacho Ramos schrieb:
5 > > At least in spanish, it's mandatory to end phrases with a dot ".",
6 > > would you agree with trying to enforce this trivial change with a
7 > > repoman warning?
8
9 DESCRIPTIONs don't and shouldn't contain complete sentences. If they do,
10 they should be fixed.
11
12 Wrong description, and grammatically correct:
13 foo-1.ebuild: "Foo is a tool that does bar."
14
15 Correct description, and grammatically correct:
16 foo-1.ebuild: "a tool that does bar"
17
18 The point is that you're writing a dictionary entry, and not telling a
19 story.
20
21 > I dont know any such requirement from english nor german and neither
22 > do i see any benefit from adding a dot at the end of the DESCRIPTION
23 > variable. So if you want to have a unified behaviour all over the
24 > tree, i would request all descriptions to be without the final dot.
25
26 +1
27
28
29 jer