commit c60cd3c0d553b740c04bad2f6a00b036dce02198
Author: Ulrich Müller <ulm@gentoo.org>
Date:   Thu Feb 5 10:57:48 2026 +0100

    names, pkg-mgr-commands: Clarify "suffix" and "version component"
    
    Closes: https://bugs.gentoo.org/969629
    Signed-off-by: Ulrich Müller <ulm@gentoo.org>

diff --git a/names.tex b/names.tex
index fa7c51d..fdae0ff 100644
--- a/names.tex
+++ b/names.tex
@@ -67,9 +67,9 @@ A version starts with the number part, which is in the form \t{[0-9]+(\textbacks
 
 This may optionally be followed by one of \t{[a-z]} (a lower-case letter).
 
-This may be followed by zero or more of the suffixes \t{_alpha}, \t{_beta}, \t{_pre}, \t{_rc}
-or \t{_p}, each of which may optionally be followed by an unsigned integer. Suffix and integer
-count as separate version components.
+This may be followed by zero or more suffixes. Each suffix consists of one of the strings
+\t{_alpha}, \t{_beta}, \t{_pre}, \t{_rc} or \t{_p}, optionally followed by an unsigned integer.
+String part and integer part of the suffix count as separate version components.
 
 This may optionally be followed by the suffix \t{-r} followed immediately by an unsigned integer
 (the ``revision number''). If this suffix is not present, it is assumed to be \t{-r0}.
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 3f5592b..9e0294f 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -1048,9 +1048,10 @@ For the purpose of version manipulation commands, the specification provides a m
 an arbitrary version string (not necessarily conforming to section~\ref{sec:version-spec}) into
 a series of version components and version separators.
 
-A version component consists either purely of digits (\t{[0-9]+}) or purely of upper- and
-lower-case ASCII letters (\t{[A-Za-z]+}). A version separator is either a string of any other
+In the context of this section, a \i{version component} consists either purely of digits
+(\t{[0-9]+}) or purely of upper- and lower-case ASCII letters (\t{[A-Za-z]+}).
+A \i{version separator} is either a string of any other
 characters (\t{[\textasciicircum A-Za-z0-9]+}), or it occurs at the transition between a sequence
 of digits and a sequence of letters, or vice versa. In the latter case, the version separator is
 an empty string.