diff options
author | Nick Mathewson <nickm@torproject.org> | 2018-01-26 12:54:42 -0500 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2018-01-26 12:54:42 -0500 |
commit | ec009108ec08216a111761a7277516a7b26e2252 (patch) | |
tree | 299beb9fe40578d89a0fc1e09836ce92f2897914 /version-spec.txt | |
parent | e6c3257b065f7fe816843bf37de3c3b958d30ee7 (diff) | |
download | torspec-ec009108ec08216a111761a7277516a7b26e2252.tar.gz torspec-ec009108ec08216a111761a7277516a7b26e2252.zip |
version-spec: specify the different statuses that a version can have
Diffstat (limited to 'version-spec.txt')
-rw-r--r-- | version-spec.txt | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/version-spec.txt b/version-spec.txt index 1f25cd1..c97c8ce 100644 --- a/version-spec.txt +++ b/version-spec.txt @@ -50,3 +50,29 @@ 0.1.1.1-alpha comes 0.1.1.1-alpha-cvs, and so on. But starting with 0.1.2.1-alpha-dev, we switched to SVN and started using the "-dev" suffix instead of the "-cvs" suffix. + +3. Version status. + + Sometimes we need to determine whether a Tor version is obsolete, + experimental, or neither, based on a list of recommended versions. The + logic is as follows: + + * If a version is listed on the recommended list, then it is + "recommended". + + * If a version is newer than every recommended version, that version + is "experimental" or "new". + + * If a version is older than every recommended version, it is + "obsolete" or "old". + + * The first three components (major,minor,micro) of a version number + are its "release series". If a version has other recommended + versions with the same release series, and the version is newer + than all such recommended versions, but it is not newer than + _every_ recommended version, then the version is "new in series". + + * Finally, if none of the above conditions hold, then the version is + "un-recommended." + + |