diff options
author | Jia Tan <jiat0218@gmail.com> | 2023-01-26 09:50:21 +0800 |
---|---|---|
committer | Jia Tan <jiat0218@gmail.com> | 2023-03-07 23:57:39 +0800 |
commit | b82d4831e3f2339c4cdbc47776c99462088c11b7 (patch) | |
tree | 0850d53c9298a4c6023e7f13c4facfdec09ca52c | |
parent | liblzma: Clarify lzma_lzma_preset() documentation in lzma12.h. (diff) | |
download | xz-b82d4831e3f2339c4cdbc47776c99462088c11b7.tar.xz |
liblzma: Improve documentation for version.h.
Specified parameter and return values for API functions and documented
a few more of the macros.
-rw-r--r-- | src/liblzma/api/lzma/version.h | 29 |
1 files changed, 22 insertions, 7 deletions
diff --git a/src/liblzma/api/lzma/version.h b/src/liblzma/api/lzma/version.h index d8d09599..4ee90d55 100644 --- a/src/liblzma/api/lzma/version.h +++ b/src/liblzma/api/lzma/version.h @@ -18,14 +18,26 @@ #endif -/* - * Version number split into components - */ +/** \brief Major version number of the liblzma release. */ #define LZMA_VERSION_MAJOR 5 + +/** \brief Minor version number of the liblzma release. */ #define LZMA_VERSION_MINOR 4 + +/** \brief Patch version number of the liblzma release. */ #define LZMA_VERSION_PATCH 1 + +/** + * \brief Version stability marker + * + * This will always be one of three values: + * - LZMA_VERSION_STABILITY_ALPHA + * - LZMA_VERSION_STABILITY_BETA + * - LZMA_VERSION_STABILITY_STABLE + */ #define LZMA_VERSION_STABILITY LZMA_VERSION_STABILITY_STABLE +/** \brief Commit version number of the liblzma release */ #ifndef LZMA_VERSION_COMMIT # define LZMA_VERSION_COMMIT "" #endif @@ -102,9 +114,10 @@ /** * \brief Run-time version number as an integer * - * Return the value of LZMA_VERSION macro at the compile time of liblzma. - * This allows the application to compare if it was built against the same, + * This allows an application to compare if it was built against the same, * older, or newer version of liblzma that is currently running. + * + * \return The value of LZMA_VERSION macro at the compile time of liblzma */ extern LZMA_API(uint32_t) lzma_version_number(void) lzma_nothrow lzma_attr_const; @@ -113,8 +126,10 @@ extern LZMA_API(uint32_t) lzma_version_number(void) /** * \brief Run-time version as a string * - * This function may be useful if you want to display which version of - * liblzma your application is currently using. + * This function may be useful to display which version of liblzma an + * application is currently using. + * + * \return Run-time version of liblzma */ extern LZMA_API(const char *) lzma_version_string(void) lzma_nothrow lzma_attr_const; |