summaryrefslogtreecommitdiffstats
path: root/lib/lz4frame.h
diff options
context:
space:
mode:
authorYann Collet <cyan@fb.com>2018-09-06 00:57:15 (GMT)
committerYann Collet <cyan@fb.com>2018-09-06 01:08:51 (GMT)
commit26c42d7ad1c394538adb76879ec8d209b3ff5c84 (patch)
tree65d5d0a8a25a0501450d5eb775a885a05e846d5c /lib/lz4frame.h
parent858b6ad7f3f9aae072bccc1dbc484cbc2793a45a (diff)
downloadlz4-26c42d7ad1c394538adb76879ec8d209b3ff5c84.zip
lz4-26c42d7ad1c394538adb76879ec8d209b3ff5c84.tar.gz
lz4-26c42d7ad1c394538adb76879ec8d209b3ff5c84.tar.bz2
added comments on version numbers
Diffstat (limited to 'lib/lz4frame.h')
-rw-r--r--lib/lz4frame.h11
1 files changed, 6 insertions, 5 deletions
diff --git a/lib/lz4frame.h b/lib/lz4frame.h
index 2a67c69..75f1fd9 100644
--- a/lib/lz4frame.h
+++ b/lib/lz4frame.h
@@ -35,7 +35,8 @@
/* LZ4F is a stand-alone API to create LZ4-compressed frames
* conformant with specification v1.6.1.
* It also offers streaming capabilities.
- * lz4.h is not required when using lz4frame.h.
+ * lz4.h is not required when using lz4frame.h,
+ * except to get constant such as LZ4_VERSION_NUMBER.
* */
#ifndef LZ4F_H_09782039843
@@ -172,7 +173,7 @@ typedef struct {
LZ4F_blockChecksum_t blockChecksumFlag; /* 1: each block followed by a checksum of block's compressed data; 0: disabled (default) */
} LZ4F_frameInfo_t;
-#define LZ4F_INIT_FRAMEINFO { 0, 0, 0, 0, 0, 0, 0 }
+#define LZ4F_INIT_FRAMEINFO { 0, 0, 0, 0, 0, 0, 0 } /* v1.8.3+ */
/*! LZ4F_preferences_t :
* makes it possible to supply advanced compression instructions to streaming interface.
@@ -183,11 +184,11 @@ typedef struct {
LZ4F_frameInfo_t frameInfo;
int compressionLevel; /* 0: default (fast mode); values > LZ4HC_CLEVEL_MAX count as LZ4HC_CLEVEL_MAX; values < 0 trigger "fast acceleration" */
unsigned autoFlush; /* 1: always flush; reduces usage of internal buffers */
- unsigned favorDecSpeed; /* 1: parser favors decompression speed vs compression ratio. Only works for high compression modes (>= LZ4HC_CLEVEL_OPT_MIN) */ /* >= v1.8.2 */
+ unsigned favorDecSpeed; /* 1: parser favors decompression speed vs compression ratio. Only works for high compression modes (>= LZ4HC_CLEVEL_OPT_MIN) */ /* v1.8.2+ */
unsigned reserved[3]; /* must be zero for forward compatibility */
} LZ4F_preferences_t;
-#define LZ4F_INIT_PREFERENCES { LZ4F_INIT_FRAMEINFO, 0, 0, 0, { 0, 0, 0 } }
+#define LZ4F_INIT_PREFERENCES { LZ4F_INIT_FRAMEINFO, 0, 0, 0, { 0, 0, 0 } } /* v1.8.3+ */
/*-*********************************
@@ -229,7 +230,7 @@ typedef struct {
/*--- Resource Management ---*/
-#define LZ4F_VERSION 100 /* API version, signal an API breaking change */
+#define LZ4F_VERSION 100 /* This number can be used to check for an incompatible API breaking change */
LZ4FLIB_API unsigned LZ4F_getVersion(void);
/*! LZ4F_createCompressionContext() :