summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCiaran McCreesh <ciaranm@ciaranm.org>2007-03-24 18:00:02 +0000
committerCiaran McCreesh <ciaranm@ciaranm.org>2007-03-24 18:00:02 +0000
commiteb41091bc044b4fa97432b2ebff929ec36fd970f (patch)
tree1bffa74d20ded57483c1f144a4b5a199336dc5af /appendices.tex
parentAdd Reporting Issues section (diff)
downloadpms-eb41091bc044b4fa97432b2ebff929ec36fd970f.tar.gz
pms-eb41091bc044b4fa97432b2ebff929ec36fd970f.tar.bz2
pms-eb41091bc044b4fa97432b2ebff929ec36fd970f.zip
Add appendix on things ebuilds can't do
git-svn-id: http://svn.repogirl.net/pms/trunk@113 a05a4626-2124-0410-b604-e6c5abf33261
Diffstat (limited to 'appendices.tex')
-rw-r--r--appendices.tex18
1 files changed, 18 insertions, 0 deletions
diff --git a/appendices.tex b/appendices.tex
index 5b21a02..188d98f 100644
--- a/appendices.tex
+++ b/appendices.tex
@@ -7,5 +7,23 @@ The \t{metadata.xml} file is used to contain extra package- or category-level in
what is stored in ebuild metadata. Its exact format is strictly beyond the scope of this document,
and is described in the DTD file located at \url{http://www.gentoo.org/dtd/metadata.dtd}.
+\chapter{Unspecified Items}
+
+The following items are not specified by this document, and may not be relied upon by ebuilds.
+This is, of course, an incomplete list---it covers only the things that the authors know have
+been abused in the past.
+
+\begin{bulletlist}
+\item The \t{FEATURES} variable. This is Portage specific.
+\item Similarly, any \t{PORTAGE\_} variable not explicitly listed.
+\item Any Portage configuration file.
+\item The VDB (\t{/var/db/pkg}). Ebuilds may not access this or rely upon it existing or being
+ in any particular format.
+\item The \t{portageq} command. The \t{has\_version} and \t{best\_version} commands are
+ available as functions.
+\item The \t{emerge} command.
+\item Binary packages.
+\item The \t{PORTDIR\_OVERLAY} variable, and overlay behaviour in general.
+\end{bulletlist}
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :