On Sun, 26 Feb 2017 21:30:23 -0500 NP-Hardass wrote:
> On 02/23/2017 03:58 PM, Andrew Savchenko wrote:
> > On Thu, 23 Feb 2017 18:50:45 +0100 Ulrich Mueller wrote:
> >>>>>>> On Thu, 23 Feb 2017, Andrew Savchenko wrote:
> >>
> >>>> https://projects.gentoo.org/pms/6/pms.html#x1-180003.1.1 "Category Names"
> >>
> >>> I don't see a requirement here, only note on most common pattern:
> >>
> >>> ``Note: A hyphen is not required because of the virtual category.
> >>> Usually, however, category names will contain a hyphen.''
> >>
> >> It is a note on what is the exclusive pattern, with the single
> >> exception of the virtual category. I believe that we shouldn't break
> >> that pattern.
> > 
> > I'm fine with this approach, but could PMS be updated to contain
> > more clear statement to avoid misunderstanding? E.g.:
> > ``all category names must contain a single hyphen with a
> > special exception for "virtual"''
> > 
> > Best regards,
> > Andrew Savchenko
> > 
> 
> Might be best that this not be a PMS thing, but a Gentoo-specific
> recommendation for developers conveyed via the Devmanual.  That's
> typically the place where Gentoo specifics are added in, like "New
> virtuals shouldn't be added without posting on the Gentoo mailing list,"
> etc.

Maybe. But splitting documentation of one issue into several
documents may confuse readers. We already have "hyphen" in a
category name being mentioned in the PMS, so this should be either
clarified in the PMS or moved completely to the devmanual.

Best regards,
Andrew Savchenko