commit: 34357105fe3e6f9d42aeb21e863983c420af337f Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Sun Feb 16 15:55:51 2020 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Tue Feb 18 16:04:51 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=34357105
general-concepts/slotting: Clarify that SLOT must not be empty. Not sure from where the concept "an empty slot means disable slotting" originated. In any case, it is wrong, and it was not legal in any EAPI. Update the SLOT section in ebuild-writing/variables, too. Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> ebuild-writing/variables/text.xml | 4 ++-- general-concepts/slotting/text.xml | 10 ++++++---- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml index 6266a68..863330b 100644 --- a/ebuild-writing/variables/text.xml +++ b/ebuild-writing/variables/text.xml @@ -355,8 +355,8 @@ The following variables may or must be defined by every ebuild. <body> <p> -When slots are not needed, use <c>SLOT="0"</c>. Do <b>not</b> use <c>SLOT=""</c>, as -this will disable slotting for this package. +When slots are not needed, use <c>SLOT="0"</c>. Do <b>not</b> use +<c>SLOT=""</c>, because the variable must not be empty. </p> <p> diff --git a/general-concepts/slotting/text.xml b/general-concepts/slotting/text.xml index d1ba524..5bd33b0 100644 --- a/general-concepts/slotting/text.xml +++ b/general-concepts/slotting/text.xml @@ -12,12 +12,14 @@ parallel. This feature is called slotting. </p> <p> -Most packages have no need for slotting. These packages specify <c>SLOT="0"</c> in -the ebuilds. This is <b>not</b> the same as specifying an empty slot -(<c>SLOT=""</c>) <d/> an empty -slot means "disable slotting entirely", and should not be used. +Most packages have no need for slotting. These packages specify <c>SLOT="0"</c> +in the ebuilds. </p> +<note> +<c>SLOT</c> is a mandatory variable and must not be empty. +</note> + <p> Portage permits at most one instance of a package installation <e>per <c>SLOT</c> value</e>. For example, say we have the following:
