diff options
author | Christian Mauderer <christian.mauderer@embedded-brains.de> | 2021-05-26 09:39:13 +0200 |
---|---|---|
committer | Christian Mauderer <christian.mauderer@embedded-brains.de> | 2021-05-28 08:24:05 +0200 |
commit | 50a835393a6b90ace96843dba2280f2fa559b821 (patch) | |
tree | e5aa15ec3b622bf406e502b968ee5fe7eb6813e8 | |
parent | rtems: Check entry point in rtems_task_start() (diff) | |
download | rtems-50a835393a6b90ace96843dba2280f2fa559b821.tar.bz2 |
cpukit: Add description of release version numbers
The release version in the git sources doesn't change. Add a note why
that is the case.
-rw-r--r-- | cpukit/include/rtems/version.h | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/cpukit/include/rtems/version.h b/cpukit/include/rtems/version.h index a8aff732f3..24104022b5 100644 --- a/cpukit/include/rtems/version.h +++ b/cpukit/include/rtems/version.h @@ -29,6 +29,27 @@ extern "C" { * * @brief The Version API provides functions to return the version or parts of * the version of RTEMS you are using. + * + * A branch in the version control system will always fall back to a + * NOT-RELEASED version number with a minor number of 0. Only the release + * archives have a VERSION file with a final release number. That means for + * example that the 5 development branch will still show a version 5.0.0 even + * after the 5.1 release. + * + * The reason for that are the following: + * + * 1. All pre-release tests are performed with a specific git hash. A committed + * VERSION file would need to be changed and committed afterwards for releasing + * with the required release version causing the released version to have a + * different git hash and the test results couldn't be linked to the released + * version. + * + * 2. Users deploying RTEMS would need to commit a local change to a committed + * VERSION file and that would clash with the project changes. Deployment can + * use the project repos directly. + * + * 3. The VERSION file management and generation is the responsibility of the + * release manager and the release process. */ /**@{**/ |