[patch] Specification of ver_replacing

0001-EAPI-9-has-ver_replacing.patch (text/plain), 3.21 KB, created by Ulrich Müller on 2025-01-20 13:28:50 UTC

From 871315d3ad7bfacdb0ced081dae97b3d074a3a2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <[e-mail]>
Date: Mon, 20 Jan 2025 14:21:44 +0100
Subject: [PATCH] EAPI 9 has ver_replacing
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bug: https://bugs.gentoo.org/947530
Signed-off-by: Ulrich Müller <[e-mail]>
---
 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 96ca568..1f08e66 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 \\
 
@@ -372,6 +375,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}.
 \item Absolute symlinks no longer rewritten, \featureref{symlink-rewrite}.
 \end{compactitem}
 
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}
-- 
2.48.1