From 5b8411277e44e92eea3b8e9469af003415c02a6f Mon Sep 17 00:00:00 2001 From: Jens Lorenz Date: Mon, 12 Feb 2018 17:45:56 +0100 Subject: CMake: Implement VCS agnostic versioning Versioning should not strictly depend on Version Control System (e.g. git). Best approach is to have a dedicated VERSION file exposing with format ... Target is that maintainer will manually release the version once patches/fixes are merged e.g. to a stabilization branch. In order to have an OEM specific meta information exposed with the version information EXTRAVERSIONINFO can be specified by CMAKE flag. Signed-off-by: Guerra Mattia --- docx/02_y_versioning.dox | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docx') diff --git a/docx/02_y_versioning.dox b/docx/02_y_versioning.dox index 864a04e..c30e6bd 100644 --- a/docx/02_y_versioning.dox +++ b/docx/02_y_versioning.dox @@ -17,6 +17,8 @@ /*! \page ver Versioning +\section mec_ver Versioning Mechanism +Versioning should not strictly depend on Version Control System (e.g. git) information. Best approach is to have a dedicated resource exposing the Version of the project. This is achieved via the \c VERSION file in the main folder of the AudioManager, which content is read by CMake and used in the whole component. Optionally, the flag \c EXTRAVERSIONINFO can be used to append additional information to the version. \c VERSION is reporting with the format <\c Major>.<\c Minor>.<\c Revision>. Maintainer of the component should take care of keeping the information aligned with release cycle. \c Revision should be maintained once patches/fixes are merged to a stabilization branch. \section new_ver New versioning scheme Due to the unclearness in the versioning scheme, the versioning scheme changed with release 7.0. Beginning with the 7.0 version, the versioning changed to the semantic versioning described here: http://semver.org/. -- cgit v1.2.1