Adding upstream version 1.4~pre1.upstream/1.4_pre1

Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>

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