diff options
author | Boris Kolpackov <boris@codesynthesis.com> | 2018-03-21 09:31:57 +0200 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2018-03-21 09:31:57 +0200 |
commit | d6e7058475eeb4e6de1f882caff5cef55e2ce5dd (patch) | |
tree | 4aa4cbc51c82e6fb1f90cd21dd8cf62167de650b | |
parent | abaee667e9e88dbdc405a33aff5f24352e4a3498 (diff) |
Documentation update
-rw-r--r-- | doc/manual.cli | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index 74c9be7..f881948 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -155,17 +155,17 @@ order.] To convert one of these parts to its canonical representation, all its string components are converted to the lower case while all its integer components -are padded with leading zeros to the fixed length of \c{8} characters, with +are padded with leading zeros to the fixed length of \c{16} characters, with all trailing zero-only components removed. Note that this places an implementation limit on the length of integer components which should be checked by the implementation when converting to the canonical -representation. [Note: the \c{8} characters limit was chosen to still be able -to represent components in the \c{20151128} (date) form while not (visually) -bloating the database too much.] As a special case, the absent \i{prerel} part -is represented as \c{'~'}. [Note: since the ASCII code for \c{'~'} is greater -than any other character that could appear in \i{prerel}, such a string will -always be greater than any other representation.] The empty \i{prerel} part is -represented as an empty string. +representation. [Note: the \c{16} characters limit was chosen to still be able +to represent (with some spare) components in the \i{YYYYMMDDhhmmss} form while +not (visually) bloating the database too much.] As a special case, the absent +\i{prerel} part is represented as \c{'~'}. [Note: since the ASCII code for +\c{'~'} is greater than any other character that could appear in \i{prerel}, +such a string will always be greater than any other representation.] The empty +\i{prerel} part is represented as an empty string. Note that because it is no possible to perform a reverse conversion without the possibility of loss (consider \c{01.AA.BB}), the original parts may also |