diff options
Diffstat (limited to 'doc/plzip.texi')
| -rw-r--r-- | doc/plzip.texi | 35 |
1 files changed, 25 insertions, 10 deletions
diff --git a/doc/plzip.texi b/doc/plzip.texi index 64b608c..1c2d42c 100644 --- a/doc/plzip.texi +++ b/doc/plzip.texi @@ -6,8 +6,8 @@ @finalout @c %**end of header -@set UPDATED 22 January 2015 -@set VERSION 1.3 +@set UPDATED 25 February 2015 +@set VERSION 1.4-pre1 @dircategory Data Compression @direntry @@ -142,7 +142,7 @@ compressed files is also supported. WARNING! Even if plzip is bug-free, other causes may result in a corrupt compressed file (bugs in the system libraries, memory errors, etc). -Therefore, if the data you are going to compress is important, give the +Therefore, if the data you are going to compress are important, give the @samp{--keep} option to plzip and do not remove the original file until you verify the compressed file with a command like @w{@samp{plzip -cd file.lz | cmp file -}}. @@ -210,8 +210,9 @@ Print the version number of plzip on the standard output and exit. Set the size of the input data blocks, in bytes. The input file will be divided in chunks of this size before compression is performed. Valid values range from 8 KiB to 1 GiB. Default value is two times the -dictionary size. Plzip will reduce the dictionary size if it is larger -than the chosen data size. +dictionary size, except for option @samp{-0} where it defaults to 1 MiB. +Plzip will reduce the dictionary size if it is larger than the chosen +data size. @item -c @itemx --stdout @@ -290,10 +291,10 @@ When decompressing or testing, further -v's (up to 4) increase the verbosity level, showing status, compression ratio, dictionary size, decompressed size, and compressed size. -@item -1 .. -9 +@item -0 .. -9 Set the compression parameters (dictionary size and match length limit) as shown in the table below. Note that @samp{-9} can be much slower than -@samp{-1}. These options have no effect when decompressing. +@samp{-0}. These options have no effect when decompressing. The bidimensional parameter space of LZMA can't be mapped to a linear scale optimal for all files. If your files are large, very repetitive, @@ -303,6 +304,7 @@ performance. @multitable {Level} {Dictionary size} {Match length limit} @item Level @tab Dictionary size @tab Match length limit +@item -0 @tab 64 KiB @tab 16 bytes @item -1 @tab 1 MiB @tab 5 bytes @item -2 @tab 1.5 MiB @tab 6 bytes @item -3 @tab 2 MiB @tab 8 bytes @@ -403,8 +405,16 @@ 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. @item Lzma stream -The lzma stream, finished by an end of stream marker. Uses default values -for encoder properties. See the lzip manual for a full description. +The lzma stream, finished by an end of stream marker. Uses default +values for encoder properties. +@ifnothtml +@xref{Stream format,,,lzip}, +@end ifnothtml +@ifhtml +See +@uref{http://www.nongnu.org/lzip/manual/lzip_manual.html#Stream-format,,Stream format} +@end ifhtml +for a complete description. @item CRC32 (4 bytes) CRC of the uncompressed original data. @@ -429,10 +439,14 @@ following: @itemize @bullet @item -For compression; 11 times the dictionary size plus 3 times the data size +For compression at level -0; 1.5 MiB plus 3 times the data size (@pxref{--data-size}). @item +For compression at other levels; 11 times the dictionary size plus 3 +times the data size. + +@item For decompression of a regular (seekable) file to another regular file, or for testing of a regular file; the dictionary size. Note that regular files with more than 1024 bytes of trailing garbage are treated as @@ -475,6 +489,7 @@ data size for each level: @multitable {Processors} {512 MiB} {512 MiB} {512 MiB} {512 MiB} {512 MiB} {512 MiB} @headitem Processors @tab 2 @tab 4 @tab 8 @tab 16 @tab 64 @tab 256 @item Level +@item -0 @tab 2 MiB @tab 4 MiB @tab 8 MiB @tab 16 MiB @tab 64 MiB @tab 256 MiB @item -1 @tab 4 MiB @tab 8 MiB @tab 16 MiB @tab 32 MiB @tab 128 MiB @tab 512 MiB @item -2 @tab 6 MiB @tab 12 MiB @tab 24 MiB @tab 48 MiB @tab 192 MiB @tab 768 MiB @item -3 @tab 8 MiB @tab 16 MiB @tab 32 MiB @tab 64 MiB @tab 256 MiB @tab 1 GiB |