Hello,

The QA team would like to introduce the following policy:

"""
Packages must not disable installing manpages via USE flags (e.g.
USE=man or USE=doc).  If upstream does not ship prebuilt manpages
and building them requires additional dependencies, the maintainer
should build them and ship along with the package.
"""


Explanatory note:

This applies to having USE flags that specifically control building
manpages.  It obviously does not affect:

a. USE flags that disable building both a program and its manpage (e.g.
if USE=gui disables building gfrobnicate, not installing gfrobnicate(1)
is correct),

b. use of LINGUAS to control installed manpages.


Rationale:

Manpages are the basic form of user documentation on Gentoo Linux.  Not
installing them is harmful to our users.  On the other hand, requiring
additional dependencies is inconvenient.  Therefore, packaging prebuilt
manpages (whenever upstream doesn't do that already) is a good
compromise that provides user with documentation without additional
dependencies.


What are your comments?

-- 
Best regards,
Michał Górny

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to