Merging upstream version 0.8.

Signed-off-by: Daniel Baumann <daniel@debian.org>

doc/plzip.info

@@ -12,7 +12,7 @@ File: plzip.info,  Node: Top,  Next: Introduction,  Up: (dir)
 Plzip Manual
 ************
 
-This manual is for Plzip (version 0.7, 3 December 2010).
+This manual is for Plzip (version 0.8, 17 January 2012).
 
 * Menu:
 
@@ -24,7 +24,7 @@ This manual is for Plzip (version 0.7, 3 December 2010).
 * Concept Index::       Index of concepts
 
 
-   Copyright (C) 2009, 2010 Antonio Diaz Diaz.
+   Copyright (C) 2009, 2010, 2011, 2012 Antonio Diaz Diaz.
 
    This manual is free documentation: you have unlimited permission to
 copy, distribute and modify it.
@@ -39,7 +39,7 @@ Plzip is a massively parallel (multi-threaded), lossless data compressor
 based on the lzlib compression library, with very safe integrity
 checking and a user interface similar to the one of bzip2, gzip or lzip.
 Plzip uses the lzip file format; the files produced by plzip are fully
-compatible with lzip-1.4 or newer.
+compatible with lzip-1.4 or newer, and can be rescued with lziprecover.
 
    Plzip is intended for faster compression/decompression of big files
 on multiprocessor machines, which makes it specially well suited for
@@ -106,8 +106,8 @@ The format for running plzip is:
 `--version'
      Print the version number of plzip on the standard output and exit.
 
-`-B'
-`--data-size=SIZE'
+`-B BYTES'
+`--data-size=BYTES'
      Set the input data block size in bytes. The input file will be
      divided in chunks of this size before compression is performed.
      Valid values range from 8KiB to 1GiB. Default value is two times
@@ -125,21 +125,27 @@ The format for running plzip is:
 
 `-f'
 `--force'
-     Force overwrite of output file.
+     Force overwrite of output files.
+
+`-F'
+`--recompress'
+     Force recompression of files whose name already has the `.lz' or
+     `.tlz' suffix.
 
 `-k'
 `--keep'
      Keep (don't delete) input files during compression or
      decompression.
 
-`-m LENGTH'
-`--match-length=LENGTH'
-     Set the match length limit in bytes. Valid values range from 5 to
-     273.  Larger values usually give better compression ratios but
-     longer compression times.
+`-m BYTES'
+`--match-length=BYTES'
+     Set the match length limit in bytes. After a match this long is
+     found, the search is finished. Valid values range from 5 to 273.
+     Larger values usually give better compression ratios but longer
+     compression times.
 
-`-n THREADS'
-`--threads=THREADS'
+`-n N'
+`--threads=N'
      Set the number of worker threads. Valid values range from 1 to "as
      many as your system can support". If this option is not used,
      plzip tries to detect the number of processors in the system and
@@ -156,24 +162,35 @@ The format for running plzip is:
 `--quiet'
      Quiet operation. Suppress all messages.
 
-`-s SIZE'
-`--dictionary-size=SIZE'
+`-s BYTES'
+`--dictionary-size=BYTES'
      Set the dictionary size limit in bytes. Valid values range from
-     4KiB to 512MiB. Note that dictionary sizes are quantized. If the
-     specified size does not match one of the valid sizes, it will be
-     rounded upwards.
+     4KiB to 512MiB. Plzip will use the smallest possible dictionary
+     size for each member without exceeding this limit. Note that
+     dictionary sizes are quantized. If the specified size does not
+     match one of the valid sizes, it will be rounded upwards by adding
+     up to (BYTES / 16) to it.
+
+     For maximum compression you should use a dictionary size limit as
+     large as possible, but keep in mind that the decompression memory
+     requirement is affected at compression time by the choice of
+     dictionary size limit.
 
 `-t'
 `--test'
      Check integrity of the specified file(s), but don't decompress
      them.  This really performs a trial decompression and throws away
-     the result.  Use `-tvv' or `-tvvv' to see information about the
-     file.
+     the result.  Use it together with `-v' to see information about
+     the file.
 
 `-v'
 `--verbose'
-     Verbose mode. Show the compression ratio for each file processed.
-     Further -v's increase the verbosity level.
+     Verbose mode.
+     When compressing, show the compression ratio for each file
+     processed.
+     When decompressing or testing, further -v's (up to 4) increase the
+     verbosity level, showing status, compression ratio, decompressed
+     size, and compressed size.
 
 `-1 .. -9'
      Set the compression parameters (dictionary size and match length
@@ -265,13 +282,13 @@ additional information before, between, or after them.
    All multibyte values are stored in little endian order.
 
 `ID string'
-     A four byte string, identifying the member type, with the value
+     A four byte string, identifying the lzip format, with the value
      "LZIP".
 
 `VN (version number, 1 byte)'
      Just in case something needs to be modified in the future. Valid
-     values are 0 and 1. Version 0 files have only one member and lack
-     `Member size'.
+     values are 0 and 1. Version 0 files are deprecated. They can
+     contain only one member and lack the `Member size' field.
 
 `DS (coded dictionary size, 1 byte)'
      Bits 4-0 contain the base 2 logarithm of the base dictionary size.
@@ -292,7 +309,7 @@ additional information before, between, or after them.
 
 `Member size (8 bytes)'
      Total size of the member, including header and trailer. This
-     facilitates safe recovery of undamaged members from multimember
+     facilitates safe recovery of undamaged members from multi-member
      files.
 
 
@@ -334,11 +351,16 @@ Concept Index
 
 Tag Table:
 Node: Top223
-Node: Introduction833
-Node: Invoking Plzip3592
-Node: Program Design7840
-Node: File Format8502
-Node: Problems10458
-Node: Concept Index10987
+Node: Introduction845
+Node: Invoking Plzip3641
+Node: Program Design8597
+Node: File Format9259
+Node: Problems11254
+Node: Concept Index11783
 
 End Tag Table
+
+
+Local Variables:
+coding: iso-8859-15
+End: