\t{REPLACED\_BY\_VERSION} & \compactfeatureref{replace-version-vars} &

\t{REPLACED\_BY\_VERSION} & \compactfeatureref{replace-version-vars} &

    No & No & No & No & Yes \\

    No & No & No & No & Yes \\

Most utilities die & \compactfeatureref{die-on-failure} &

Most utilities die & \compactfeatureref{die-on-failure} &

    No & No & No & No & Yes \\

    No & No & No & No & Yes \\

EAPI 3 is EAPI 2 with the following changes:

EAPI 3 is EAPI 2 with the following changes:

\begin{compactitem}

\begin{compactitem}

\item File modification times are preserved, \featureref{mtime-preserve}.

\item File modification times are preserved, \featureref{mtime-preserve}.

\end{compactitem}

\end{compactitem}

\section*{EAPI 4}

\section*{EAPI 4}

\begin{landscape}

\begin{landscape}

\begin{longtable}{l p{0.15\textwidth} l p{0.5\textwidth}}

\begin{longtable}{l p{0.15\textwidth} l p{0.5\textwidth}}

\toprule

\toprule

\multicolumn{1}{c}{\b{Variable}} &

\multicolumn{1}{c}{\b{Variable}} &

\multicolumn{1}{c}{\b{Legal in}} &

\multicolumn{1}{c}{\b{Legal in}} &

   \t{ROOT}\@. Also of note is that in a cross-compiling environment, binaries inside of \t{ROOT}

   \t{ROOT}\@. Also of note is that in a cross-compiling environment, binaries inside of \t{ROOT}

   will not be executable on the build machine, so ebuilds must not call them. \t{ROOT} must be

   will not be executable on the build machine, so ebuilds must not call them. \t{ROOT} must be

   non-empty and end in a trailing slash. \\

   non-empty and end in a trailing slash. \\

\t{T} &

\t{T} &

    All &

    All &

    Partially\footnote{Consistent and preserved across a single connected sequence of install or

    Partially\footnote{Consistent and preserved across a single connected sequence of install or

    Ditto &

    Ditto &

    The full path to an appropriate temporary directory for use by any programs invoked by the

    The full path to an appropriate temporary directory for use by any programs invoked by the

    ebuild that may read or modify the home directory. \\

    ebuild that may read or modify the home directory. \\

\t{D} &

\t{D} &

    \t{src\_install} &

    \t{src\_install} &

    No &

    No &

    Yes &

    Yes &

    Contains the full path to the image that is about to be or has just been merged. Must be

    Contains the full path to the image that is about to be or has just been merged. Must be

    non-empty and end in a trailing slash. \\

    non-empty and end in a trailing slash. \\

\t{IMAGE}\footnote{Deprecated in favour of \t{D}.} &

\t{IMAGE}\footnote{Deprecated in favour of \t{D}.} &

    \t{pkg\_preinst}, \t{pkg\_postinst} &

    \t{pkg\_preinst}, \t{pkg\_postinst} &

    Yes &

    Yes &

    \end{tabular}

    \end{tabular}

\end{centertable}

\end{centertable}

Except where otherwise noted, all variables set in the active profiles' \t{make.defaults} files must

Except where otherwise noted, all variables set in the active profiles' \t{make.defaults} files must

be exported to the ebuild environment. \t{CHOST}, \t{CBUILD} and \t{CTARGET}, if not set by

be exported to the ebuild environment. \t{CHOST}, \t{CBUILD} and \t{CTARGET}, if not set by

profiles, must contain either an appropriate machine tuple (the definition of appropriate is beyond

profiles, must contain either an appropriate machine tuple (the definition of appropriate is beyond

In EAPIs listed in table~\ref{tab:env-vars-table} as supporting it, the \t{REPLACED\_BY} variable

In EAPIs listed in table~\ref{tab:env-vars-table} as supporting it, the \t{REPLACED\_BY} variable

shall be defined in \t{pkg\_prerm} and \t{pkg\_postrm}. It shall contain at most one value.

shall be defined in \t{pkg\_prerm} and \t{pkg\_postrm}. It shall contain at most one value.

% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :

% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :

%%% Local Variables:

%%% Local Variables:

    \featurelabel{econf-options}

    \featurelabel{econf-options}

    \begin{itemize}

    \begin{itemize}

    \item -{}-host must be the value of the \t{CHOST} environment variable.

    \item -{}-host must be the value of the \t{CHOST} environment variable.

    \item -{}-libdir must be set according to Algorithm~\ref{alg:econf-libdir}.

    \item -{}-libdir must be set according to Algorithm~\ref{alg:econf-libdir}.

    \item -{}-disable-dependency-tracking, if the EAPI is listed in

    \item -{}-disable-dependency-tracking, if the EAPI is listed in

        \end{tabular}

        \end{tabular}

    \end{centertable}

    \end{centertable}

    \t{econf} must be implemented internally---that is, as a bash function and not an external

    \t{econf} must be implemented internally---that is, as a bash function and not an external

    script. Should any portion of it fail, it must abort the build using \t{die}, unless run using

    script. Should any portion of it fail, it must abort the build using \t{die}, unless run using

    \t{nonfatal}, in which case it must return non-zero exit status.

    \t{nonfatal}, in which case it must return non-zero exit status.

\begin{algorithm}

\begin{algorithm}

\caption{econf -{}-libdir logic} \label{alg:econf-libdir}

\caption{econf -{}-libdir logic} \label{alg:econf-libdir}

\begin{algorithmic}[1]

\begin{algorithmic}[1]

\IF{the caller specified -{}-prefix=\$p}

\IF{the caller specified -{}-prefix=\$p}

    \STATE let prefix=\$p

    \STATE let prefix=\$p

\ENDIF

\ENDIF

    to \t{einstall} are passed verbatim to \t{emake}, as shown. Failure behaviour is EAPI dependent

    to \t{einstall} are passed verbatim to \t{emake}, as shown. Failure behaviour is EAPI dependent

    as per section~\ref{sec:failure-behaviour}.

    as per section~\ref{sec:failure-behaviour}.

\begin{listing}[H]

\begin{listing}[H]

  \caption{einstall command}\label{lst:einstall}

  \caption{einstall command}\label{lst:einstall}

  \begin{verbatim}

  \begin{verbatim}

emake \

emake \

   "$@" \

   "$@" \

   install

   install

  \end{verbatim}

  \end{verbatim}

\subsubsection{Installation commands}

\subsubsection{Installation commands}

These commands are used to install files into the staging area, in cases where the package's \t{make

These commands are used to install files into the staging area, in cases where the package's \t{make

install} target cannot be used or does not install all needed files. Except where otherwise stated,

install} target cannot be used or does not install all needed files. Except where otherwise stated,

commands must all be external programs and not bash functions or aliases---that is, they must be

commands must all be external programs and not bash functions or aliases---that is, they must be

callable from \t{xargs}. Ebuilds must not run any of these commands once the current phase function

callable from \t{xargs}. Ebuilds must not run any of these commands once the current phase function

has returned.

has returned.

\begin{description}

\begin{description}

\item[dobin] Installs the given files into \t{DESTTREE/bin}, where \t{DESTTREE} defaults to

\item[dobin] Installs the given files into \t{DESTTREE/bin}, where \t{DESTTREE} defaults to

\item[doconfd] Installs the given config files into \t{/etc/conf.d/}, by default with file mode

\item[doconfd] Installs the given config files into \t{/etc/conf.d/}, by default with file mode

    \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the \t{insopts} function.

    \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the \t{insopts} function.

    \item{\t{-f}} --- list of files that are able to be installed.

    \item{\t{-f}} --- list of files that are able to be installed.

    \item{\t{-x}} --- list of directories that files will not be installed from (only used in

    \item{\t{-x}} --- list of directories that files will not be installed from (only used in

    conjunction with \t{-r}).

    conjunction with \t{-r}).

    \end{description}

    \end{description}

    Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.

    Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.

\end{centertable}

\end{centertable}

\subsubsection{Commands affecting install destinations}

\subsubsection{Commands affecting install destinations}

used by the above installation commands. They must be shell functions or aliases, due to the need to

used by the above installation commands. They must be shell functions or aliases, due to the need to

set variables read by the above commands. Ebuilds must not run any of these commands once the

set variables read by the above commands. Ebuilds must not run any of these commands once the

current phase function has returned.

current phase function has returned.

\begin{description}

\begin{description}

\item[into] Sets the value of \t{DESTTREE} for future invocations of the above utilities.  Creates

\item[into] Sets the value of \t{DESTTREE} for future invocations of the above utilities.  Creates

already exist. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.

already exist. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.

\item[insinto] Sets the value of \t{INSDESTTREE} for future invocations of the above utilities. May

\item[insinto] Sets the value of \t{INSDESTTREE} for future invocations of the above utilities. May

\subsubsection{Commands affecting install compression}

\subsubsection{Commands affecting install compression}

\begin{compactitem}

\begin{compactitem}

\item An inclusion list, which initially contains \t{/usr/share/doc}, \t{/usr/share/info} and

\item An inclusion list, which initially contains \t{/usr/share/doc}, \t{/usr/share/info} and

The optional compression shall be carried out after \t{src\_install} has completed, and before the

The optional compression shall be carried out after \t{src\_install} has completed, and before the

execution of any subsequent phase function. For each item in the inclusion list, pretend it has the

execution of any subsequent phase function. For each item in the inclusion list, pretend it has the

\begin{compactitem}

\begin{compactitem}

\item If it is a directory, act as if every file or directory immediately under this directory

\item If it is a directory, act as if every file or directory immediately under this directory

\end{compactitem}

\end{compactitem}

Whether an item is to be excluded is determined as follows: For each item in the exclusion list,

Whether an item is to be excluded is determined as follows: For each item in the exclusion list,

\begin{compactitem}

\begin{compactitem}

\item If it is a directory, act as if every file or directory immediately under this directory

\item If it is a directory, act as if every file or directory immediately under this directory

\begin{description}

\begin{description}

\item[dosed] Takes any number of arguments, which can be files or \t{sed} expressions. For each

\item[dosed] Takes any number of arguments, which can be files or \t{sed} expressions. For each

    current expression on that file. Otherwise, the current expression is set to the text of the

    current expression on that file. Otherwise, the current expression is set to the text of the

    table~\ref{tab:banned-commands-table}, this command is banned as per

    table~\ref{tab:banned-commands-table}, this command is banned as per

    section~\ref{sec:banned-commands}. Failure behaviour is EAPI dependent as per

    section~\ref{sec:banned-commands}. Failure behaviour is EAPI dependent as per

    section~\ref{sec:failure-behaviour}.

    section~\ref{sec:failure-behaviour}.

    \item rar files (\t{*.rar, *.RAR}). Ebuilds must ensure that RARLAB's unrar is installed.

    \item rar files (\t{*.rar, *.RAR}). Ebuilds must ensure that RARLAB's unrar is installed.

    \item LHA archives (\t{*.LHA, *.LHa, *.lha, *.lhz}). Ebuilds must ensure that the lha program is

    \item LHA archives (\t{*.LHA, *.LHa, *.lha, *.lhz}). Ebuilds must ensure that the lha program is

    installed.

    installed.

    \item lzma-compressed files (\t{*.lzma}). Ebuilds must ensure that LZMA Utils is installed.

    \item lzma-compressed files (\t{*.lzma}). Ebuilds must ensure that LZMA Utils is installed.

    \item lzma-compressed tar files (\t{*.tar.lzma}). Ebuilds must ensure that LZMA Utils and

    \item lzma-compressed tar files (\t{*.tar.lzma}). Ebuilds must ensure that LZMA Utils and

        GNU tar are installed.

        GNU tar are installed.