diff options
Diffstat (limited to 'dependencies.tex')
-rw-r--r-- | dependencies.tex | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/dependencies.tex b/dependencies.tex index bcd8e50..1d616dc 100644 --- a/dependencies.tex +++ b/dependencies.tex @@ -187,19 +187,24 @@ EAPI not supporting \t{SLOT} dependencies. }{ } -\featurelabel{use-deps} \IFKDEBUILDELSE { - In EAPIs shown in table~\ref{tab:use-deps-table} as supporting kdebuild-style \t{USE} dependencies, - a specification may additionally be suffixed by one or more kdebuild-style \t{[use]} - restrictions, as described in section~\ref{sec:kdebuild-use-dep}. A package manager must warn or + \featurelabel{use-deps} In EAPIs shown in table~\ref{tab:use-deps-table} as supporting + kdebuild-style \t{USE} dependencies, a specification may additionally be suffixed by one or more + kdebuild-style \t{[use]} restrictions, as described in section~\ref{sec:kdebuild-use-dep}. A + package manager must warn or error if this feature is used with an EAPI not supporting use + dependencies. + + In EAPIs shown in table~\ref{tab:use-deps-table} as supporting 2-style or 3-style \t{USE} + dependencies, a specification may additionally be suffixed by at most one 2-style or 3-style + \t{[use]} restriction, as described in section~\ref{sec:use-dep}. A package manager must warn or error if this feature is used with an EAPI not supporting use dependencies. - -}{} -In EAPIs shown in table~\ref{tab:use-deps-table} as supporting 2-style or 3-style \t{USE} -dependencies, a specification may additionally be suffixed by at most one 2-style or 3-style -\t{[use]} restriction, as described in section~\ref{sec:use-dep}. A package manager must warn or -error if this feature is used with an EAPI not supporting use dependencies. +}{ + \featurelabel{use-deps} In EAPIs shown in table~\ref{tab:use-deps-table} as supporting 2-style + or 3-style \t{USE} dependencies, a specification may additionally be suffixed by at most one + 2-style or 3-style \t{[use]} restriction, as described in section~\ref{sec:use-dep}. A package + manager must warn or error if this feature is used with an EAPI not supporting use dependencies. +} \IFKDEBUILDELSE { @@ -320,11 +325,10 @@ following exceptions: \item Blocks on the ebuild itself do not count. \end{compactitem} -\featurelabel{bang-strength} -There are two strengths of block: weak and strong. A weak block may be ignored by the package -manager, so long as any blocked package will be uninstalled later on. A strong block must not be -ignored. The mapping from one or two exclamation marks to strength is described in -table~\ref{tab:bang-strength-table}. +\featurelabel{bang-strength} There are two strengths of block: weak and strong. A weak block may be +ignored by the package manager, so long as any blocked package will be uninstalled later on. A +strong block must not be ignored. The mapping from one or two exclamation marks to strength is +described in table~\ref{tab:bang-strength-table}. \begin{centertable}{Exclamation mark strengths for EAPIs} \label{tab:bang-strength-table} \IFKDEBUILDELSE @@ -361,14 +365,13 @@ table~\ref{tab:bang-strength-table}. \subsubsection{Slot Dependencies} \label{sec:slot-dep} -\featurelabel{slot-deps} -A named slot dependency consists of a colon followed by a slot name. A specification with a named -slot dependency matches only if the slot of the matched package is equal to the slot specified. If -the slot of the package to match cannot be determined (e.g. because it is not a supported \t{EAPI}), -the match is treated as unsuccessful. +\featurelabel{slot-deps} A named slot dependency consists of a colon followed by a slot name. A +specification with a named slot dependency matches only if the slot of the matched package is equal +to the slot specified. If the slot of the package to match cannot be determined (e.g. because it is +not a supported \t{EAPI}), the match is treated as unsuccessful. -\featurelabel{slot-operator-deps} -An operator slot dependency consists of a colon followed by one of the following operators: +\featurelabel{slot-operator-deps} An operator slot dependency consists of a colon followed by one of +the following operators: \begin{description} \item[*] Indicates that any slot value is acceptable. In addition, for runtime dependencies, @@ -389,11 +392,10 @@ is only for package manager use and must not be used by ebuilds. \subsubsection{Ranged Dependencies} \label{sec:range-dep} - \featurelabel{ranged-deps} - A ranged dependency consists of an open square bracket, followed by zero or more of (a depend - operator followed by a version spec followed by a logical operator) followed by a depend - operator followed by a version spec followed by a close equare bracket. More formally: - \t{ranged-dep ::= '[' (op ver logical-op)* op ver ']' }. + \featurelabel{ranged-deps} A ranged dependency consists of an open square bracket, followed by + zero or more of (a depend operator followed by a version spec followed by a logical operator) + followed by a depend operator followed by a version spec followed by a close equare bracket. + More formally: \t{ranged-dep ::= '[' (op ver logical-op)* op ver ']' }. The following logical operators are supported: @@ -460,11 +462,11 @@ Multiple requirements may be combined using commas, e.g. \t{[first,-second,third When multiple requirements are specified, all must match for a successful match. -\featurelabel{use-dep-defaults} -In a 3-style use dependency, the flag name may immediately be followed by a \e{default} specified by -either \t{(+)} or \t{(-)}. The former indicates that, when applying the use dependency to a package -that does not have the flag in question in \t{IUSE\_REFERENCEABLE}, the package manager shall behave -as if the flag were present and enabled; the latter, present and disabled. +\featurelabel{use-dep-defaults} In a 3-style use dependency, the flag name may immediately be +followed by a \e{default} specified by either \t{(+)} or \t{(-)}. The former indicates that, when +applying the use dependency to a package that does not have the flag in question in +\t{IUSE\_REFERENCEABLE}, the package manager shall behave as if the flag were present and enabled; +the latter, present and disabled. Unless a 3-style default is specified, it is an error for a use dependency to be applied to an ebuild which does not have the flag in question in \t{IUSE\_REFERENCEABLE}. @@ -547,17 +549,15 @@ download the file. section~\ref{sec:restrict} for details. } -\featurelabel{src-uri-arrows} -In EAPIs supporting arrows, if an arrow is used, the filename used when saving to \t{DISTDIR} shall -instead be the name on the right of the arrow. When consulting mirrors (except for those explicitly -listed on the left of the arrow, if \t{mirror://} is used), the filename to the right of the arrow -shall be requested instead of the filename in the URI. +\featurelabel{src-uri-arrows} In EAPIs supporting arrows, if an arrow is used, the filename used +when saving to \t{DISTDIR} shall instead be the name on the right of the arrow. When consulting +mirrors (except for those explicitly listed on the left of the arrow, if \t{mirror://} is used), the +filename to the right of the arrow shall be requested instead of the filename in the URI. \IFKDEBUILDELSE { - \featurelabel{src-uri-labels} - In EAPIs supporting labels, the following labels are legal. See section~\ref{sec:labels} for label - behaviour in general. + \featurelabel{src-uri-labels} In EAPIs supporting labels, the following labels are legal. See + section~\ref{sec:labels} for label behaviour in general. \begin{description} \item[mirrors-first] Mirrors shall be consulted before the listed URI. |