Gentoo Archives: gentoo-dev

From: hasufell <hasufell@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] gentoo-x86 tree cleanup for 'DESCRIPTION ends with a '.' character' warnings
Date: Tue, 12 Aug 2014 12:47:25
Message-Id: 53EA0CC6.6050000@gentoo.org
In Reply to: Re: [gentoo-dev] gentoo-x86 tree cleanup for 'DESCRIPTION ends with a '.' character' warnings by William Hubbs
1 William Hubbs:
2 > On Tue, Aug 12, 2014 at 03:59:30AM +0200, Manuel RĂ¼ger wrote:
3 >> -----BEGIN PGP SIGNED MESSAGE-----
4 >> Hash: SHA512
5 >
6 > *snip*
7 >
8 >> These links might be helpful:
9 >>
10 >> http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=06637c4215d55c57517739214c6e0fd6f8f53914
11 >>
12 >> https://bugs.gentoo.org/show_bug.cgi?id=438976
13 >>
14 >> http://comments.gmane.org/gmane.linux.gentoo.devel/80786
15 >>
16 >>
17 >> What's still missing is a patch for devmanual (if we still really want
18 >> to enforce this).
19 >
20 > I read the thread, and there was no concensus about making this a
21 > repoman check. Some people thought it was a good idea, but there was a
22 > feeling that this sort of thing is trivial and shouldn't be worried
23 > about.
24 >
25
26 That thread is pretty odd.
27
28 First, a sentence does not need to have a predicate. I know that for 99%
29 sure in german and the english wikipedia article seems to suggest the
30 same. Correct me if I am wrong.
31
32 Second, there are valid descriptions that are full ordinary sentences
33 without referencing ${PN}:
34 "Access a working SSH implementation by means of a library".
35
36 In addition, repoman doesn't check for full sentences that reference
37 ${PN}, such as:
38 "Portage is the package management and distribution system for Gentoo".
39
40 So we have another (useless) repoman warning with false positives.

Replies