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
@@ -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.
+ pair: installed files; virtuals
+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).