From f8c0fea9c6b98436d70f77550ded5f8316e1e941 Mon Sep 17 00:00:00 2001 From: "Gerardo E. Cruz-Ortiz" <59618057+astrogeco@users.noreply.github.com> Date: Mon, 6 Jul 2020 16:03:18 -0400 Subject: [PATCH] Add description for build name and build number. Add build name and number #define Apply clang-format --- fsw/cfe-core/src/inc/cfe_version.h | 31 ++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/fsw/cfe-core/src/inc/cfe_version.h b/fsw/cfe-core/src/inc/cfe_version.h index b6534ac70..b2cf39ea4 100644 --- a/fsw/cfe-core/src/inc/cfe_version.h +++ b/fsw/cfe-core/src/inc/cfe_version.h @@ -65,20 +65,31 @@ * The minor number may increment when there have been no augmentations to the API, if changes are as significant as * additions to the public API. * - * The revision numbers may update in implementations where no actual implementation-specific code has changed, if + * The revision numbers may increment in implementations where no actual implementation-specific code has changed, if * there are other changes within the release with similar significance. * *

How and Where Defined

* * The Major, Minor, and Revision components of the version are provided as simple macros defined in the cfe_version.h - * header file as part of the API definition; these macros must expand to simple integer values, so that they can be used - * in simple if directives by the macro preprocessor. + * header file as part of the API definition; these macros must expand to simple integer values, so that they can be + * used in simple if directives by the macro preprocessor. * * The Mission Version is provided as a simple macro defined in the cfe_platform_cfg.h header file. As delivered in * official releases, these macros must expand to simple integer values, so that they can be used in simple macro * preprocessor conditions, but delivered code should not prevent a mission from, for example, deciding that the Mission * Version is actually a text string. * + *

Identification of development builds

+ * + * In order to distinguish between development versions, we provide a BUILD_NAME and a BUILD_NUMBER. + * + * The BUILDNAME is a unifying monicker that indicates compatibility across the core Flight System's propduct suite. The + * build name is a star or constellation name and changes once per official release. Subsequent build names starts with + * the next letter in the 24-character alphabet. In between official releases, the BUILDNAME will be held constant. + * + * The BUILDNUMBER reflects the number of commits since the last official release for each particular component. This + * integer monotonically increases for a given BUILDNAME. When a new BUILDNAME is applied, the BUILDNUMBER resets to + * zero. */ #ifndef _cfe_version_ @@ -91,13 +102,17 @@ */ #include - /* ** Macro Definitions */ -#define CFE_MAJOR_VERSION 6 -#define CFE_MINOR_VERSION 7 -#define CFE_REVISION 21 +#define CFE_MAJOR_VERSION 6 +#define CFE_MINOR_VERSION 7 +#define CFE_REVISION 21 +/* +** Development build identifiers +*/ +#define CFE_BUILD_NAME BOOTES +#define CFE_BUILD_NUMBER 1 -#endif /* _cfe_version_ */ +#endif /* _cfe_version_ */