commit: bd52ad528d3fc7a6c178928c039b0b7097dec816
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Aug 27 11:38:45 2017 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Oct 8 15:47:55 2017 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=bd52ad52
Appendix: Split off retroactive changes from historical curiosities.
appendices.tex | 25 ++++++++++++++-----------
1 file changed, 14 insertions(+), 11 deletions(-)
diff --git a/appendices.tex b/appendices.tex
index 8c97734..dd40041 100644
--- a/appendices.tex
+++ b/appendices.tex
@@ -26,12 +26,13 @@ been abused in the past.
\chapter{Historical Curiosities}
-The items described in this chapter are included for information only. Unless
otherwise noted,
-they were deprecated or abandoned long before \t{EAPI} was introduced. Ebuilds
must not use these
-features, and package managers should not be changed to support them.
+\section{Long-obsolete Features}
-\section{If-else USE Blocks}
+The items described in this section are included for information only. Unless
otherwise noted, they
+were deprecated or abandoned long before EAPI was introduced. Ebuilds must not
use these features,
+and package managers should not be changed to support them.
+\subsection{If-else USE blocks}
Historically, Portage supported if-else use conditionals, as shown by
listing~\ref{lst:if-else-use-listing}. The block before the colon would be
taken if the condition
was met, and the block after the colon would be taken if the condition was not
met.
@@ -49,27 +50,29 @@ DEPEND="
\end{verbatim}
\end{listing}
-\section{cvs Versions}
-
+\subsection{CVS versions}
Portage has very crude support for CVS packages. The package \t{foo} could
contain a file named
\t{foo-cvs.1.2.3.ebuild}. This version would order \e{higher} than any non-CVS
version (including
\t{foo-2.ebuild}). This feature has not seen real world use and breaks
versioned dependencies, so
it must not be used.
-\section{use.defaults}
-
+\subsection{use.defaults}
The \t{use.defaults} file in the profile directory was used to implement
`autouse'---switching USE
flags on or off depending upon which packages are installed. It was deprecated
long ago and finally
removed in 2009.
-\section{Old-style Virtuals}
+\section{Retroactive Changes}
+
+In some exceptional cases, changes to the specification have been approved by
the Gentoo Council
+without introducing a new EAPI. This section lists such retroactive changes.
+\subsection{Old-style virtuals}
Historically, virtuals were special packages rather than regular ebuilds. An
ebuild could specify in
the \t{PROVIDE} metadata that it supplied certain virtuals, and the package
manager had to bear this
in mind when handling dependencies.
-Old-style virtuals were supported by EAPIs \t{0}, \t{1}, \t{2}, \t{3} and
\t{4}, and were phased out
-via GLEP 37~\cite{Glep37}.
+Old-style virtuals were supported by EAPIs \t{0}, \t{1}, \t{2}, \t{3} and
\t{4}. They were phased
+out via GLEP 37~\cite{Glep37} and finally removed in 2011.
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
