| 1 |
On Wed, Jul 17, 2019 at 03:25:10PM +0200, Michał Górny wrote: |
| 2 |
> Hello, |
| 3 |
> |
| 4 |
> The QA team would like to introduce the following policy: |
| 5 |
> |
| 6 |
> """ |
| 7 |
> Packages must not disable installing manpages via USE flags (e.g. |
| 8 |
> USE=man or USE=doc). If upstream does not ship prebuilt manpages |
| 9 |
> and building them requires additional dependencies, the maintainer |
| 10 |
> should build them and ship along with the package. |
| 11 |
> """ |
| 12 |
Reading this wording I feel some of the other response have missed the |
| 13 |
intent of this policy. |
| 14 |
|
| 15 |
It would be better as two separate policy statements: |
| 16 |
""" |
| 17 |
Packages must not disable installing manpages via USE flags. |
| 18 |
FEATURES=noman should be used to restrict installation of manpages. |
| 19 |
""" |
| 20 |
|
| 21 |
The install part I feel is uncontroversial in itself, as it does leave |
| 22 |
open that a USE flag could control dependencies & building the manpages |
| 23 |
(yes, I'm rules-lawyering). |
| 24 |
|
| 25 |
""" |
| 26 |
Package maintainers must build & distribute pre-built manpages IFF |
| 27 |
(upstream does not offer them) AND |
| 28 |
(building manpages requires build-time additional dependencies) |
| 29 |
""" |
| 30 |
|
| 31 |
I agree with the goals of the shipping manpages, but I'm worried about |
| 32 |
the requirements it imposes. |
| 33 |
|
| 34 |
- requires the maintainer has some tooling SOMEWHERE to build & package |
| 35 |
the manpages. Does this go into the ebuild somehow (e.g. a special |
| 36 |
phase)? If not, where else does it get maintained for each package? |
| 37 |
- requires a consistent hosting solution for the additional distfiles |
| 38 |
created by this change (projects.g.o?). |
| 39 |
- significantly increases the version bump requirements (can't simply |
| 40 |
copy & local-build & quick-test & commit) |
| 41 |
- may require special handling to build & ship manpages in multiple |
| 42 |
languages (admittedly very few packages offer non-english manpages). |
| 43 |
=> the maintainer now needs to build manpages for ALL possible |
| 44 |
languages. This might require the maintainer has lots of locales on |
| 45 |
their local system. |
| 46 |
|
| 47 |
-- |
| 48 |
Robin Hugh Johnson |
| 49 |
Gentoo Linux: Dev, Infra Lead, Foundation Treasurer |
| 50 |
E-Mail : robbat2@g.o |
| 51 |
GnuPG FP : 11ACBA4F 4778E3F6 E4EDF38E B27B944E 34884E85 |
| 52 |
GnuPG FP : 7D0B3CEB E9B85B1F 825BCECF EE05E6F6 A48F6136 |
Archives