summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorYann Collet <cyan@fb.com>2017-02-08 19:02:32 (GMT)
committerYann Collet <cyan@fb.com>2017-02-08 19:02:32 (GMT)
commit04ec09269645760604974980bce5b9df13ef830b (patch)
tree4e05c08e72dc19478d7ac484445d65a7ad78cb71 /lib
parent7ed257191b65d7185a5847a21d14aaa7948e2104 (diff)
downloadlz4-04ec09269645760604974980bce5b9df13ef830b.zip
lz4-04ec09269645760604974980bce5b9df13ef830b.tar.gz
lz4-04ec09269645760604974980bce5b9df13ef830b.tar.bz2
updated comments on block sizes
Diffstat (limited to 'lib')
-rw-r--r--lib/lz4frame.h10
1 files changed, 8 insertions, 2 deletions
diff --git a/lib/lz4frame.h b/lib/lz4frame.h
index 82fbeab..9d9fe89 100644
--- a/lib/lz4frame.h
+++ b/lib/lz4frame.h
@@ -91,8 +91,8 @@ LZ4FLIB_API const char* LZ4F_getErrorName(LZ4F_errorCode_t code); /**< return
/*-************************************
-* Frame compression types
-**************************************/
+ * Frame compression types
+ **************************************/
/* #define LZ4F_DISABLE_OBSOLETE_ENUMS */ /* uncomment to disable obsolete enums */
#ifndef LZ4F_DISABLE_OBSOLETE_ENUMS
# define LZ4F_OBSOLETE_ENUM(x) , LZ4F_DEPRECATE(x) = LZ4F_##x
@@ -100,6 +100,9 @@ LZ4FLIB_API const char* LZ4F_getErrorName(LZ4F_errorCode_t code); /**< return
# define LZ4F_OBSOLETE_ENUM(x)
#endif
+/* The larger the block size, the (slightly) better the compression ratio,
+ * though there are diminishing returns.
+ * Larger blocks also increase memory usage on both compression and decompression sides. */
typedef enum {
LZ4F_default=0,
LZ4F_max64KB=4,
@@ -112,6 +115,9 @@ typedef enum {
LZ4F_OBSOLETE_ENUM(max4MB)
} LZ4F_blockSizeID_t;
+/* Linked blocks sharply reduce inefficiencies when using small blocks,
+ * they compress better.
+ * However, some LZ4 decoders are only compatible with independent blocks */
typedef enum {
LZ4F_blockLinked=0,
LZ4F_blockIndependent