On Wed, Jul 17, 2019 at 03:25:10PM +0200, Michał Górny wrote: > Hello, > > The QA team would like to introduce the following policy: > > """ > 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. > """ Reading this wording I feel some of the other response have missed the intent of this policy.
It would be better as two separate policy statements: """ Packages must not disable installing manpages via USE flags. FEATURES=noman should be used to restrict installation of manpages. """ The install part I feel is uncontroversial in itself, as it does leave open that a USE flag could control dependencies & building the manpages (yes, I'm rules-lawyering). """ Package maintainers must build & distribute pre-built manpages IFF (upstream does not offer them) AND (building manpages requires build-time additional dependencies) """ I agree with the goals of the shipping manpages, but I'm worried about the requirements it imposes. - requires the maintainer has some tooling SOMEWHERE to build & package the manpages. Does this go into the ebuild somehow (e.g. a special phase)? If not, where else does it get maintained for each package? - requires a consistent hosting solution for the additional distfiles created by this change (projects.g.o?). - significantly increases the version bump requirements (can't simply copy & local-build & quick-test & commit) - may require special handling to build & ship manpages in multiple languages (admittedly very few packages offer non-english manpages). => the maintainer now needs to build manpages for ALL possible languages. This might require the maintainer has lots of locales on their local system. -- Robin Hugh Johnson Gentoo Linux: Dev, Infra Lead, Foundation Treasurer E-Mail : robb...@gentoo.org GnuPG FP : 11ACBA4F 4778E3F6 E4EDF38E B27B944E 34884E85 GnuPG FP : 7D0B3CEB E9B85B1F 825BCECF EE05E6F6 A48F6136
Description: PGP signature