From 5a87b49919eeb1c5931666b4f1a0350ae2abad3e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 7 Nov 2015 16:54:05 +0100 Subject: Merging upstream version 1.4~rc1. Signed-off-by: Daniel Baumann --- doc/plzip.texi | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) (limited to 'doc/plzip.texi') diff --git a/doc/plzip.texi b/doc/plzip.texi index 1c2d42c..b501b9a 100644 --- a/doc/plzip.texi +++ b/doc/plzip.texi @@ -6,8 +6,8 @@ @finalout @c %**end of header -@set UPDATED 25 February 2015 -@set VERSION 1.4-pre1 +@set UPDATED 23 May 2015 +@set VERSION 1.4-rc1 @dircategory Data Compression @direntry @@ -195,7 +195,7 @@ plzip [@var{options}] [@var{files}] Plzip supports the following options: -@table @samp +@table @code @item -h @itemx --help Print an informative help message describing the options and exit. @@ -394,13 +394,12 @@ A four byte string, identifying the lzip format, with the value "LZIP" Just in case something needs to be modified in the future. 1 for now. @item DS (coded dictionary size, 1 byte) -Lzip divides the distance between any two powers of 2 into 8 equally -spaced intervals, named "wedges". The dictionary size is calculated by -taking a power of 2 (the base size) and substracting from it a number of -wedges between 0 and 7. The size of a wedge is (base_size / 16).@* +The dictionary size is calculated by taking a power of 2 (the base size) +and substracting from it a fraction between 0/16 and 7/16 of the base +size.@* Bits 4-0 contain the base 2 logarithm of the base size (12 to 29).@* -Bits 7-5 contain the number of wedges (0 to 7) to substract from the -base size to obtain the dictionary size.@* +Bits 7-5 contain the numerator of the fraction (0 to 7) to substract +from the base size to obtain the dictionary size.@* Example: 0xD3 = 2^19 - 6 * 2^15 = 512 KiB - 6 * 32 KiB = 320 KiB@* Valid values for dictionary size range from 4 KiB to 512 MiB. @@ -440,11 +439,11 @@ following: @itemize @bullet @item For compression at level -0; 1.5 MiB plus 3 times the data size -(@pxref{--data-size}). +(@pxref{--data-size}). About 4.5 MiB. @item For compression at other levels; 11 times the dictionary size plus 3 -times the data size. +times the data size. Default is 136 MiB. @item For decompression of a regular (seekable) file to another regular file, -- cgit v1.2.3