[gentoo-commits] proj/policy-guide:master commit in: /

["Ulrich Müller" <ulm@gentoo.org>]

commit:     bf68ca3759a258a121e05f98b1d20960d8a6a617
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Jan 18 17:27:11 2023 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Jan 18 17:27:11 2023 +0000
URL:        https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=bf68ca37

installed-files: Policy against use-conditional manpages

Closes: https://bugs.gentoo.org/689684
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 installed-files.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/installed-files.rst b/installed-files.rst
index 19e72e4..6ccc1be 100644
--- a/installed-files.rst
+++ b/installed-files.rst
@@ -114,3 +114,23 @@ an empty installation image.  Package managers rely on this for some
 optimizations.  Also QA tools make certain assumptions about virtuals,
 e.g., that they must not assign the ``LICENSE`` variable (which would
 be impossible if they installed any files).
+
+
+.. index::
+   pair: installed files; manpages
+
+Installation of manpages
+------------------------
+:PG: 0305
+:Source: QA
+:Reported: no
+
+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.
+
+*Rationale*: Manpages are basic documentation for installed software.
+While additional dependencies are inconvenient for users, not building
+manpages is harmful.  Including (optionally or unconditionally)
+prebuilt manpages is a good compromise.