This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git
The following commit(s) were added to refs/heads/master by this push:
new 5e03caa5 Fix versions comparison (#331)
5e03caa5 is described below
commit 5e03caa55644e49e7db56630a7d24dc5d4bd4259
Author: Gwénaël Ruelland <[email protected]>
AuthorDate: Mon Nov 14 13:13:39 2022 +0100
Fix versions comparison (#331)
---
content/apt/pom.apt.vm | 23 +++++++++++++++++------
1 file changed, 17 insertions(+), 6 deletions(-)
diff --git a/content/apt/pom.apt.vm b/content/apt/pom.apt.vm
index c05265fc..d7703306 100644
--- a/content/apt/pom.apt.vm
+++ b/content/apt/pom.apt.vm
@@ -515,7 +515,18 @@ mvn install:install-file -Dfile=non-maven-proj.jar
-DgroupId=some.group -Dartifa
* the "<<<alpha>>>", "<<<beta>>>" and "<<<milestone>>>" qualifiers can
respectively be shortened to "a", "b" and "m" when directly followed by a
number.
- * else "<<<.qualifier>>>" \< "<<<-qualifier>>>" \< "<<<-number>>>" \<
"<<<.number>>>"
+ * else "<<<.qualifier>>>" = "<<<-qualifier>>>" \< "<<<-number>>>" \<
"<<<.number>>>"
+
+ * <<<alpha>>> = <<<a>>> < <<<beta>>> = <<<b>>> < <<<milestone>>> = <<<m>>> <
<<<rc>>> = <<<cr>>> < <<<snapshot>>> < '<<<>>>' = <<<final>>> = <<<ga>>> =
<<<release>>> \< <<<sp>>>
+
+ []
+
+ Following semver rules is encouraged, and some qualifiers are discouraged:
+ * Prefer '<<<alpha>>>', '<<<beta>>>' and '<<<milestone>>>' qualifiers over
'<<<ea>>>' and '<<<preview>>>'.
+ * Prefer '<<<1.0.0-RC1>>>'' over '<<<1.0.0.RC1>>>'.
+ * The usage of '<<<CR>>>' qualifier is discouraged. Use '<<<RC>>>' instead.
+ * The usage of '<<<final>>>', '<<<ga>>>', and '<<<release>>>' qualifiers is
discouraged. Use no qualifier instead.
+ * The usage of '<<<SP>>>' qualifier is discouraged. Increment the patch
version instead.
[]
@@ -527,17 +538,17 @@ mvn install:install-file -Dfile=non-maven-proj.jar
-DgroupId=some.group -Dartifa
* "<<<1-foo2>>>" \< "<<<1-foo10>>>" (correctly automatically "switching" to
numeric order)
- * "<<<1.foo>>>" \< "<<<1-foo>>>" \< "<<<1-1>>>" \< "<<<1.1>>>"
+ * "<<<1.foo>>>" = "<<<1-foo>>>" \< "<<<1-1>>>" \< "<<<1.1>>>"
- * "<<<1.ga>>>" = "<<<1-ga>>>" = "<<<1-0>>>" = "<<<1.0>>>" = "<<<1>>>"
(removing of trailing "null" values)
+ * "<<<1.ga>>>" = "<<<1-ga>>>" = "<<<1-0>>>" = "<<<1.0>>>" = "<<<1>>>"
(removing of trailing "null" values)
- * "<<<1-sp>>>" \> "<<<1-ga>>>"
+ * "<<<1-sp>>>" \> "<<<1-ga>>>"
- * "<<<1-sp.1>>>" \> "<<<1-ga.1>>>"
+ * "<<<1-sp.1>>>" \> "<<<1-ga.1>>>"
* "<<<1-sp-1>>>" \< "<<<1-ga-1>>>" = "<<<1-1>>>" (trailing "null" values at
each hyphen)
- * "<<<1-a1>>>" = "<<<1-alpha-1>>>"
+ * "<<<1-a1>>>" = "<<<1-alpha-1>>>"
Note: Contrary to what was stated in some design documents, for version
order, snapshots are not treated differently than releases or any other
qualifier.
