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 |