summaryrefslogtreecommitdiffstats
path: root/doc/lz4_manual.html
diff options
context:
space:
mode:
authorYann Collet <Cyan4973@users.noreply.github.com>2019-04-11 22:43:40 (GMT)
committerGitHub <noreply@github.com>2019-04-11 22:43:40 (GMT)
commit780aac520b69d6369f4e3995624c37e56d75498d (patch)
tree7b192662cba336b688b23ea04fcd6f48cbb3fc48 /doc/lz4_manual.html
parent723ba904e2393c69d01f6730bd8b4171e6182845 (diff)
parentbcb26565a732062759a2428e167e27ad3c2f6e96 (diff)
downloadlz4-780aac520b69d6369f4e3995624c37e56d75498d.zip
lz4-780aac520b69d6369f4e3995624c37e56d75498d.tar.gz
lz4-780aac520b69d6369f4e3995624c37e56d75498d.tar.bz2
Merge pull request #665 from lz4/dict
Dictionary compression
Diffstat (limited to 'doc/lz4_manual.html')
-rw-r--r--doc/lz4_manual.html11
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/lz4_manual.html b/doc/lz4_manual.html
index ef1a8b5..4cd21fc 100644
--- a/doc/lz4_manual.html
+++ b/doc/lz4_manual.html
@@ -180,10 +180,15 @@ int LZ4_compress_fast_extState (void* state, const char* src, char* dst, int src
</p></pre><BR>
<pre><b>int LZ4_loadDict (LZ4_stream_t* streamPtr, const char* dictionary, int dictSize);
-</b><p> Use this function to load a static dictionary into LZ4_stream_t.
- Any previous data will be forgotten, only 'dictionary' will remain in memory.
+</b><p> Use this function to reference a static dictionary into LZ4_stream_t.
+ The dictionary must remain available during compression.
+ LZ4_loadDict() triggers a reset, so any previous data will be forgotten.
+ The same dictionary will have to be loaded on decompression side for successful decoding.
+ Dictionary are useful for better compression of small data (KB range).
+ While LZ4 accept any input as dictionary,
+ results are generally better when using Zstandard's Dictionary Builder.
Loading a size of 0 is allowed, and is the same as reset.
- @return : dictionary size, in bytes (necessarily <= 64 KB)
+ @return : loaded dictionary size, in bytes (necessarily <= 64 KB)
</p></pre><BR>