aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--general-concepts/virtuals/text.xml28
1 files changed, 28 insertions, 0 deletions
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index 5ba9ea5..4809394 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -42,5 +42,33 @@ from the Gentoo repository.
</note>
</body>
+<section>
+<title>KEYWORDS in virtual packages</title>
+
+<body>
+<p>
+Since virtual packages do not install any files, they do not follow the regular
+arch testing procedure. Instead, the developer can immediately set
+the <c>KEYWORDS</c> of a virtual to the union of <c>KEYWORDS</c> of its
+providers. In particular, if a new virtual is created for a stable package,
+the virtual is committed straight to stable.
+</p>
+
+<p>
+For example, if you have two packages: <c>dev-libs/liblinux</c> with
+<c>KEYWORDS="amd64 ~x86"</c> and <c>dev-libs/libbsd</c> with
+<c>KEYWORDS="~amd64-fbsd ~x86-fbsd"</c>, the resulting virtual will
+have:
+</p>
+
+<codesample lang="ebuild">
+KEYWORDS="amd64 ~x86 ~amd64-fbsd ~x86-fbsd"
+
+RDEPEND="|| ( dev-libs/liblinux dev-libs/libbsd )"
+</codesample>
+</body>
+
+</section>
+
</chapter>
</guide>