From 617fef6e3263635140c635645e6a5bccf643b8c8 Mon Sep 17 00:00:00 2001 From: Jonathan Dieter Date: Mon, 19 Apr 2021 21:19:49 +0100 Subject: [PATCH] Clean up phrasing to hopefully make it more clear that zdicts are optional Signed-off-by: Jonathan Dieter --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 9244aa4..3b9c360 100644 --- a/README.md +++ b/README.md @@ -53,10 +53,12 @@ zck_read_header ## Zchunk dictionaries -If you're creating a zchunk file that has any repetitive data, you may be -able to reduce the file size by using a [zstd dictionary](https://facebook.github.io/zstd/#small-data). -The dictionary is stored as extra data in chunk 0, but is used as a starting -point for compressing each chunk, which can give a significant overall savings. +By default, each chunk in a zchunk file is compressed independently. However, +if you're creating a zchunk file that has any repetitive data, you may +be able to reduce the overall file size by using a [zstd dictionary](https://facebook.github.io/zstd/#small-data). +The dictionary takes up extra space at the beginning of the zchunk file, but is +used as an identical initial dictionary for compressing each chunk, which can +give a significant overall savings. It is important that all further revisions of the zchunk file use the same dictionary. If the dictionary changes, none of the chunks will match from the -- 2.30.2