From 8957745aae9a629e0d91793573b9b6f8b145880c Mon Sep 17 00:00:00 2001 From: Ciaran McCreesh Date: Thu, 18 Oct 2007 14:08:34 +0000 Subject: Add EAPI 1 git-svn-id: http://svn.repogirl.net/pms/trunk@169 a05a4626-2124-0410-b604-e6c5abf33261 --- introduction.tex | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) (limited to 'introduction.tex') 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 : -- cgit v1.2.3-65-gdbad