diff options
author | Ulrich Müller <ulm@gentoo.org> | 2017-10-02 18:52:41 +0200 |
---|---|---|
committer | Ulrich Müller <ulm@gentoo.org> | 2017-10-08 21:11:24 +0200 |
commit | 693019a78e99a0329b0609c01b0bad3e4b037027 (patch) | |
tree | 0b726378d51e6f22c34fb230d77e9fb4c8dbb865 /dependencies.tex | |
parent | vc: Use UTC in order to prevent flapping of date. (diff) | |
download | pms-693019a78e99a0329b0609c01b0bad3e4b037027.tar.gz pms-693019a78e99a0329b0609c01b0bad3e4b037027.tar.bz2 pms-693019a78e99a0329b0609c01b0bad3e4b037027.zip |
Ban empty groups in dependency specifications.
The specification for empty groups was originally added to match
historical Portage behaviour. However, Portage was changed in 2011
to treat empty dependency groups as an error, therefore ebuilds cannot
rely on any definite behaviour. Consequently, empty groups are not used
by any ebuild or eclass in the Gentoo repository.
Note that the explicit handling for empty groups is still retained for
the case of implicit empty groups resulting from collapsing USE
conditionals in any-of groups et al.
This is a retroactive change for all EAPIs.
Bug: https://bugs.gentoo.org/370565
Diffstat (limited to 'dependencies.tex')
-rw-r--r-- | dependencies.tex | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/dependencies.tex b/dependencies.tex index 1aea135..ed3ea01 100644 --- a/dependencies.tex +++ b/dependencies.tex @@ -60,33 +60,33 @@ be surrounded on both sides by whitespace, except at the start and end of the st \item A use flag name, optionally preceded by an exclamation mark. Permitted in \t{REQUIRED_USE}. \item A simple string. Permitted in \t{RESTRICT} and \t{PROPERTIES}. \item An all-of group, which consists of an open parenthesis, followed by whitespace, - followed by zero or more of (a dependency item of any kind followed by whitespace), followed + followed by one or more of (a dependency item of any kind followed by whitespace), followed by a close parenthesis. More formally: - \t{all-of} \t{::=} \t{'(' whitespace (item whitespace)* ')'}. Permitted in all specification + \t{all-of} \t{::=} \t{'(' whitespace (item whitespace)+ ')'}. Permitted in all specification style variables. \item An any-of group, which consists of the string \t{||}, followed by whitespace, - followed by an open parenthesis, followed by whitespace, followed by zero or more + followed by an open parenthesis, followed by whitespace, followed by one or more of (a dependency item of any kind followed by whitespace), followed by a close parenthesis. - More formally: \t{any-of} \t{::=} \t{'||' whitespace '(' whitespace (item whitespace)* ')'}. + More formally: \t{any-of} \t{::=} \t{'||' whitespace '(' whitespace (item whitespace)+ ')'}. Permitted in \t{DEPEND}, \t{RDEPEND}, \t{PDEPEND}, \t{LICENSE}, \t{REQUIRED_USE}. \item An exactly-one-of group, which consists of the string \t{\textasciicircum\textasciicircum}, followed by whitespace, followed by an open parenthesis, followed by whitespace, followed by - zero or more of (a dependency item of any kind followed by whitespace), followed by a close + one or more of (a dependency item of any kind followed by whitespace), followed by a close parenthesis. More formally: \t{exactly-one-of} \t{::=} \t{'\textasciicircum\textasciicircum' - whitespace '(' whitespace (item whitespace)* ')'}. + whitespace '(' whitespace (item whitespace)+ ')'}. Permitted in \t{REQUIRED_USE}. \item \featurelabel{at-most-one-of} An at-most-one-of group, which consists of the string \t{??}, followed by whitespace, followed by an open parenthesis, followed by whitespace, followed by - zero or more of (a dependency item of any kind followed by whitespace), followed by a close + one or more of (a dependency item of any kind followed by whitespace), followed by a close parenthesis. More formally: \t{at-most-one-of} \t{::=} \t{'??'\ whitespace '(' whitespace - (item whitespace)* ')'}. Permitted in \t{REQUIRED_USE} in EAPIs listed in + (item whitespace)+ ')'}. Permitted in \t{REQUIRED_USE} in EAPIs listed in table~\ref{tab:at-most-one-of-table} as supporting \t{REQUIRED_USE ??}\ groups. \item A use-conditional group, which consists of an optional exclamation mark, followed by a use flag name, followed by a question mark, followed by whitespace, followed by - an open parenthesis, followed by whitespace, followed by zero or more of (a dependency item + an open parenthesis, followed by whitespace, followed by one or more of (a dependency item of any kind followed by whitespace), followed by a close parenthesis. More formally: \t{use-conditional} \t{::=} \t{'!'?\ flag-name '?'\ whitespace '(' whitespace (item - whitespace)* ')'}. + whitespace)+ ')'}. Permitted in all specification style variables. \end{compactitem} |