1 |
On Sun, 26 Feb 2017 21:30:23 -0500 NP-Hardass wrote: |
2 |
> On 02/23/2017 03:58 PM, Andrew Savchenko wrote: |
3 |
> > On Thu, 23 Feb 2017 18:50:45 +0100 Ulrich Mueller wrote: |
4 |
> >>>>>>> On Thu, 23 Feb 2017, Andrew Savchenko wrote: |
5 |
> >> |
6 |
> >>>> https://projects.gentoo.org/pms/6/pms.html#x1-180003.1.1 "Category Names" |
7 |
> >> |
8 |
> >>> I don't see a requirement here, only note on most common pattern: |
9 |
> >> |
10 |
> >>> ``Note: A hyphen is not required because of the virtual category. |
11 |
> >>> Usually, however, category names will contain a hyphen.'' |
12 |
> >> |
13 |
> >> It is a note on what is the exclusive pattern, with the single |
14 |
> >> exception of the virtual category. I believe that we shouldn't break |
15 |
> >> that pattern. |
16 |
> > |
17 |
> > I'm fine with this approach, but could PMS be updated to contain |
18 |
> > more clear statement to avoid misunderstanding? E.g.: |
19 |
> > ``all category names must contain a single hyphen with a |
20 |
> > special exception for "virtual"'' |
21 |
> > |
22 |
> > Best regards, |
23 |
> > Andrew Savchenko |
24 |
> > |
25 |
> |
26 |
> Might be best that this not be a PMS thing, but a Gentoo-specific |
27 |
> recommendation for developers conveyed via the Devmanual. That's |
28 |
> typically the place where Gentoo specifics are added in, like "New |
29 |
> virtuals shouldn't be added without posting on the Gentoo mailing list," |
30 |
> etc. |
31 |
|
32 |
Maybe. But splitting documentation of one issue into several |
33 |
documents may confuse readers. We already have "hyphen" in a |
34 |
category name being mentioned in the PMS, so this should be either |
35 |
clarified in the PMS or moved completely to the devmanual. |
36 |
|
37 |
Best regards, |
38 |
Andrew Savchenko |