Packages guidelines: documentation subpackages name

Ville Skyttä ville.skytta at iki.fi
Sun May 14 15:33:23 UTC 2006


On Sun, 2006-05-14 at 17:12 +0200, Laurent Rineau wrote:
> At http://fedoraproject.org/wiki/Packaging/Guidelines#PackageDocumentation we 
> can read "it is recommended to use *-doc as the subpackage name", whereas in 
> http://fedoraproject.org/wiki/Packaging/ReviewGuidelines we can read 
> "- MUST: Large documentation files should go in a -docs subpackage."
> 
> So, could we agree on one policy? FC and FE seem to mix the two styles of 
> naming. Looking at /var/cache/yum/{core,extras}/primary.xml.gz, if found in 
> fe5:
>   30 "-doc"
>   19 "-docs"
> and in fc5:
>   16 "-doc"
>   5 "-docs"

+1 to -doc.

There's also -manual which could fall into the same category and
packaged just as -doc.  Someone will probably argue that -doc should be
reserved for subpackages and -manual for ones that are built from their
own SRPM, I'll say in advance that I disagree and the user doesn't
care :)




More information about the fedora-extras-list mailing list