diff options
authorUlrich Müller <>2020-04-10 14:54:58 +0200
committerUlrich Müller <>2021-01-26 19:46:27 +0100
commitcb43291806dac6f2a8d26f2ef4a794b42e8c52a5 (patch)
tree6a51279723177e3429b5071593dca46c75b40fd7 /installed-files.rst
parentdependencies: update eutils.eclass into optfeature.eclass (diff)
installed-files: Virtuals must not install any files.
Closes: Signed-off-by: Ulrich Müller <>
Diffstat (limited to 'installed-files.rst')
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
+: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).