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.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 3370E15800F for ; Wed, 18 Jan 2023 17:28:51 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 65A07E0769; Wed, 18 Jan 2023 17:28:50 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 4A795E0769 for ; Wed, 18 Jan 2023 17:28:50 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 71FA7335D97 for ; Wed, 18 Jan 2023 17:28:48 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 0C4977DE for ; Wed, 18 Jan 2023 17:28:47 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1674062831.bf68ca3759a258a121e05f98b1d20960d8a6a617.ulm@gentoo> Subject: [gentoo-commits] proj/policy-guide:master commit in: / X-VCS-Repository: proj/policy-guide X-VCS-Files: installed-files.rst X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: bf68ca3759a258a121e05f98b1d20960d8a6a617 X-VCS-Branch: master Date: Wed, 18 Jan 2023 17:28:47 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 5d1983c2-ba31-4c13-bb31-6626232244df X-Archives-Hash: 40af6e219d0904e27431e2914becb302 commit: bf68ca3759a258a121e05f98b1d20960d8a6a617 Author: Ulrich Müller gentoo org> AuthorDate: Wed Jan 18 17:27:11 2023 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Jan 18 17:27:11 2023 +0000 URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=bf68ca37 installed-files: Policy against use-conditional manpages Closes: https://bugs.gentoo.org/689684 Signed-off-by: Ulrich Müller gentoo.org> installed-files.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/installed-files.rst b/installed-files.rst index 19e72e4..6ccc1be 100644 --- a/installed-files.rst +++ b/installed-files.rst @@ -114,3 +114,23 @@ an empty installation image. Package managers rely on this for some optimizations. Also QA tools make certain assumptions about virtuals, e.g., that they must not assign the ``LICENSE`` variable (which would be impossible if they installed any files). + + +.. index:: + pair: installed files; manpages + +Installation of manpages +------------------------ +:PG: 0305 +:Source: QA +:Reported: no + +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. + +*Rationale*: Manpages are basic documentation for installed software. +While additional dependencies are inconvenient for users, not building +manpages is harmful. Including (optionally or unconditionally) +prebuilt manpages is a good compromise.