From 8561af5a2551ec453c9888125de273f2cc2940c0 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Tue, 14 Aug 2018 14:09:32 +0200
Subject: Add support for parsing semantic and semantic-like versions

---
 libbutl/standard-version.mxx | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'libbutl/standard-version.mxx')

diff --git a/libbutl/standard-version.mxx b/libbutl/standard-version.mxx
index 5f019c4..7b1f232 100644
--- a/libbutl/standard-version.mxx
+++ b/libbutl/standard-version.mxx
@@ -48,6 +48,25 @@ LIBBUTL_MODEXPORT namespace butl
   // [+<epoch>-]<maj>.<min>.<patch>-
   // 0[+<revision>]
   //
+  // The numeric version format is AAABBBCCCDDDE where:
+  //
+  // AAA - major version number
+  // BBB - minor version number
+  // CCC - patch version number
+  // DDD - alpha / beta (DDD + 500) version number
+  // E   - final (0) / snapshot (1)
+  //
+  // When DDDE is not 0, 1 is subtracted from AAABBBCCC. For example:
+  //
+  // Version      AAABBBCCCDDDE
+  //
+  // 0.1.0        0000010000000
+  // 0.1.2        0000010010000
+  // 1.2.3        0010020030000
+  // 2.2.0-a.1    0020019990010
+  // 3.0.0-b.2    0029999995020
+  // 2.2.0-a.1.z  0020019990011
+  //
   struct LIBBUTL_SYMEXPORT standard_version
   {
     // Invariants:
-- 
cgit v1.1