summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2020-04-10 14:54:58 +0200
committerUlrich Müller <ulm@gentoo.org>2021-01-26 19:46:27 +0100
commitcb43291806dac6f2a8d26f2ef4a794b42e8c52a5 (patch)
tree6a51279723177e3429b5071593dca46c75b40fd7 /installed-files.rst
parentdependencies: update eutils.eclass into optfeature.eclass (diff)
downloadpolicy-guide-cb43291806dac6f2a8d26f2ef4a794b42e8c52a5.tar.gz
policy-guide-cb43291806dac6f2a8d26f2ef4a794b42e8c52a5.tar.bz2
policy-guide-cb43291806dac6f2a8d26f2ef4a794b42e8c52a5.zip
installed-files: Virtuals must not install any files.
Closes: https://bugs.gentoo.org/716970 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'installed-files.rst')
-rw-r--r--installed-files.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/installed-files.rst b/installed-files.rst
index db949b0..da6263e 100644
--- a/installed-files.rst
+++ b/installed-files.rst
@@ -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).