Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev <gentoo-dev@l.g.o>
Cc: qa <qa@g.o>
Subject: [gentoo-dev] [RFC] New QA policy: Packages must not disable installing manpages via USE flags
Date: Wed, 17 Jul 2019 13:25:21
Message-Id: abbb60a0f4fa5db92cd03d9fc1c7e4b899348bb3.camel@gentoo.org
1 Hello,
2
3 The QA team would like to introduce the following policy:
4
5 """
6 Packages must not disable installing manpages via USE flags (e.g.
7 USE=man or USE=doc). If upstream does not ship prebuilt manpages
8 and building them requires additional dependencies, the maintainer
9 should build them and ship along with the package.
10 """
11
12
13 Explanatory note:
14
15 This applies to having USE flags that specifically control building
16 manpages. It obviously does not affect:
17
18 a. USE flags that disable building both a program and its manpage (e.g.
19 if USE=gui disables building gfrobnicate, not installing gfrobnicate(1)
20 is correct),
21
22 b. use of LINGUAS to control installed manpages.
23
24
25 Rationale:
26
27 Manpages are the basic form of user documentation on Gentoo Linux. Not
28 installing them is harmful to our users. On the other hand, requiring
29 additional dependencies is inconvenient. Therefore, packaging prebuilt
30 manpages (whenever upstream doesn't do that already) is a good
31 compromise that provides user with documentation without additional
32 dependencies.
33
34
35 What are your comments?
36
37 --
38 Best regards,
39 Michał Górny

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies