mirror of
https://git.tukaani.org/xz.git
synced 2024-04-04 12:36:23 +02:00
liblzma: Set documentation on all reserved fields to private.
This prevents the reserved fields from being part of the generated Doxygen documentation.
This commit is contained in:
parent
bd213d06eb
commit
76dec92fcc
7 changed files with 173 additions and 0 deletions
|
@ -547,9 +547,17 @@ typedef struct {
|
|||
* you should not touch these, because the names of these variables
|
||||
* may change.
|
||||
*/
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr4;
|
||||
|
||||
/**
|
||||
|
@ -564,10 +572,19 @@ typedef struct {
|
|||
*/
|
||||
uint64_t seek_pos;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint64_t reserved_int2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
size_t reserved_int3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
size_t reserved_int4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum2;
|
||||
|
||||
} lzma_stream;
|
||||
|
|
|
@ -224,20 +224,50 @@ typedef struct {
|
|||
* with the currently supported options, so it is safe to leave these
|
||||
* uninitialized.
|
||||
*/
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int5;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int6;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int7;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_int8;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum4;
|
||||
|
||||
/**
|
||||
|
@ -261,12 +291,25 @@ typedef struct {
|
|||
*/
|
||||
lzma_bool ignore_check;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool5;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool6;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool7;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool8;
|
||||
|
||||
} lzma_block;
|
||||
|
|
|
@ -172,12 +172,25 @@ typedef struct {
|
|||
* with the currently supported options, so it is safe to leave these
|
||||
* uninitialized.
|
||||
*/
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int4;
|
||||
|
||||
/**
|
||||
|
@ -223,11 +236,22 @@ typedef struct {
|
|||
*/
|
||||
uint64_t memlimit_stop;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint64_t reserved_int7;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint64_t reserved_int8;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr4;
|
||||
|
||||
} lzma_mt;
|
||||
|
|
|
@ -68,11 +68,23 @@ typedef struct {
|
|||
* when type is LZMA_DELTA_TYPE_BYTE, so it is safe to leave these
|
||||
* uninitialized.
|
||||
*/
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr2;
|
||||
|
||||
} lzma_options_delta;
|
||||
|
|
|
@ -51,8 +51,13 @@ typedef struct {
|
|||
*/
|
||||
const lzma_stream_flags *flags;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr3;
|
||||
|
||||
/**
|
||||
|
@ -108,9 +113,17 @@ typedef struct {
|
|||
*/
|
||||
lzma_vli padding;
|
||||
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli4;
|
||||
} stream;
|
||||
|
||||
|
@ -197,14 +210,28 @@ typedef struct {
|
|||
*/
|
||||
lzma_vli total_size;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_vli reserved_vli4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
const void *reserved_ptr4;
|
||||
} block;
|
||||
|
||||
|
|
|
@ -481,16 +481,38 @@ typedef struct {
|
|||
* with the currently supported options, so it is safe to leave these
|
||||
* uninitialized.
|
||||
*/
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int5;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int6;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int7;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int8;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
void *reserved_ptr2;
|
||||
|
||||
} lzma_options_lzma;
|
||||
|
|
|
@ -88,19 +88,47 @@ typedef struct {
|
|||
* is just two bytes plus Backward Size of four bytes. But it's
|
||||
* nice to have the proper types when they are needed.)
|
||||
*/
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_reserved_enum reserved_enum4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool2;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool3;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool4;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool5;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool6;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool7;
|
||||
|
||||
/** \private Reserved field. */
|
||||
lzma_bool reserved_bool8;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int1;
|
||||
|
||||
/** \private Reserved field. */
|
||||
uint32_t reserved_int2;
|
||||
|
||||
} lzma_stream_flags;
|
||||
|
|
Loading…
Reference in a new issue