summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCiaran McCreesh <ciaran.mccreesh@googlemail.com>2009-01-14 15:39:12 +0000
committerCiaran McCreesh <ciaran.mccreesh@googlemail.com>2009-01-14 15:37:03 +0000
commit01c5cc7cb2a6e797687844b854ec3c83818e73e6 (patch)
tree34e2235547a08606bb302cbb7434147bb8e60ffd /ebuild-vars.tex
parentEbuilds may trust the initial working directory. (diff)
downloadpms-01c5cc7cb2a6e797687844b854ec3c83818e73e6.tar.gz
pms-01c5cc7cb2a6e797687844b854ec3c83818e73e6.tar.bz2
pms-01c5cc7cb2a6e797687844b854ec3c83818e73e6.zip
Add DEFINED_PHASES.
See Council meeting on 20081211.
Diffstat (limited to 'ebuild-vars.tex')
-rw-r--r--ebuild-vars.tex14
1 files changed, 14 insertions, 0 deletions
diff --git a/ebuild-vars.tex b/ebuild-vars.tex
index e4fd6d1..a79217e 100644
--- a/ebuild-vars.tex
+++ b/ebuild-vars.tex
@@ -209,6 +209,20 @@ of the ebuild's metadata:
\note Thus, by extension of section~\ref{metadata-invariance}, \t{inherit} may not be used
conditionally, except upon constant conditions.
+The following are special variables defined by the package manager for internal use and may or may
+not be exported to the ebuild environment:
+
+\begin{description}
+\item[DEFINED\_PHASES] A space separated arbitrarily ordered list of phase names (e.g. \t{configure
+setup unpack}) whose phase functions are defined by the ebuild or an eclass inherited by the ebuild.
+If no phase functions are defined, a single hyphen is used instead of an empty string. Package
+managers may not rely upon the metadata cache having this variable defined, and must treat an empty
+string as ``this information is not available''.
+\end{description}
+
+\note Thus, by extension of section~\ref{metadata-invariance}, phase functions must not be defined
+based upon any variant condition.
+
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
%%% Local Variables: