From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1SUzQH-0007AU-Mh for garchives@archives.gentoo.org; Thu, 17 May 2012 12:03:14 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7CDCDE092F; Thu, 17 May 2012 12:02:26 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 2964BE0913 for ; Thu, 17 May 2012 12:02:26 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 64DAF1B406F for ; Thu, 17 May 2012 12:02:25 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 25C0EE542F for ; Thu, 17 May 2012 12:02:24 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1337250689.86b4734587d2cdc8b5b0357555a7e8cc05418f54.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-5 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: dependencies.tex eapi-differences.tex eapis.tex ebuild-env-vars.tex ebuild-functions.tex ebuild-vars.tex merge.tex pkg-mgr-commands.tex pms.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: 86b4734587d2cdc8b5b0357555a7e8cc05418f54 X-VCS-Branch: eapi-5 Date: Thu, 17 May 2012 12:02:24 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: e07c0824-870a-43ef-8782-7bb778513dcd X-Archives-Hash: 082cc12ccf500a04279888994db65d17 commit: 86b4734587d2cdc8b5b0357555a7e8cc05418f54 Author: Ciaran McCreesh googlemail com> AuthorDate: Sun May 6 16:12:14 2012 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Thu May 17 10:31:29 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/pms.git;a=3Dc= ommit;h=3D86b47345 Add an EAPI 5 identical to EAPI 4 --- dependencies.tex | 12 ++++-- eapi-differences.tex | 98 ++++++++++++++++++++++++++++----------------= ------ eapis.tex | 4 ++- ebuild-env-vars.tex | 9 +++-- ebuild-functions.tex | 25 +++++++++---- ebuild-vars.tex | 12 ++++-- merge.tex | 3 +- pkg-mgr-commands.tex | 33 +++++++++++------ pms.tex | 4 +- 9 files changed, 123 insertions(+), 77 deletions(-) diff --git a/dependencies.tex b/dependencies.tex index 54305c5..4b4300c 100644 --- a/dependencies.tex +++ b/dependencies.tex @@ -76,7 +76,7 @@ be surrounded on both sides by whitespace, except at th= e start and end of the st =20 In particular, note that whitespace is not optional. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{SRC\_URI} arrows} \label{tab:uri= -arrows-table} \begin{tabular}{ l l } \toprule @@ -88,6 +88,7 @@ In particular, note that whitespace is not optional. \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -148,7 +149,7 @@ manager must warn or error if this feature is used wi= th an EAPI not supporting u =20 \note Order is important. The slot restriction must come before use depe= ndencies. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{SLOT} dependencies} \label{tab:s= lot-deps-table} \begin{tabular}{ l l } \toprule @@ -160,11 +161,12 @@ manager must warn or error if this feature is used = with an EAPI not supporting u \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{USE} dependencies} \label{tab:us= e-deps-table} \begin{tabular}{ l l } \toprule @@ -176,6 +178,7 @@ manager must warn or error if this feature is used wi= th an EAPI not supporting u \t{2} & 2-style \\ \t{3} & 2-style \\ \t{4} & 4-style \\ + \t{5} & 4-style \\ \bottomrule \end{tabular} \end{centertable} @@ -215,7 +218,7 @@ ignored by the package manager, so long as any blocke= d package will be uninstall strong block must not be ignored. The mapping from one or two exclamatio= n marks to strength is described in table~\ref{tab:bang-strength-table}. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{Exclamation mark strengths for EAPIs} \label{tab:ban= g-strength-table} \begin{tabular}{ l l l } \toprule @@ -228,6 +231,7 @@ described in table~\ref{tab:bang-strength-table}. \t{2} & Weak & Strong \\ \t{3} & Weak & Strong \\ \t{4} & Weak & Strong \\ + \t{5} & Weak & Strong \\ \bottomrule \end{tabular} \end{centertable} diff --git a/eapi-differences.tex b/eapi-differences.tex index 33381e7..92d369e 100644 --- a/eapi-differences.tex +++ b/eapi-differences.tex @@ -2,10 +2,10 @@ =20 \note This chapter is informative and for convenience only. Refer to the= main text for specifics. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{landscape} \newcolumntype{P}[1]{>{\setlength{\rightskip}{0pt plus 1fil}}p{#1}} -\begin{longtable}{llP{5em}P{5em}P{8em}P{8em}P{8em}} +\begin{longtable}{llP{5em}P{5em}P{6em}P{6em}P{6em}P{6em}} \caption{Features in EAPIs}\\ \toprule \multicolumn{1}{c}{\b{Feature}} & @@ -17,7 +17,8 @@ \multicolumn{1}{c}{1} & \multicolumn{1}{c}{2} & \multicolumn{1}{c}{3} & -\multicolumn{1}{c}{4} \\ +\multicolumn{1}{c}{4} & +\multicolumn{1}{c}{5} \\ \midrule \endfirsthead \midrule @@ -30,7 +31,8 @@ \multicolumn{1}{c}{1} & \multicolumn{1}{c}{2} & \multicolumn{1}{c}{3} & -\multicolumn{1}{c}{4} \\ +\multicolumn{1}{c}{4} & +\multicolumn{1}{c}{5} \\ \midrule \endhead \midrule @@ -39,125 +41,127 @@ \endlastfoot =20 \t{IUSE} defaults & \compactfeatureref{iuse-defaults} & - No & Yes & Yes & Yes & Yes \\ + No & Yes & Yes & Yes & Yes & Yes \\ =20 \t{REQUIRED\_USE} & \compactfeatureref{required-use} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{PROPERTIES} & \compactfeatureref{properties} & - Optionally & Optionally & Optionally & Optionally & Yes \\ + Optionally & Optionally & Optionally & Optionally & Yes & Yes \\ =20 \t{RDEPEND=3DDEPEND} & \compactfeatureref{rdepend-depend} & - Yes & Yes & Yes & Yes & No \\ + Yes & Yes & Yes & Yes & No & No \\ =20 \t{DEFINED\_PHASES} & \compactfeatureref{defined-phases} & - Optionally & Optionally & Optionally & Optionally & Yes \\ + Optionally & Optionally & Optionally & Optionally & Yes & Yes \\ =20 \t{SRC\_URI} arrows & \compactfeatureref{src-uri-arrows} & - No & No & Yes & Yes & Yes \\ + No & No & Yes & Yes & Yes & Yes \\ =20 Slot dependencies & \compactfeatureref{slot-deps} & - No & Yes & Yes & Yes & Yes \\ + No & Yes & Yes & Yes & Yes & Yes \\ =20 Use dependencies & \compactfeatureref{use-deps} & - No & No & 2-style & 2-style & 4-style \\ + No & No & 2-style & 2-style & 4-style & 4-style \\ =20 \t{!} blockers & \compactfeatureref{bang-strength} & - Unspecified & Unspecified & Weak & Weak & Weak \\ + Unspecified & Unspecified & Weak & Weak & Weak & Weak \\ =20 \t{!!} blockers & \compactfeatureref{bang-strength} & - Forbidden & Forbidden & Strong & Strong & Strong \\ + Forbidden & Forbidden & Strong & Strong & Strong & Strong \\ =20 \t{S} to \t{WORKDIR} fallback & \compactfeatureref{s-workdir-fallback} & - Always & Always & Always & Always & Conditional \\ + Always & Always & Always & Always & Conditional & Conditional \\ =20 \t{pkg\_pretend} & \compactfeatureref{pkg-pretend} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{src\_prepare} & \compactfeatureref{src-prepare} & - No & No & Yes & Yes & Yes \\ + No & No & Yes & Yes & Yes & Yes \\ =20 \t{src\_configure} & \compactfeatureref{src-configure} & - No & No & Yes & Yes & Yes \\ + No & No & Yes & Yes & Yes & Yes \\ =20 \t{src\_compile} style & \compactfeatureref{src-compile} & - 0 & 1 & 2 & 2 & 2 \\ + 0 & 1 & 2 & 2 & 2 & 2 \\ =20 \t{src\_install} style & \compactfeatureref{src-install} & - no-op & no-op & no-op & no-op & 4 \\ + no-op & no-op & no-op & no-op & 4 & 4 \\ =20 \t{pkg\_info} & \compactfeatureref{pkg-info} & - Installed & Installed & Installed & Installed & Both \\ + Installed & Installed & Installed & Installed & Both & Both \\ =20 \t{default\_} phase functions & \compactfeatureref{default-phase-funcs} = & None & None & \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configu= re}, \t{src\_compile}, \t{src\_test} & \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configu= re}, \t{src\_compile}, \t{src\_test} & \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configu= re}, + \t{src\_compile}, \t{src\_install}, \t{src\_test} & + \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configu= re}, \t{src\_compile}, \t{src\_install}, \t{src\_test} \\ =20 \t{AA} & \compactfeatureref{aa} & - Yes & Yes & Yes & Yes & No \\ + Yes & Yes & Yes & Yes & No & No \\ =20 \t{KV} & \compactfeatureref{kv} & - Yes & Yes & Yes & Yes & No \\ + Yes & Yes & Yes & Yes & No & No \\ =20 \t{MERGE\_TYPE} & \compactfeatureref{merge-type} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{REPLACING\_VERSIONS} & \compactfeatureref{replace-version-vars} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{REPLACED\_BY\_VERSION} & \compactfeatureref{replace-version-vars} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{EPREFIX}, \t{ED}, \t{EROOT} & \compactfeatureref{offset-prefix-vars} = & - No & No & No & Yes & Yes \\ + No & No & No & Yes & Yes & Yes \\ =20 Most utilities die & \compactfeatureref{die-on-failure} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{nonfatal} & \compactfeatureref{nonfatal} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{dohard} & \compactfeatureref{banned-commands} & - Yes & Yes & Yes & Yes & Banned \\ + Yes & Yes & Yes & Yes & Banned & Banned \\ =20 \t{dosed} & \compactfeatureref{banned-commands} & - Yes & Yes & Yes & Yes & Banned \\ + Yes & Yes & Yes & Yes & Banned & Banned \\ =20 \t{econf} arguments & \compactfeatureref{econf-options} & - & & & & disable dependency tracking \\ + & & & & disable dependency tracking & disable dependency tracking= \\ =20 \t{dodoc -r} & \compactfeatureref{dodoc} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{doins} handles symlinks & \compactfeatureref{doins} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{doman} languages & \compactfeatureref{doman-langs} & - No & No & Yes & Yes & Yes \\ + No & No & Yes & Yes & Yes & Yes \\ =20 \t{doman -i18n} precedence & \compactfeatureref{doman-langs} & - N/A & N/A & No & No & Yes \\ + N/A & N/A & No & No & Yes & Yes \\ =20 Controllable compression & \compactfeatureref{controllable-compress} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{docompress} & \compactfeatureref{controllable-compress} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{use\_with} empty third arg & \compactfeatureref{use-with} & - No & No & No & No & Yes \\ + No & No & No & No & Yes & Yes \\ =20 \t{unpack} support for \t{xz}? & \compactfeatureref{unpack-extensions} & - No & No & No & Yes & Yes \\ + No & No & No & Yes & Yes & Yes \\ =20 \t{default} function & \compactfeatureref{default-func} & - No & No & Yes & Yes & Yes \\ + No & No & Yes & Yes & Yes & Yes \\ =20 File mtimes preserved & \compactfeatureref{mtime-preserve} & - Undefined & Undefined & Undefined & Yes & Yes \\ + Undefined & Undefined & Undefined & Yes & Yes & Yes \\ =20 \end{longtable} \end{landscape} @@ -236,7 +240,15 @@ EAPI 4 is EAPI 3 with the following changes: \item \t{use\_with} and \t{use\_enable} support empty third argument, \f= eatureref{use-with}. \end{compactitem} =20 -\ChangeWhenAddingAnEAPI{4} +\section*{EAPI 5} + +EAPI 5 is EAPI 4 with the following changes: + +\begin{compactitem} +\item None +\end{compactitem} + +\ChangeWhenAddingAnEAPI{5} =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllan= g=3Den : =20 diff --git a/eapis.tex b/eapis.tex index 5543988..48d28fd 100644 --- a/eapis.tex +++ b/eapis.tex @@ -19,7 +19,7 @@ EAPIs are also used for profile directories, as describ= ed in section~\ref{sec:pr =20 The following EAPIs are defined by this specification: =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{description} \item[0] The `original' base EAPI. \item[1] EAPI `1' contains a number of extensions to EAPI `0'. Except wh= ere explicitly noted, it is @@ -30,6 +30,8 @@ The following EAPIs are defined by this specification: in all other ways identical to EAPI `2'. \item[4] EAPI `4' contains a number of extensions to EAPI `3'. Except wh= ere explicitly noted, it is in all other ways identical to EAPI `3'. +\item[5] EAPI `5' contains a number of extensions to EAPI `4'. Except wh= ere explicitly noted, it is + in all other ways identical to EAPI `4'. \end{description} =20 Except where explicitly noted, everything in this specification diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex index dc4e648..0d382d0 100644 --- a/ebuild-env-vars.tex +++ b/ebuild-env-vars.tex @@ -214,7 +214,7 @@ variable. \end{longtable} \end{landscape} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting various env variables} \label{tab:e= nv-vars-table} \begin{tabular}{ l l l l l l } \toprule @@ -230,11 +230,12 @@ variable. \t{2} & Yes & Yes & No & No & No \\ \t{3} & Yes & Yes & No & No & No \\ \t{4} & No & No & Yes & Yes & Yes \\ + \t{5} & No & No & Yes & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting offset-prefix env variables} \label{tab:offset-env-vars-table} \begin{tabular}{ l l l l } @@ -249,6 +250,7 @@ variable. \t{2} & No & No & No \\ \t{3} & Yes & Yes & Yes \\ \t{4} & Yes & Yes & Yes \\ + \t{5} & Yes & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -319,7 +321,7 @@ variable shall be defined in \t{pkg\_prerm} and \t{pk= g\_postrm}. It shall contai \subsection{Offset-prefix variables \t{EPREFIX}, \t{EROOT} and \t{ED}} \label{sec:offset-vars} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting offset-prefix} \label{tab:offset-support-table} \begin{tabular}{ l l } @@ -332,6 +334,7 @@ variable shall be defined in \t{pkg\_prerm} and \t{pk= g\_postrm}. It shall contai \t{2} & No \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} diff --git a/ebuild-functions.tex b/ebuild-functions.tex index 24f7d69..cd4075c 100644 --- a/ebuild-functions.tex +++ b/ebuild-functions.tex @@ -44,7 +44,7 @@ fallback to \t{WORKDIR} is used: in \t{DEFINED\_PHASES}. \end{compactitem} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs with \t{S} to \t{WORKDIR} fallbacks} \label{ta= b:s-fallback-table} \begin{tabular}{ l l } \toprule @@ -56,6 +56,7 @@ fallback to \t{WORKDIR} is used: \t{2} & Always \\ \t{3} & Always \\ \t{4} & Conditional error \\ + \t{5} & Conditional error \\ \bottomrule \end{tabular} \end{centertable} @@ -78,7 +79,7 @@ before the next phase is executed. =20 \t{pkg\_pretend} must not write to the filesystem. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{pkg\_pretend}} \label{tab:pkg-pr= etend-table} \begin{tabular}{ l l } \toprule @@ -90,6 +91,7 @@ before the next phase is executed. \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -133,7 +135,7 @@ implementation does nothing. The initial working directory is \t{S}, with an error or fallback to \t{= WORKDIR} as discussed in section~\ref{sec:s-to-workdir-fallback}. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{src\_prepare}} \label{tab:src-pr= epare-table} \begin{tabular}{ l l } \toprule @@ -145,6 +147,7 @@ section~\ref{sec:s-to-workdir-fallback}. \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -169,7 +172,7 @@ src_configure() { } \end{verbatim} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{src\_configure}} \label{tab:src-= configure-table} \begin{tabular}{ l l } \toprule @@ -181,6 +184,7 @@ src_configure() { \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -236,7 +240,7 @@ src_compile() { } \end{verbatim} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{\t{src\_compile} behaviour for EAPIs} \label{tab:src= -compile-table} \begin{tabular}{ l l } \toprule @@ -248,6 +252,7 @@ src_compile() { \t{2} & 2 \\ \t{3} & 2 \\ \t{4} & 2 \\ + \t{5} & 2 \\ \bottomrule \end{tabular} \end{centertable} @@ -303,7 +308,7 @@ src_install() { For other EAPIs, the default implementation used when the ebuild lacks t= he \t{src\_install} function is a no-op. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{\t{src\_install} behaviour for EAPIs} \label{tab:src= -install-table} \begin{tabular}{ l l } \toprule @@ -315,6 +320,7 @@ is a no-op. \t{2} & no-op \\ \t{3} & no-op \\ \t{4} & 4 \\ + \t{5} & 4 \\ \bottomrule \end{tabular} \end{centertable} @@ -378,7 +384,7 @@ that dependencies may not be installed. =20 \t{pkg\_info} must not write to the filesystem. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{pkg\_info} on non-installed pack= ages} \label{tab:pkg-info-table} \begin{tabular}{ l l } \toprule @@ -390,6 +396,7 @@ that dependencies may not be installed. \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -412,7 +419,7 @@ named \t{default\_}(phase) that behaves as the defaul= t implementation for that E when executing any ebuild phase listed in the table. Ebuilds must not ca= ll these functions except when in the phase in question. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{default\_} phase functions} \lab= el{tab:default-phase-function-table} \begin{tabular}{ l >{\setlength{\rightskip}{0pt plus 1fil}}p{30em} } \toprule @@ -427,6 +434,8 @@ when in the phase in question. \t{src\_compile}, \t{src\_test} \\ \t{4} & \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\= _configure}, \t{src\_compile}, \t{src\_install}, \t{src\_test} \\ + \t{5} & \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\= _configure}, + \t{src\_compile}, \t{src\_install}, \t{src\_test} \\ \bottomrule \end{tabular} \end{centertable} diff --git a/ebuild-vars.tex b/ebuild-vars.tex index 0204c3a..f397f0e 100644 --- a/ebuild-vars.tex +++ b/ebuild-vars.tex @@ -54,7 +54,7 @@ If any of these variables are undefined, or if any of t= hese variables are set to the package manager's behaviour is undefined; ideally, an error in one e= build should not prevent operations upon other ebuilds or packages. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{IUSE} defaults} \label{tab:iuse-= defaults-table} \begin{tabular}{ l l } \toprule @@ -66,6 +66,7 @@ operations upon other ebuilds or packages. \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -94,7 +95,7 @@ Ebuilds may define any of the following variables: table~\ref{tab:optional-vars-table} as supporting \t{REQUIRED\_USE}. \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting various ebuild-defined variables} \label{tab:optional-vars-table} \begin{tabular}{ l l l } @@ -108,6 +109,7 @@ Ebuilds may define any of the following variables: \t{2} & Optionally & No \\ \t{3} & Optionally & No \\ \t{4} & Yes & Yes \\ + \t{5} & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -154,7 +156,7 @@ any \t{DEPEND} or \t{RDEPEND} set in an eclass does n= ot change the implicit \t{R the ebuild portion, and any \t{DEPEND} value set in an eclass does not g= et treated as being part of \t{RDEPEND}. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs with \t{RDEPEND=3DDEPEND} Default} \label{tab:= rdepend-depend-table} \begin{tabular}{ l l } \toprule @@ -166,6 +168,7 @@ the ebuild portion, and any \t{DEPEND} value set in a= n eclass does not get treat \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & No \\ + \t{5} & No \\ \bottomrule \end{tabular} \end{centertable} @@ -199,7 +202,7 @@ this variable defined, and must treat an empty string= as ``this information is n \note Thus, by extension of section~\ref{sec:metadata-invariance}, phase= functions must not be defined based upon any variant condition. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{DEFINED\_PHASES}} \label{tab:def= ined-phases-table} \begin{tabular}{ l l } \toprule @@ -211,6 +214,7 @@ based upon any variant condition. \t{2} & Optionally \\ \t{3} & Optionally \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} diff --git a/merge.tex b/merge.tex index 846e876..bc74193 100644 --- a/merge.tex +++ b/merge.tex @@ -86,7 +86,7 @@ held under the original image directory. In other EAPIs, the behaviour with respect to file modification times is undefined. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{Preservation of file modification times (mtimes)} \label{tab:mtime-preserve} \begin{tabular}{ l l } @@ -99,6 +99,7 @@ is undefined. \t{2} & Undefined \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index c2d8a9e..0a56b99 100644 --- a/pkg-mgr-commands.tex +++ b/pkg-mgr-commands.tex @@ -21,7 +21,7 @@ The following commands affect this behaviour: table~\ref{tab:commands-die-table} as supporting \t{nonfatal}. \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPI Command Failure Behaviour} \label{tab:commands-= die-table} \begin{tabular}{ l l l } \toprule @@ -34,6 +34,7 @@ The following commands affect this behaviour: \t{2} & Non-zero exit & No \\ \t{3} & Non-zero exit & No \\ \t{4} & Aborts & Yes \\ + \t{5} & Aborts & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -44,7 +45,7 @@ The following commands affect this behaviour: \featurelabel{banned-commands} Some commands are banned in some EAPIs. I= f a banned command is called, the package manager must abort the build process indicating an e= rror. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{Banned commands} \label{tab:banned-commands-table} \begin{tabular}{ l l l l } \toprule @@ -59,6 +60,7 @@ called, the package manager must abort the build proces= s indicating an error. \t{2} & No & No \\ \t{3} & No & No \\ \t{4} & Yes & Yes \\ + \t{5} & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -147,7 +149,7 @@ has returned. string \t{disable-dependency-tracking} occurs in the output of \= t{configure -{}-help}. \end{itemize} =20 - \ChangeWhenAddingAnEAPI{4} + \ChangeWhenAddingAnEAPI{5} \begin{centertable}{Extra \t{econf} arguments for EAPIs} \label{tab:= econf-options-table} \begin{tabular}{ l l l } \toprule @@ -159,6 +161,7 @@ has returned. \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -410,7 +413,7 @@ that can be passed to \t{dohtml} are as follows: =20 \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{dodoc -r}} \label{tab:dodoc-tabl= e} \begin{tabular}{ l l } \toprule @@ -422,11 +425,12 @@ that can be passed to \t{dohtml} are as follows: \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting symlinks for \t{doins}} \label{tab:= doins-table} \begin{tabular}{ l l } \toprule @@ -438,11 +442,12 @@ that can be passed to \t{dohtml} are as follows: \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{\t{doman} language support options for EAPIs} \label{tab:doman-table} \begin{tabular}{ l l l } @@ -456,6 +461,7 @@ that can be passed to \t{dohtml} are as follows: \t{2} & Yes & No \\ \t{3} & Yes & No \\ \t{4} & Yes & Yes \\ + \t{5} & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -545,7 +551,7 @@ exclusion list. Otherwise, add each argument to the i= nclusion list. Only availab in table~\ref{tab:compression-table} as supporting \t{docompress}. \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting controllable compression} \label{ta= b:compression-table} \begin{tabular}{ l l l } \toprule @@ -558,6 +564,7 @@ in table~\ref{tab:compression-table} as supporting \t= {docompress}. \t{2} & No & No \\ \t{3} & No & No \\ \t{4} & Yes & Yes \\ + \t{5} & Yes & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -589,7 +596,7 @@ either behaviour is undefined or it is an error as de= cided by table~\ref{tab:use instead of \t{-{}-with-} or \t{-{}-without-}. \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPI Behaviour for Use Queries not in IUSE\_EFFECTIV= E} \label{tab:use-list-strictness} \begin{tabular}{ l l } \toprule @@ -601,11 +608,12 @@ instead of \t{-{}-with-} or \t{-{}-without-}. \t{2} & Undefined \\ \t{3} & Undefined \\ \t{4} & Error \\ + \t{5} & Error \\ \bottomrule \end{tabular} \end{centertable} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting empty third argument in \t{use\_wit= h} and \t{use\_enable}} \label{tab:use-with-third-arg} \begin{tabular}{ l l } @@ -618,6 +626,7 @@ instead of \t{-{}-with-} or \t{-{}-without-}. \t{2} & No \\ \t{3} & No \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -688,7 +697,7 @@ has returned. It is up to the ebuild to ensure that the relevant external utilitie= s are available, whether by being in the system set or via dependencies. =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{\t{unpack} extensions for EAPIs} \label{tab:unpack-e= xtensions-table} \begin{tabular}{ l l } \toprule @@ -700,6 +709,7 @@ has returned. \t{2} & No \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} @@ -713,7 +723,7 @@ has returned. table~\ref{tab:default-function-table}. \end{description} =20 -\ChangeWhenAddingAnEAPI{4} +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting the \t{default} function} \label{ta= b:default-function-table} \begin{tabular}{ l l } \toprule @@ -725,6 +735,7 @@ has returned. \t{2} & Yes \\ \t{3} & Yes \\ \t{4} & Yes \\ + \t{5} & Yes \\ \bottomrule \end{tabular} \end{centertable} diff --git a/pms.tex b/pms.tex index 1c9ed30..d0ceda2 100644 --- a/pms.tex +++ b/pms.tex @@ -1,7 +1,7 @@ \documentclass{pms} =20 -\CurrentEAPIIs{4} -\ChangeWhenAddingAnEAPI{4} +\CurrentEAPIIs{5} +\ChangeWhenAddingAnEAPI{5} =20 \begin{document} \maketitle