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

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

commit:     1f6b1818a65d83ab6703ff2be6751ab4beaaf8df
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Jan 20 13:21:44 2025 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Feb  9 20:33:54 2025 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=1f6b1818

EAPI 9 has ver_replacing

Bug: https://bugs.gentoo.org/947530
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 eapi-differences.tex |  4 ++++
 pkg-mgr-commands.tex | 20 ++++++++++++++++----
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 7b978ea..75e80f0 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -171,6 +171,9 @@ Controllable stripping & \compactfeatureref{dostrip} &
 \t{ver_*} commands & \compactfeatureref{ver-commands} &
     No & Yes & Yes & Yes \\
 
+\t{ver_replacing} & \compactfeatureref{ver-replacing} &
+    No & No & No & Yes \\
+
 \t{unpack} support for \t{7z} & \compactfeatureref{unpack-extensions} &
     Yes & Yes & No & No \\
 
@@ -369,6 +372,7 @@ EAPI 9 is EAPI 8 with the following changes:
 \item Variables no longer exported, \featureref{export-vars}.
 \item \t{assert} banned, \featureref{banned-commands}.
 \item \t{pipestatus}, \featureref{pipestatus}.
+\item \t{ver_replacing}, \featureref{ver-replacing}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{9}

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 3c03f0b..bff6346 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -1098,20 +1098,32 @@ the second, inclusively.
 
     Both version strings must conform to the version specification in
     section~\ref{sec:version-spec}. Comparison is done using algorithm~\ref{alg:version-comparison}.
+
+\item[ver_replacing] \featurelabel{ver-replacing} Takes an operator and a version string as
+    arguments, which follow the same specification as in \t{ver_test}. Iterates over the elements
+    of \t{REPLACING_VERSIONS}, using \t{ver_test} to compare each element with the version string.
+    Returns shell true (0) if the specified relation is fulfilled for any element. Note that if
+    \t{REPLACING_VERSIONS} is empty, shell false (1) is returned.
+
+    Only available in EAPIs listed in table~\ref{tab:version-commands} as supporting
+    \t{ver_replacing}. The command is only meaningful in phases where \t{REPLACING_VERSIONS} is
+    defined.
 \end{description}
 
 \ChangeWhenAddingAnEAPI{9}
 \begin{centertable}{EAPIs supporting version manipulation commands}
     \label{tab:version-commands}
-    \begin{tabular}{llll}
+    \begin{tabular}{lllll}
       \toprule
       \multicolumn{1}{c}{\textbf{EAPI}} &
       \multicolumn{1}{c}{\textbf{\t{ver_cut}?}} &
       \multicolumn{1}{c}{\textbf{\t{ver_rs}?}} &
-      \multicolumn{1}{c}{\textbf{\t{ver_test}?}} \\
+      \multicolumn{1}{c}{\textbf{\t{ver_test}?}} &
+      \multicolumn{1}{c}{\textbf{\t{ver_replacing}?}} \\
       \midrule
-      0, 1, 2, 3, 4, 5, 6 & No  & No  & No  \\
-      7, 8, 9             & Yes & Yes & Yes \\
+      0, 1, 2, 3, 4, 5, 6 & No  & No  & No  & No  \\
+      7, 8                & Yes & Yes & Yes & No  \\
+      9                   & Yes & Yes & Yes & Yes \\
       \bottomrule
     \end{tabular}
 \end{centertable}