Update for PG idents

Signed-off-by: Michał Górny <mgorny@gentoo.org>

10 files changed, 102 insertions, 1 deletions

diff --git a/_sources/dependencies.rst.txt b/_sources/dependencies.rst.txt
index 55bba5c..a1f5177 100644
--- a/_sources/dependencies.rst.txt
+++ b/_sources/dependencies.rst.txt
@@ -6,6 +6,7 @@ Dependencies
 
 Optional runtime dependencies
 -----------------------------
+:PG: 0001
 :Source: QA
 :Reference: https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&oldid=104017#USE-Controlled_Optional_RDEPENDS
 :Reported: no
@@ -35,6 +36,7 @@ This is especially important for packages that take long time to build.
 
 =-dependencies with no revision
 -------------------------------
+:PG: 0002
 :Source: QA
 :Reported: by repoman and pkgcheck
 
@@ -67,6 +69,7 @@ Slot and subslot dependencies
 
 on (sub-)slotted packages
 ~~~~~~~~~~~~~~~~~~~~~~~~~
+:PG: 0011
 :Source: QA
 :Reference: https://archives.gentoo.org/gentoo-portage-dev/message/9cae3a92412a007febe7ac0612d50f5f
 :Reported: by repoman and pkgcheck
@@ -100,6 +103,7 @@ means 'verified that any slot is acceptable'.
 
 special case: Qt packages
 ~~~~~~~~~~~~~~~~~~~~~~~~~
+:PG: 0012
 :Source: Qt project
 :Reference: https://wiki.gentoo.org/wiki/Project:Qt/Policies#Dependencies
 :Reported: no
@@ -132,6 +136,7 @@ They point out the case of Qt packages as an example.
 
 Revision bumps on runtime dependency changes
 --------------------------------------------
+:PG: 0003
 :Source: Council
 :Reference: https://projects.gentoo.org/council/meeting-logs/20151011-summary.txt
 :Reported: no
@@ -175,6 +180,7 @@ USE dependencies
 
 on packages without the flag
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:PG: 0021
 :Source: QA (inferred from PMS)
 :Reported: by pkgcheck
 
diff --git a/_sources/ebuild-format.rst.txt b/_sources/ebuild-format.rst.txt
index d2c8dc5..a5bf5aa 100644
--- a/_sources/ebuild-format.rst.txt
+++ b/_sources/ebuild-format.rst.txt
@@ -8,6 +8,7 @@ Ebuild file format
 
 Coding style
 ------------
+:PG: 0101
 :Source: QA
 :Reported: partially via repoman and pkgcheck
 
@@ -32,6 +33,7 @@ the ebuild.
 
 Code must be contained within ebuild and eclasses
 -------------------------------------------------
+:PG: 0102
 :Source: QA
 :Reference: https://bugs.gentoo.org/612630
 :Reported: no
@@ -54,6 +56,7 @@ that possibility, including linting tools.
 
 HOMEPAGE must not contain variables
 -----------------------------------
+:PG: 0103
 :Source: QA
 :Reported: by pkgcheck, highlighted as error by gentoo-syntax
 
@@ -68,12 +71,12 @@ preprocessing, breaking URI support in terminals and editors, as well
 as reducing the usefulness of plain tools such as grep.
 
 
-
 .. index::
    pair: src uri; homepage
 
 SRC_URI must not refer to HOMEPAGE
 ----------------------------------
+:PG: 0104
 :Source: QA
 :Reported: by pkgcheck
 
@@ -87,3 +90,21 @@ incidentally depend on multi-valued variable having a single value
 goes against the principle of least surprise.  Furthermore, it makes
 it hard to copy-paste part of the URI e.g. to investigate the directory
 index.
+
+
+.. index:: keywords; one line
+
+KEYWORDS must be defined on a single line
+-----------------------------------------
+:PG: 0105
+:Source: QA
+:Reported: no
+
+The ``KEYWORDS`` variable must be defined at most once in an ebuild,
+on a single line, with literal content (no variable references, line
+wrapping, appending, etc.).
+
+*Rationale*: it is common for arch teams to use the ``ekeyword`` tool
+when working with large number of ebuilds.  The tool has only limited
+ability to process and modify ebuilds, and therefore developers must
+make sure that it works correctly on their ebuilds.
diff --git a/_sources/filesystem.rst.txt b/_sources/filesystem.rst.txt
index 081ab99..52e20a3 100644
--- a/_sources/filesystem.rst.txt
+++ b/_sources/filesystem.rst.txt
@@ -5,6 +5,7 @@ File system layout
 
 Installation paths
 ------------------
+:PG: 0201
 :Source: QA
 :Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/install-qa-check.d/08gentoo-paths
 :Reported: via install-qa-check.d
@@ -60,6 +61,7 @@ exceptions are:
 
 Support for separate /usr
 -------------------------
+:PG: 0202
 :Source: QA
 :Reference: https://projects.gentoo.org/council/meeting-logs/20130813-summary.txt
             https://projects.gentoo.org/council/meeting-logs/20130924-summary.txt
@@ -79,6 +81,7 @@ from rootfs to initramfs.
 
 Strict multilib layout
 ----------------------
+:PG: 0203
 :Source: QA
 :Reference: https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80multilib-strict
 :Reported: via install-qa-check.d, fatal
@@ -103,6 +106,7 @@ to be correctly found by the dynamic loader.
 
 Static libraries and libtool files
 ----------------------------------
+:PG: 0204
 :Source: QA
 :Reference: https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80libraries
 :Reported: via install-qa-check.d, fatal
@@ -124,6 +128,7 @@ be a waste of space.
 
 Game install locations and ownership
 ------------------------------------
+:PG: 0205
 :Source: Council, clarified by QA
 :Reference: https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt
             https://projects.gentoo.org/council/meeting-logs/20151011-summary.txt
@@ -160,6 +165,7 @@ fulfill that purpose.
 
 Absolute symbolic link targets
 ------------------------------
+:PG: 0206
 :Source: QA
 :Reported: by repoman and pkgcheck (when ebuild-generated)
 
diff --git a/_sources/installed-files.rst.txt b/_sources/installed-files.rst.txt
index b77bc02..c8c55f2 100644
--- a/_sources/installed-files.rst.txt
+++ b/_sources/installed-files.rst.txt
@@ -7,6 +7,7 @@ Installed files
 
 Installation of small files
 ---------------------------
+:PG: 0301
 :Source: QA
 :Reported: no
 
@@ -40,6 +41,7 @@ such a huge package in order to install one tiny file.
 
 Installation of static libraries
 --------------------------------
+:PG: 0302
 :Source: QA
 :Reported: no
 
@@ -61,6 +63,7 @@ libraries if they are never going to be used.
 
 Installation of libtool (.la) files
 -----------------------------------
+:PG: 0303
 :Source: QA
 :Reported: no
 
diff --git a/_sources/keywords.rst.txt b/_sources/keywords.rst.txt
index 272dca4..81db271 100644
--- a/_sources/keywords.rst.txt
+++ b/_sources/keywords.rst.txt
@@ -5,6 +5,7 @@ Keywording and stabilization
 
 Rekeywording on dropped keywords
 --------------------------------
+:PG: 0401
 :Source: QA
 :Reported: by pkgcheck and repoman
 
@@ -23,6 +24,7 @@ a new version or to remove an old version.
 
 Stabilizing new versions
 ------------------------
+:PG: 0402
 :Source: QA
 :Reported: by pkgcheck
 
@@ -50,6 +52,7 @@ requested on remaining architectures in the first place.
 
 Removing stable keywords
 ------------------------
+:PG: 0403
 :Source: QA
 :Reference: https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&oldid=126033#Dropping_Stable_KEYWORDs
 :Reported: n/a
diff --git a/_sources/languages.rst.txt b/_sources/languages.rst.txt
index b84a80c..dc3a142 100644
--- a/_sources/languages.rst.txt
+++ b/_sources/languages.rst.txt
@@ -13,6 +13,7 @@ Python
 
 Eclass usage
 ~~~~~~~~~~~~
+:PG: 0501
 :Source: Python project
 :Reference: https://wiki.gentoo.org/wiki/Project:Python/Eclasses
 :Reported: by pkgcheck
@@ -41,6 +42,7 @@ implementations with minimal changes to existing ebuilds.
 
 Python 2 deprecation
 ~~~~~~~~~~~~~~~~~~~~
+:PG: 0502
 :Source: Python project
 :Reference: https://wiki.gentoo.org/wiki/Project:Python#Python_2_end-of-life
 :Reported: no
diff --git a/_sources/maintainer.rst.txt b/_sources/maintainer.rst.txt
index 07dd3b1..e37daf4 100644
--- a/_sources/maintainer.rst.txt
+++ b/_sources/maintainer.rst.txt
@@ -5,6 +5,7 @@ Package Maintainers
 
 Adding new maintainers
 ----------------------
+:PG: 0601
 :Source: QA
 :Reported: no
 
@@ -31,6 +32,7 @@ them from packages actually within project's profile was hard.
 
 New packages without a maintainer
 ---------------------------------
+:PG: 0602
 :Source: QA
 :Reported: no
 
@@ -50,6 +52,7 @@ to take care of them.
 
 Removing package maintainers
 ----------------------------
+:PG: 0603
 :Source: QA
 :Reported: no
 
diff --git a/_sources/other-metadata.rst.txt b/_sources/other-metadata.rst.txt
index f05014b..c59e0c2 100644
--- a/_sources/other-metadata.rst.txt
+++ b/_sources/other-metadata.rst.txt
@@ -6,6 +6,7 @@ Other metadata variables
 
 Dynamic slots (multislot flag)
 ------------------------------
+:PG: 0701
 :Source: QA (inferred from PMS)
 :Reference: https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&oldid=109991#multislot.2FUSE-dependent_SLOT
 :Reported: ``use`` in global scope triggers fatal error
@@ -42,6 +43,7 @@ invalidation or explicit errors.
 
 HOMEPAGE value must be meaningful
 ---------------------------------
+:PG: 0702
 :Source: QA
 :Reference: https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035
 :Reported: known bad values are reported by pkgcheck
@@ -69,6 +71,7 @@ easy to identify such packages.
 
 RESTRICT=test for USE=-test
 ---------------------------
+:PG: 0703
 :Source: QA
 :Reported: by pkgcheck
 
@@ -94,4 +97,54 @@ this circumstance, and they will not fail for users.
    common, and there is little harm in overspecifying it.
 
 
+.. index:: license
+
+LICENSE
+-------
+:PG: 0704
+:Source: QA
+:Reported: no
+
+The ``LICENSE`` variable must explicitly list licenses for all files
+installed by the package.  If some of the applicable licenses are
+conditional to USE flags, appropriate USE conditionals need to
+be expressed in the variable.
+
+If a package bundles any dependencies that are either installed,
+statically linked or in any other way combined with installed files,
+the licenses of these dependencies need to be listed as well.  This
+is not presently required when statically linking to dependencies
+installed by separate packages in the repository.
+
+The licenses for files that are not installed but that are used at build
+time are not listed explicitly.
+
+*Rationale*: the primary purpose of the license support in the package
+manager is to provide the users with ability to decide on acceptable
+licenses for their installed systems (and binary packages).  In order
+for this to work effectively, the packages must provide a correct
+and complete license list.
+
+Static linking combines code from multiple packages, potentially covered
+by different licenses.  Listing all licenses is the simplest way
+of ensuring that nothing is missed, as well as protecting against wrong
+derivative work licenses stated upstream (i.e. when a less restrictively
+licensed package links to a more restrictively licensed dependency).
+
+Listing of licenses is enforced for bundled dependencies but not for
+static linking to other packages, as in the latter case it is
+non-trivial to implement and the package manager already verifies
+the license while building dependencies (but not when installing binary
+packages).
+
+The ebuild format does not provide a separate variable to list licenses
+needed only at build time.  So far it has not been considered important
+enough to have one, as the relevant files exist only temporarily
+on the user's system and do not affect the runtime use of packages.
+
+.. Note::
+   Please remember to include the licenses of support files provided
+   by the ebuild, e.g. init.d scripts (usually GPL-2).
+
+
 .. _metadata invariance: https://projects.gentoo.org/pms/7/pms.html#x1-600007.1
diff --git a/_sources/use-flags.rst.txt b/_sources/use-flags.rst.txt
index c6a8b4a..4344edc 100644
--- a/_sources/use-flags.rst.txt
+++ b/_sources/use-flags.rst.txt
@@ -8,6 +8,7 @@ USE flags
 
 Versioned USE flags
 -------------------
+:PG: 0801
 :Source: QA
 :Reference: https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&oldid=109991#Versioned_USE_flags
 :Reported: no
@@ -38,6 +39,7 @@ with the QA team before introduction.
 
 USE=gui flag
 ------------
+:PG: 0802
 :Source: QA
 :Reference: https://archives.gentoo.org/gentoo-dev/message/cf3f5a59ac918335766632bd02438722
 :Reported: no
@@ -61,6 +63,7 @@ multiple GUIs.
 
 Underscores in USE flag names
 -----------------------------
+:PG: 0803
 :Source: Council
 :Reference: https://projects.gentoo.org/council/meeting-logs/20191013-summary.txt
 :Reported: by pkgcheck
diff --git a/_sources/user-group.rst.txt b/_sources/user-group.rst.txt
index 389f3b9..09944a5 100644
--- a/_sources/user-group.rst.txt
+++ b/_sources/user-group.rst.txt
@@ -6,6 +6,7 @@ Users and groups
 
 User and group account policy
 -----------------------------
+:PG: 0901
 :Source: QA
 :Reference: https://bugs.gentoo.org/702460
 :Reported: by repoman and pkgcheck (as deprecated eclass)