summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChristian Mauderer <christian.mauderer@embedded-brains.de>2021-05-26 09:39:13 +0200
committerChristian Mauderer <christian.mauderer@embedded-brains.de>2021-05-28 08:22:04 +0200
commit023a27096223e33be1cdd3f8d2ccf11caeda72b1 (patch)
tree95ffea57fc9d1d908b03889d5dfa70f3757cb441
parentscore: Add RTEMS_UNREACHABLE() to a group (diff)
downloadrtems-023a27096223e33be1cdd3f8d2ccf11caeda72b1.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.h21
1 files changed, 21 insertions, 0 deletions
diff --git a/cpukit/include/rtems/version.h b/cpukit/include/rtems/version.h
index 87d5e1492c..cdd8905735 100644
--- a/cpukit/include/rtems/version.h
+++ b/cpukit/include/rtems/version.h
@@ -32,6 +32,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.
+ *
* @{
*/