From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 9C49A138334 for ; Sat, 20 Jul 2019 18:28:50 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6A94FE075F; Sat, 20 Jul 2019 18:28:46 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 10EDBE01B5 for ; Sat, 20 Jul 2019 18:28:45 +0000 (UTC) Received: from pomiot (d202-252.icpnet.pl [109.173.202.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 9E33A3482B1; Sat, 20 Jul 2019 18:28:43 +0000 (UTC) Message-ID: <739a516aa0d4d3c29b1ac8f797b86ed10526b246.camel@gentoo.org> Subject: Re: [gentoo-dev] [RFC] New QA policy: Packages must not disable installing manpages via USE flags From: =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Cc: qa Date: Sat, 20 Jul 2019 20:28:39 +0200 In-Reply-To: <20190720205029.3f1feadeee1d6bf583e88233@gentoo.org> References: <20190720205029.3f1feadeee1d6bf583e88233@gentoo.org> Organization: Gentoo Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-uu7BD7RkZZ58d+BAsC+e" User-Agent: Evolution 3.30.5 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 X-Archives-Salt: 01fa85cf-106d-4813-9d64-4919078ae579 X-Archives-Hash: 1edb88fd58e44e33c5f6ac0ce6fa11fe --=-uu7BD7RkZZ58d+BAsC+e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sat, 2019-07-20 at 20:50 +0300, Andrew Savchenko wrote: > On Wed, 17 Jul 2019 15:25:10 +0200 Micha=C5=82 G=C3=B3rny wrote: > > Hello, > >=20 > > The QA team would like to introduce the following policy: > >=20 > > """ > > Packages must not disable installing manpages via USE flags (e.g. > > USE=3Dman or USE=3Ddoc). If upstream does not ship prebuilt manpages > > and building them requires additional dependencies, the maintainer > > should build them and ship along with the package. > > """ > >=20 > >=20 > > Explanatory note: > >=20 > > This applies to having USE flags that specifically control building > > manpages. It obviously does not affect: > >=20 > > a. USE flags that disable building both a program and its manpage (e.g. > > if USE=3Dgui disables building gfrobnicate, not installing gfrobnicate(= 1) > > is correct), > >=20 > > b. use of LINGUAS to control installed manpages. > >=20 > >=20 > > Rationale: > >=20 > > 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. > >=20 > >=20 > > What are your comments? >=20 > 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. >=20 > Having USE=3Dman (or USE=3Ddoc) for such purposes is fine. Having > USE=3Dman 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. >=20 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. --=20 Best regards, Micha=C5=82 G=C3=B3rny --=-uu7BD7RkZZ58d+BAsC+e Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAl0zXVdfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldEM3 NkE4NDUwOTQwOThEMjhDQzhCMjZDNTYzOUFEQUUyMzI5RTI0MEUACgkQY5ra4jKe JA6t5wf9HugZSGBaGJ2WYZtTtggN/jFhrnyPTbVq0uuZNhX/FVoZTltIHyuJCtVr VSMiD2xuSBKbEPnV+b/4UoS8a1RoJQw7k6DvPZ0ncBoeiZO4jA1Pn+ed8ZrTpHSc xE5tOFZLfMmq8Z3LmZYgRnWK4HKV4IH0xgk7KxLxZPOoc0MYpWIzgAs2yWeVSayV FI3yDUtq/BQlLM40+PgDWP0sLe8u990KJ67X3WR/ifYwun9//Am12aKHCgKLf2ag 4WDrXZoWNCfHhPq7WR2EbQfzlFLhyeicGA7i8kon8/hobbEUipsQHuduUCpa2QLn xALAbpopl7JwZ1AUZtQ0xNk4FBgoNQ== =xif5 -----END PGP SIGNATURE----- --=-uu7BD7RkZZ58d+BAsC+e--