From 01bf1ac4b121f4dd2762bea8f2def095c8ee0058 Mon Sep 17 00:00:00 2001 From: Zopolis4 Date: Sat, 29 Nov 2025 23:19:49 +1100 Subject: [PATCH 1/3] Add errata as a known post-release keyword to doc/ALGORITHM.md --- doc/ALGORITHM.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/ALGORITHM.md b/doc/ALGORITHM.md index 88ed236..f254c79 100644 --- a/doc/ALGORITHM.md +++ b/doc/ALGORITHM.md @@ -12,7 +12,7 @@ * **PRE_RELEASE** - known pre-release keyword (`alpha`, `beta`, `pre`, `rc`). * **ZERO** - numeric component equal to zero. - * **POST_RELEASE** - known post-release keyword (`patch`, `post`, `pl`). + * **POST_RELEASE** - known post-release keyword (`errata`, `patch`, `post`, `pl`). * **NONZERO** - numeric component not equal to zero. * Unclassified alphabetic components are assigned **PRE_RELEASE** From f14be8b8213786d8e14c775d94acd17150736d1c Mon Sep 17 00:00:00 2001 From: Zopolis4 Date: Sat, 29 Nov 2025 23:22:45 +1100 Subject: [PATCH 2/3] Add simplified explanation for letter suffix in doc/ALGORITHM.md --- doc/ALGORITHM.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/ALGORITHM.md b/doc/ALGORITHM.md index f254c79..ba85c9a 100644 --- a/doc/ALGORITHM.md +++ b/doc/ALGORITHM.md @@ -21,8 +21,10 @@ A special case exists for alphabetic component which follows numeric component, and is not followed by another numeric component after a delimiter (`1.0a`, `1.0a.1`, but not `1.0a1` - because of lack of delimiter). Such alphabetic component is - assigned a different rank, **LETTER_SUFFIX**, which follows + because of lack of delimiter). In other words, if the previous + component is numeric, the current component is alphabetic, + and the next component is not numeric. Such alphabetic component + is assigned a different rank, **LETTER_SUFFIX**, which follows **NONZERO** (choice of this behavior explained below). 3. Versions are compared component-wise. From fb7eda42c589fe0d4c08b85fa132912604c72ff5 Mon Sep 17 00:00:00 2001 From: Zopolis4 Date: Sat, 29 Nov 2025 23:29:17 +1100 Subject: [PATCH 3/3] Add note on the additional padding created when a bound is specified in doc/ALGORITHM.md --- doc/ALGORITHM.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/ALGORITHM.md b/doc/ALGORITHM.md index ba85c9a..50f86ed 100644 --- a/doc/ALGORITHM.md +++ b/doc/ALGORITHM.md @@ -137,7 +137,8 @@ any other rank, and to tweak version padding algorithm to use these instead of `0` filler. This way for a given version a component sequence would be produced which always compares less than or greater than (correspondingly) any natural post-or pre-release version with the -same prefix. +same prefix. Note that if a bound is requested, at least one unit +of padding will be added, even if the versions are the same length. This is implemented in libversion with `VERSIONFLAG_LOWER_BOUND` and `VERSIONFLAG_UPPER_BOUND` flags.