[gentoo-commits] proj/pms:master commit in: /

["Ulrich Müller" <ulm@gentoo.org>]

commit:     04e3e077a99e337cb9b9f0d6e710037ba488b6bb
Author:     Ulrich Müller <ulm <AT> kph <DOT> uni-mainz <DOT> de>
AuthorDate: Tue Oct 10 10:19:31 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue Oct 10 10:28:30 2017 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=04e3e077

Appendix: Document retroactive ban of empty dependency groups.

Bug: https://bugs.gentoo.org/370565

 appendices.tex   | 6 ++++++
 dependencies.tex | 1 +
 2 files changed, 7 insertions(+)

diff --git a/appendices.tex b/appendices.tex
index 7227fc8..60e3512 100644
--- a/appendices.tex
+++ b/appendices.tex
@@ -104,6 +104,12 @@ implementation in package managers deviated from what was specified.
 String prefix matching was effective in EAPIs \t{0}, \t{1}, \t{2}, \t{3}, \t{4} and \t{5}. It was
 retroactively dropped in favour of the current behaviour in October 2015.
 
+\subsection{Empty dependency groups}
+The dependency specification format (see section~\ref{sec:dependency-spec}) originally permitted
+all-of, any-of, exactly-one-of, at-most-one-of and use-conditional groups with zero sub-elements.
+However, such empty groups were neither supported by all package managers nor used in ebuilds.
+They were dropped from the specification in October 2017.
+
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
 
 %%% Local Variables:

diff --git a/dependencies.tex b/dependencies.tex
index ed3ea01..093a30b 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -45,6 +45,7 @@ In addition, \t{SRC_URI}, \t{HOMEPAGE}, \t{RESTRICT}, \t{PROPERTIES}, \t{LICENSE
 \t{REQUIRED_USE} use dependency-style specifications to specify their values.
 
 \section{Dependency Specification Format}
+\label{sec:dependency-spec}
 
 The following elements are recognised in at least one class of specification. All elements must
 be surrounded on both sides by whitespace, except at the start and end of the string.