Merging upstream version 0.6.

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

doc/plzip.info

@@ -12,12 +12,13 @@ File: plzip.info,  Node: Top,  Next: Introduction,  Up: (dir)
 Plzip Manual
 ************
 
-This manual is for Plzip (version 0.5, 10 February 2010).
+This manual is for Plzip (version 0.6, 20 March 2010).
 
 * Menu:
 
 * Introduction::	Purpose and features of plzip
 * Invoking Plzip::	Command line interface
+* Program Design::	Internal structure of plzip
 * File Format::		Detailed format of the compressed file
 * Problems::		Reporting bugs
 * Concept Index::	Index of concepts
@@ -86,7 +87,7 @@ corrupt or invalid input file, 3 for an internal consistency error (eg,
 bug) which caused plzip to panic.
 
 
-File: plzip.info,  Node: Invoking Plzip,  Next: File Format,  Prev: Introduction,  Up: Top
+File: plzip.info,  Node: Invoking Plzip,  Next: Program Design,  Prev: Introduction,  Up: Top
 
 2 Invoking Plzip
 ****************
@@ -110,8 +111,8 @@ The format for running plzip is:
      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
-     the dictionary size.  It is a waste of memory to choose a data
-     size smaller than the dictionary size.
+     the dictionary size.  Plzip will reduce the dictionary size if it
+     is larger than the chosen data size.
 
 `--stdout'
 `-c'
@@ -137,6 +138,13 @@ The format for running plzip is:
      273.  Larger values usually give better compression ratios but
      longer compression times.
 
+`--threads=THREADS'
+`-n THREADS'
+     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
+     use it as default value.
+
 `--output=FILE'
 `-o FILE'
      When reading from standard input and `--stdout' has not been
@@ -173,15 +181,15 @@ The format for running plzip is:
      slower than `-1'. These options have no effect when decompressing.
 
      Level   Dictionary size   Match length limit
-     -1      1MiB              10 bytes
-     -2      1MiB              12 bytes
-     -3      1MiB              17 bytes
-     -4      2MiB              26 bytes
-     -5      4MiB              44 bytes
-     -6      8MiB              80 bytes
-     -7      16MiB             108 bytes
-     -8      16MiB             163 bytes
-     -9      32MiB             273 bytes
+     -1      1 MiB             10 bytes
+     -2      1.5 MiB           12 bytes
+     -3      2 MiB             17 bytes
+     -4      3 MiB             26 bytes
+     -5      4 MiB             44 bytes
+     -6      8 MiB             80 bytes
+     -7      16 MiB            108 bytes
+     -8      24 MiB            163 bytes
+     -9      32 MiB            273 bytes
 
 `--fast'
 `--best'
@@ -205,9 +213,25 @@ Z        zettabyte (10^21)         |   Zi       zebibyte (2^70)
 Y        yottabyte (10^24)         |   Yi       yobibyte (2^80)
 
 
-File: plzip.info,  Node: File Format,  Next: Problems,  Prev: Invoking Plzip,  Up: Top
+File: plzip.info,  Node: Program Design,  Next: File Format,  Prev: Invoking Plzip,  Up: Top
 
-3 File Format
+3 Program Design
+****************
+
+For each input file, a splitter thread and several worker threads are
+created, acting the main thread as muxer (multiplexer) thread. A "packet
+courier" takes care of data transfers among threads and limits the
+maximum number of data blocks (packets) being processed simultaneously.
+
+   The splitter reads data blocks from the input file, and distributes
+them to the workers. The workers (de)compress the blocks received from
+the splitter. The muxer collects processed packets from the workers, and
+writes them to the output file.
+
+
+File: plzip.info,  Node: File Format,  Next: Problems,  Prev: Program Design,  Up: Top
+
+4 File Format
 *************
 
 In the diagram below, a box like this:
@@ -269,7 +293,7 @@ additional information before, between, or after them.
 
 File: plzip.info,  Node: Problems,  Next: Concept Index,  Prev: File Format,  Up: Top
 
-4 Reporting Bugs
+5 Reporting Bugs
 ****************
 
 There are probably bugs in plzip. There are certainly errors and
@@ -296,6 +320,7 @@ Concept Index
 * introduction:                          Introduction.          (line 6)
 * invoking:                              Invoking Plzip.        (line 6)
 * options:                               Invoking Plzip.        (line 6)
+* program design:                        Program Design.        (line 6)
 * usage:                                 Invoking Plzip.        (line 6)
 * version:                               Invoking Plzip.        (line 6)
 
@@ -303,10 +328,11 @@ Concept Index
 
 Tag Table:
 Node: Top223
-Node: Introduction747
-Node: Invoking Plzip3489
-Node: File Format7178
-Node: Problems9134
-Node: Concept Index9663
+Node: Introduction791
+Node: Invoking Plzip3533
+Node: Program Design7499
+Node: File Format8161
+Node: Problems10117
+Node: Concept Index10646
 
 End Tag Table