[maven-site] branch elharo-patch-5 created (now cbb5e0e)

[el...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

elharo pushed a change to branch elharo-patch-5
in repository https://gitbox.apache.org/repos/asf/maven-site.git.


      at cbb5e0e  [MNGSITE-387] Mention semantic versioning

This branch includes the following new commits:

     new cbb5e0e  [MNGSITE-387] Mention semantic versioning

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

[maven-site] 01/01: [MNGSITE-387] Mention semantic versioning

[el...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

elharo pushed a commit to branch elharo-patch-5
in repository https://gitbox.apache.org/repos/asf/maven-site.git

commit cbb5e0efb87ab8fc8a91f432c8de1c1ae1e86d77
Author: Elliotte Rusty Harold <el...@users.noreply.github.com>
AuthorDate: Thu Jan 2 07:36:49 2020 -0500

    [MNGSITE-387] Mention semantic versioning
    
    @rfscholte @hboutemy This seems like a straightforward description that covers most common use cases. Unfortunately i'm not sure it's true, especially when plus signs (build identifiers) are considered. Posting for discussion.
---
 content/apt/pom.apt | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/content/apt/pom.apt b/content/apt/pom.apt
index 06dd045..cbb349c 100644
--- a/content/apt/pom.apt
+++ b/content/apt/pom.apt
@@ -457,6 +457,14 @@ mvn install:install-file -Dfile=non-maven-proj.jar -DgroupId=some.group -Dartifa
 
 *** {Version Order Specification}:
 
+  If version strings are syntactically correct [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html),
+  version numbers, then version comparison follows the precedence rules outlined in that specification.
+  These versions are ASCII alphanumeric strings such as 2.15.2-alpha commonly encountered.
+  More precisely, this is true if both version numbers to be compared match the "valid semver"
+  production in the BNF grammar in the semantic versioning specification.
+  It does not consider any semantics implied by that specification.
+
+  When version strings do not follow semantic versioning, a more complex set of rule is required. 
   The Maven coordinate is split in tokens between dots ('<<<.>>>'), hyphens ('<<<->>>') and transitions between digits and characters.
   The separator is recorded and will have effect on the order. A transition 
   between digits and characters is equivalent to a hyphen.