| 1 |
On Sat, 2019-07-20 at 20:50 +0300, Andrew Savchenko wrote: |
| 2 |
> On Wed, 17 Jul 2019 15:25:10 +0200 Michał Górny wrote: |
| 3 |
> > Hello, |
| 4 |
> > |
| 5 |
> > The QA team would like to introduce the following policy: |
| 6 |
> > |
| 7 |
> > """ |
| 8 |
> > Packages must not disable installing manpages via USE flags (e.g. |
| 9 |
> > USE=man or USE=doc). If upstream does not ship prebuilt manpages |
| 10 |
> > and building them requires additional dependencies, the maintainer |
| 11 |
> > should build them and ship along with the package. |
| 12 |
> > """ |
| 13 |
> > |
| 14 |
> > |
| 15 |
> > Explanatory note: |
| 16 |
> > |
| 17 |
> > This applies to having USE flags that specifically control building |
| 18 |
> > manpages. It obviously does not affect: |
| 19 |
> > |
| 20 |
> > a. USE flags that disable building both a program and its manpage (e.g. |
| 21 |
> > if USE=gui disables building gfrobnicate, not installing gfrobnicate(1) |
| 22 |
> > is correct), |
| 23 |
> > |
| 24 |
> > b. use of LINGUAS to control installed manpages. |
| 25 |
> > |
| 26 |
> > |
| 27 |
> > Rationale: |
| 28 |
> > |
| 29 |
> > Manpages are the basic form of user documentation on Gentoo Linux. Not |
| 30 |
> > installing them is harmful to our users. On the other hand, requiring |
| 31 |
> > additional dependencies is inconvenient. Therefore, packaging prebuilt |
| 32 |
> > manpages (whenever upstream doesn't do that already) is a good |
| 33 |
> > compromise that provides user with documentation without additional |
| 34 |
> > dependencies. |
| 35 |
> > |
| 36 |
> > |
| 37 |
> > What are your comments? |
| 38 |
> |
| 39 |
> The basic foundation of Gentoo is freedom of choise for our users. |
| 40 |
> If installing man pages means no additional dependencies, than |
| 41 |
> proposed rule is ok. However if such dependencies are required it is |
| 42 |
> up to users to decide if they wan them or not. |
| 43 |
> |
| 44 |
> Having USE=man (or USE=doc) for such purposes is fine. Having |
| 45 |
> USE=man enabled by default in user profile is also fine. Forcing |
| 46 |
> users to install unnecessary dependencies on minimal systems in a |
| 47 |
> no go and turns Gentoo into something else. |
| 48 |
> |
| 49 |
|
| 50 |
Could you please read the proposed policy? It explicitly says you are |
| 51 |
*not* supposed to force extra deps on users but build manpages for them. |
| 52 |
|
| 53 |
-- |
| 54 |
Best regards, |
| 55 |
Michał Górny |
Archives