From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1716573-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits))
	(No client certificate requested)
	by finch.gentoo.org (Postfix) with ESMTPS id 15C5E1582EF
	for <garchives@archives.gentoo.org>; Sun, 09 Feb 2025 20:38:24 +0000 (UTC)
Received: from lists.gentoo.org (bobolink.gentoo.org [140.211.166.189])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits))
	(No client certificate requested)
	(Authenticated sender: relay-lists.gentoo.org@gentoo.org)
	by smtp.gentoo.org (Postfix) with ESMTPSA id EC6F8343108
	for <garchives@archives.gentoo.org>; Sun, 09 Feb 2025 20:38:23 +0000 (UTC)
Received: from bobolink.gentoo.org (localhost [127.0.0.1])
	by bobolink.gentoo.org (Postfix) with ESMTP id E27571103CB;
	Sun, 09 Feb 2025 20:38:22 +0000 (UTC)
Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits))
	(No client certificate requested)
	by bobolink.gentoo.org (Postfix) with ESMTPS id D52551103CB
	for <gentoo-commits@lists.gentoo.org>; Sun, 09 Feb 2025 20:38:22 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
	(No client certificate requested)
	by smtp.gentoo.org (Postfix) with ESMTPS id 55AF7343106
	for <gentoo-commits@lists.gentoo.org>; Sun, 09 Feb 2025 20:38:22 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
	by oystercatcher.gentoo.org (Postfix) with ESMTP id 8CDBD1B42
	for <gentoo-commits@lists.gentoo.org>; Sun, 09 Feb 2025 20:38:20 +0000 (UTC)
From: "Ulrich Müller" <ulm@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" <ulm@gentoo.org>
Message-ID: <1739133234.1f6b1818a65d83ab6703ff2be6751ab4beaaf8df.ulm@gentoo>
Subject: [gentoo-commits] proj/pms:eapi-9 commit in: /
X-VCS-Repository: proj/pms
X-VCS-Files: eapi-differences.tex pkg-mgr-commands.tex
X-VCS-Directories: /
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Müller
X-VCS-Revision: 1f6b1818a65d83ab6703ff2be6751ab4beaaf8df
X-VCS-Branch: eapi-9
Date: Sun, 09 Feb 2025 20:38:20 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: 7ecb52e9-2a91-47f9-bfff-f13d46351a97
X-Archives-Hash: 538ca185a01d3aaaf73db68e4193ecd7

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}