commit: baa6f758e2f4f21b44b5db92bdba78d8c4b48021 Author: Michał Górny <mgorny <AT> gentoo <DOT> org> AuthorDate: Fri Jan 12 22:57:47 2018 +0000 Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> CommitDate: Tue Feb 13 16:43:07 2018 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=baa6f758
general-concepts/virtuals: Explain how keywording works on virtuals general-concepts/virtuals/text.xml | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) 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>
