From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 156601382C5 for ; Tue, 26 Jan 2021 18:48:16 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3E537E0C95; Tue, 26 Jan 2021 18:48:15 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 21C10E0C95 for ; Tue, 26 Jan 2021 18:48:15 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id D416E341088 for ; Tue, 26 Jan 2021 18:48:13 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 711C648B for ; Tue, 26 Jan 2021 18:48:12 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1611686787.cb43291806dac6f2a8d26f2ef4a794b42e8c52a5.ulm@gentoo> Subject: [gentoo-commits] proj/policy-guide:master commit in: / X-VCS-Repository: proj/policy-guide X-VCS-Files: installed-files.rst X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: cb43291806dac6f2a8d26f2ef4a794b42e8c52a5 X-VCS-Branch: master Date: Tue, 26 Jan 2021 18:48:12 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: c5f841fd-447d-4017-b0cb-389d04747864 X-Archives-Hash: 4a4676d3a5a8138aa85d286e1b3c99f5 commit: cb43291806dac6f2a8d26f2ef4a794b42e8c52a5 Author: Ulrich Müller gentoo org> AuthorDate: Fri Apr 10 12:54:58 2020 +0000 Commit: Ulrich Müller gentoo 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 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).