[gentoo-commits] proj/pms:eapi-9 commit in: /

["Ulrich Müller" <ulm@gentoo.org>]

commit:     35ac46a5a6fcd44c68971b92a1daaf2ad51a43e2
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Jun  8 16:41:33 2025 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Jun 15 11:33:40 2025 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=35ac46a5

Cheat sheet: Update for EAPI 9

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 eapi-cheatsheet.tex | 49 ++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 48 insertions(+), 1 deletion(-)

diff --git a/eapi-cheatsheet.tex b/eapi-cheatsheet.tex
index 60bea45..639d3f3 100644
--- a/eapi-cheatsheet.tex
+++ b/eapi-cheatsheet.tex
@@ -15,7 +15,7 @@
 \usepackage[local]{gitinfo2}
 \newcommand{\code}[1]{\texttt{#1}}
 % This should reflect the latest approved EAPI version
-\newcommand{\version}{8.0}
+\newcommand{\version}{9.0}
 \newcommand{\featureref}[1]{\textsc{#1} on page~\pageref{feat:#1}}
 \renewcommand{\familydefault}{\sfdefault}
 \urlstyle{sf}
@@ -577,6 +577,53 @@ differences between these EAPIs.
     and LHA archives. See \featureref{unpack-extensions}.
 \end{description}
 
+\section{EAPI 9}
+\label{sec:cs:eapi9}
+\subsection{Additions/changes}
+\label{sec:cs:eapi9-additions}
+\begin{description}
+    \item[Default EAPI for profiles] Profile directories without their
+    own \code{eapi} file no longer default to EAPI 0, but to the EAPI
+    specified in the top-level \code{profiles} directory.
+    See \featureref{profile-eapi-default}.
+    \item[\code{use.stable} and \code{package.use.stable}] These are
+    new files supported in profile directories. They may be used to
+    override the default USE flags specified by \code{make.defaults},
+    but act only on packages that would be merged due to a stable
+    keyword. See \featureref{use-stable}.
+    \item[Bash version] Ebuilds can use features of Bash version 5.2
+    (was 5.0 before). See \featureref{bash-version}.
+    \item[Variables are no longer exported] The package manager no
+    longer exports its defined shell variables (exceptions are
+    \code{TMPDIR} and \code{HOME}) to the environment. The same
+    applies to variables defined in \code{make.defaults} that have
+    specific meanings. See \featureref{export-vars}.
+    \item[\code{pipestatus}] Checks the shell's pipe status array,
+    i.\,e.\ the exit status of the command(s) in the last executed
+    pipeline, and returns true if all elements are zero. It also
+    prints the pipe status array when the \code{-v} option is given.
+    See \featureref{pipestatus}.
+    \item[\code{ver_replacing} \emph{op v2}] Checks if the relation
+    \emph{v1 op v2} is true for any element \emph{v1} of
+    \code{REPLACING_VERSIONS}\@. \emph{op} can be any operator that is
+    accepted by \code{ver_test}. See \featureref{ver-replacing}.
+    \item[\code{edo}] Outputs its entire argument list as an
+    informational message, then executes it as a simple shell command,
+    with standard failure behaviour. See \featureref{edo}.
+    \item[Merging of symlinks] When merging \code{D} to \code{ROOT},
+    absolute symlinks are now merged as-is. The package manager will
+    no longer strip a leading \code{D} from their link targets.
+    See \featureref{symlink-rewrite}.
+\end{description}
+\subsection{Removals/bans}
+\label{sec:cs:eapi9-removalsbans}
+\begin{description}
+    \item[\code{assert}] No longer allowed. Use \code{pipestatus}
+    instead. See \featureref{banned-commands}.
+    \item[\code{domo}] No longer allowed. Use \code{insinto} and
+    \code{newins} as replacement. See \featureref{banned-commands}.
+\end{description}
+
 \end{document}
 
 % vim: set filetype=tex fileencoding=utf8 et tw=70 spell spelllang=en :