commit: cb43291806dac6f2a8d26f2ef4a794b42e8c52a5 Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Fri Apr 10 12:54:58 2020 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Tue Jan 26 18:46:27 2021 +0000 URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=cb432918
installed-files: Virtuals must not install any files. Closes: https://bugs.gentoo.org/716970 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> installed-files.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) 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).
