Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a link to the actual Maven versioning specification #750

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
17 changes: 8 additions & 9 deletions src/site/markdown/version-rules.md.vm
Original file line number Diff line number Diff line change
Expand Up @@ -20,21 +20,19 @@ under the License.
-->

## Velocity uses # as a prefix for macros and ## as a prefix for comments
#set($h1 = '#')
#set($h2 = '##')
#set($h3 = '###')
#set($h4 = '####')

$h1 Version number rules
Version number rules
====================

$h2 Introduction
Introduction
------------

**Notice:** The limitations explained in this paragraph were true in Maven 2.x, but have been **fixed** in Maven 3.x (see
[Maven Versioning Wiki page](https://cwiki.apache.org/confluence/display/MAVENOLD/Versioning) for more details)

The current implementation of
[DefaultArtifactVersion](https://maven.apache.org/ref/current/maven-artifact/xref/org/apache/maven/artifact/versioning/DefaultArtifactVersion.html)
in the core of Maven expects that version numbers will have a very specific format:
The current implementation of the
[Maven Version Order Specification](https://maven.apache.org/pom.html#version-order-specification) will have a very specific format:

` <MajorVersion [> . <MinorVersion [> . <IncrementalVersion ] ] [> - <BuildNumber | Qualifier ]> `

Expand All @@ -57,7 +55,8 @@ The `versions-maven-plugin` knows three rules for comparing version numbers:
The `versions-maven-plugin` will assume that all version numbers follow the `maven` scheme unless you tell
it otherwise.

$h2 Rules.xml
Rules.xml
---------

To specify the version schemes to use, you may define a [rule-set xml file](./rule.html), use the `ruleSet`
element in the `versions-maven-plugin` plugin configuration, or specify ignored versions via
Expand Down