* Re: [gentoo-dev] [RFC] New QA policy: Packages must not disable installing manpages via USE flags
@ 2019-07-20 18:28 99% ` Michał Górny
0 siblings, 0 replies; 1+ results
From: Michał Górny @ 2019-07-20 18:28 UTC (permalink / raw
To: gentoo-dev; +Cc: qa
[-- Attachment #1: Type: text/plain, Size: 2065 bytes --]
On Sat, 2019-07-20 at 20:50 +0300, Andrew Savchenko wrote:
> On Wed, 17 Jul 2019 15:25:10 +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.
> > """
> >
> >
> > Explanatory note:
> >
> > This applies to having USE flags that specifically control building
> > manpages. It obviously does not affect:
> >
> > a. USE flags that disable building both a program and its manpage (e.g.
> > if USE=gui disables building gfrobnicate, not installing gfrobnicate(1)
> > is correct),
> >
> > b. use of LINGUAS to control installed manpages.
> >
> >
> > Rationale:
> >
> > Manpages are the basic form of user documentation on Gentoo Linux. Not
> > installing them is harmful to our users. On the other hand, requiring
> > additional dependencies is inconvenient. Therefore, packaging prebuilt
> > manpages (whenever upstream doesn't do that already) is a good
> > compromise that provides user with documentation without additional
> > dependencies.
> >
> >
> > What are your comments?
>
> The basic foundation of Gentoo is freedom of choise for our users.
> If installing man pages means no additional dependencies, than
> proposed rule is ok. However if such dependencies are required it is
> up to users to decide if they wan them or not.
>
> Having USE=man (or USE=doc) for such purposes is fine. Having
> USE=man enabled by default in user profile is also fine. Forcing
> users to install unnecessary dependencies on minimal systems in a
> no go and turns Gentoo into something else.
>
Could you please read the proposed policy? It explicitly says you are
*not* supposed to force extra deps on users but build manpages for them.
--
Best regards,
Michał Górny
[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 618 bytes --]
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2019-07-17 13:25 [gentoo-dev] [RFC] New QA policy: Packages must not disable installing manpages via USE flags Michał Górny
2019-07-20 17:50 ` Andrew Savchenko
2019-07-20 18:28 99% ` Michał Górny
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox