summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2021-08-15 08:33:29 +0200
committerMichał Górny <mgorny@gentoo.org>2021-08-15 08:33:36 +0200
commit27a05bcff5d4ba814b3c1279937e3b38c3c925a5 (patch)
treefd5a476acbd3a566bc904fb91e3c1247f16af28f /_sources
parentRebuild the site (diff)
downloadpolicy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.tar.gz
policy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.tar.bz2
policy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.zip
Rebuild / update
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to '_sources')
-rw-r--r--_sources/dependencies.rst.txt4
-rw-r--r--_sources/deprecation.rst.txt1
-rw-r--r--_sources/installed-files.rst.txt18
3 files changed, 20 insertions, 3 deletions
diff --git a/_sources/dependencies.rst.txt b/_sources/dependencies.rst.txt
index a1f5177..c0afb81 100644
--- a/_sources/dependencies.rst.txt
+++ b/_sources/dependencies.rst.txt
@@ -18,8 +18,8 @@ dependencies is installed.
There is no specific preference as to how user should be informed
of optional runtime dependencies. Three possible ways are
-``optfeature`` from ``eutils`` eclass, ``readme.gentoo-r1`` eclass
-and plain ``elog`` messages.
+``optfeature`` eclass, ``readme.gentoo-r1`` eclass and plain ``elog``
+messages.
*Rationale*: toggling USE flags in order to enable or disable optional
runtime dependencies causes needless rebuilds of packages in question.
diff --git a/_sources/deprecation.rst.txt b/_sources/deprecation.rst.txt
index 83284f5..1fb03a6 100644
--- a/_sources/deprecation.rst.txt
+++ b/_sources/deprecation.rst.txt
@@ -25,7 +25,6 @@ Deprecated eclasses
-------------------
:PG: 1003
:Source: individual eclass maintainers
-:Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf
:Reported: by pkgcheck and repoman
Deprecated eclasses should not be used in new ebuilds. Existing
diff --git a/_sources/installed-files.rst.txt b/_sources/installed-files.rst.txt
index db949b0..da6263e 100644
--- a/_sources/installed-files.rst.txt
+++ b/_sources/installed-files.rst.txt
@@ -88,3 +88,21 @@ and caused many issues, in particular due to hardcoding full paths.
Today they are practically replaced by more portable pkg-config files,
and while libtool keeps generating them, they are considered
unnecessary and potentially harmful.
+
+
+.. index::
+ pair: installed files; virtuals
+
+Virtuals
+--------
+:PG: 0304
+:Source: QA
+:Reported: no
+
+Packages in the ``virtual`` category must not install any files.
+
+*Rationale*: The ``virtual`` category is reserved for packages with
+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).