liblzma: Very minor API doc tweaks.
Use "member" to refer to struct members as that's the term used by the C standard. Use lzma_options_delta.dist and such in docs so that in Doxygen's HTML output they will link to the doc of the struct member. Clean up a few trailing white spaces too.
This commit is contained in:
parent
d31fbd28be
commit
bc34e5ac99
|
@ -33,11 +33,11 @@ typedef struct {
|
||||||
* \brief Block format version
|
* \brief Block format version
|
||||||
*
|
*
|
||||||
* To prevent API and ABI breakages when new features are needed,
|
* To prevent API and ABI breakages when new features are needed,
|
||||||
* a version number is used to indicate which fields in this
|
* a version number is used to indicate which members in this
|
||||||
* structure are in use:
|
* structure are in use:
|
||||||
* - liblzma >= 5.0.0: version = 0 is supported.
|
* - liblzma >= 5.0.0: version = 0 is supported.
|
||||||
* - liblzma >= 5.1.4beta: Support for version = 1 was added,
|
* - liblzma >= 5.1.4beta: Support for version = 1 was added,
|
||||||
* which adds the ignore_check field.
|
* which adds the ignore_check member.
|
||||||
*
|
*
|
||||||
* If version is greater than one, most Block related functions
|
* If version is greater than one, most Block related functions
|
||||||
* will return LZMA_OPTIONS_ERROR (lzma_block_header_decode() works
|
* will return LZMA_OPTIONS_ERROR (lzma_block_header_decode() works
|
||||||
|
@ -286,7 +286,7 @@ typedef struct {
|
||||||
/**
|
/**
|
||||||
* \brief A flag to Block decoder to not verify the Check field
|
* \brief A flag to Block decoder to not verify the Check field
|
||||||
*
|
*
|
||||||
* This field is supported by liblzma >= 5.1.4beta if .version >= 1.
|
* This member is supported by liblzma >= 5.1.4beta if .version >= 1.
|
||||||
*
|
*
|
||||||
* If this is set to true, the integrity check won't be calculated
|
* If this is set to true, the integrity check won't be calculated
|
||||||
* and verified. Unless you know what you are doing, you should
|
* and verified. Unless you know what you are doing, you should
|
||||||
|
|
|
@ -60,12 +60,12 @@ typedef struct {
|
||||||
uint32_t dist;
|
uint32_t dist;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Minimum value for the dist field in lzma_options_delta.
|
* \brief Minimum value for lzma_options_delta.dist.
|
||||||
*/
|
*/
|
||||||
# define LZMA_DELTA_DIST_MIN 1
|
# define LZMA_DELTA_DIST_MIN 1
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Maximum value for the dist field in lzma_options_delta.
|
* \brief Maximum value for lzma_options_delta.dist.
|
||||||
*/
|
*/
|
||||||
# define LZMA_DELTA_DIST_MAX 256
|
# define LZMA_DELTA_DIST_MAX 256
|
||||||
|
|
||||||
|
|
|
@ -243,13 +243,13 @@ typedef struct {
|
||||||
* touch these in any way.
|
* touch these in any way.
|
||||||
*/
|
*/
|
||||||
union {
|
union {
|
||||||
/** \private Internal field. */
|
/** \private Internal member. */
|
||||||
const void *p;
|
const void *p;
|
||||||
|
|
||||||
/** \private Internal field. */
|
/** \private Internal member. */
|
||||||
size_t s;
|
size_t s;
|
||||||
|
|
||||||
/** \private Internal field. */
|
/** \private Internal member. */
|
||||||
lzma_vli v;
|
lzma_vli v;
|
||||||
} internal[6];
|
} internal[6];
|
||||||
} lzma_index_iter;
|
} lzma_index_iter;
|
||||||
|
|
|
@ -37,7 +37,7 @@ typedef struct {
|
||||||
*
|
*
|
||||||
* To prevent API and ABI breakages if new features are needed in
|
* To prevent API and ABI breakages if new features are needed in
|
||||||
* Stream Header or Stream Footer, a version number is used to
|
* Stream Header or Stream Footer, a version number is used to
|
||||||
* indicate which fields in this structure are in use. For now,
|
* indicate which members in this structure are in use. For now,
|
||||||
* version must always be zero. With non-zero version, the
|
* version must always be zero. With non-zero version, the
|
||||||
* lzma_stream_header_encode() and lzma_stream_footer_encode()
|
* lzma_stream_header_encode() and lzma_stream_footer_encode()
|
||||||
* will return LZMA_OPTIONS_ERROR.
|
* will return LZMA_OPTIONS_ERROR.
|
||||||
|
@ -70,12 +70,12 @@ typedef struct {
|
||||||
lzma_vli backward_size;
|
lzma_vli backward_size;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Minimum size of the backward_size member
|
* \brief Minimum value for lzma_stream_flags.backward_size
|
||||||
*/
|
*/
|
||||||
# define LZMA_BACKWARD_SIZE_MIN 4
|
# define LZMA_BACKWARD_SIZE_MIN 4
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Maximum size of the backward_size member
|
* \brief Maximum value for lzma_stream_flags.backward_size
|
||||||
*/
|
*/
|
||||||
# define LZMA_BACKWARD_SIZE_MAX (LZMA_VLI_C(1) << 34)
|
# define LZMA_BACKWARD_SIZE_MAX (LZMA_VLI_C(1) << 34)
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue