diff options
author | Ciaran McCreesh <ciaranm@ciaranm.org> | 2007-10-18 14:08:34 +0000 |
---|---|---|
committer | Ciaran McCreesh <ciaranm@ciaranm.org> | 2007-10-18 14:08:34 +0000 |
commit | 8957745aae9a629e0d91793573b9b6f8b145880c (patch) | |
tree | f3ed619d1e48f795c82d73172c75c1228f3565f5 /introduction.tex | |
parent | Formatting (diff) | |
download | pms-8957745aae9a629e0d91793573b9b6f8b145880c.tar.gz pms-8957745aae9a629e0d91793573b9b6f8b145880c.tar.bz2 pms-8957745aae9a629e0d91793573b9b6f8b145880c.zip |
Add EAPI 1
git-svn-id: http://svn.repogirl.net/pms/trunk@169 a05a4626-2124-0410-b604-e6c5abf33261
Diffstat (limited to 'introduction.tex')
-rw-r--r-- | introduction.tex | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/introduction.tex b/introduction.tex index 80c94b7..e54e67a 100644 --- a/introduction.tex +++ b/introduction.tex @@ -30,4 +30,29 @@ incompatibilities with any particular repository. Text in \t{teletype} is used for filenames or variable names. \i{Italic} text is used for terms with a particular technical meaning in places where there may otherwise be ambiguity. +\section{EAPIs} + +An EAPI can be thought of as a 'version' of this specification to which a package conforms. An EAPI +value is a string (all EAPIs defined by this specification currently use an integer, but package +managers must not assume that this will hold in the future, and package managers must not assume +that any kind of comparison other than equality between EAPI values makes sense). There are two +EAPIs defined by this specification: + +\begin{description} +\item[0] The 'original' base EAPI. +\item[1] EAPI '1' contains a number of extensions to EAPI '0'. Except where explicitly noted, it is + in all other ways identical to EAPI '0'. +\end{description} + +Except where explicitly noted, everything in this specification applies to both EAPIs. + +If a package manager encounters a package version with an unrecognised EAPI, it must not attempt to +perform any operations upon it. It could, for example, ignore the package version entirely (although +this can lead to user confusion), or it could mark the package version as masked. A package manager +must not use any metadata generated from a package with an unrecognised EAPI. + +EAPIs whose value consists purely of an integer are reserved for future versions of this +specification. EAPIs whose value starts with the string \t{paludis-} are reserved for experimental +use by the Paludis package manager. + % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : |