summaryrefslogtreecommitdiffstats
path: root/doc/plzip.texinfo
diff options
context:
space:
mode:
authorDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 15:35:56 +0000
committerDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 15:35:56 +0000
commit68e0e5c64ebe512f6b2e48893763ab38879ed84e (patch)
treeeaf9638c29d1039bf9adcda8f9aa669291e208f3 /doc/plzip.texinfo
parentAdding debian version 1.1~pre1-1. (diff)
downloadplzip-68e0e5c64ebe512f6b2e48893763ab38879ed84e.tar.xz
plzip-68e0e5c64ebe512f6b2e48893763ab38879ed84e.zip
Merging upstream version 1.1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
Diffstat (limited to 'doc/plzip.texinfo')
-rw-r--r--doc/plzip.texinfo27
1 files changed, 14 insertions, 13 deletions
diff --git a/doc/plzip.texinfo b/doc/plzip.texinfo
index c3b0613..0370677 100644
--- a/doc/plzip.texinfo
+++ b/doc/plzip.texinfo
@@ -6,8 +6,8 @@
@finalout
@c %**end of header
-@set UPDATED 20 July 2013
-@set VERSION 1.1-pre1
+@set UPDATED 17 September 2013
+@set VERSION 1.1
@dircategory Data Compression
@direntry
@@ -173,9 +173,9 @@ Print the version number of plzip on the standard output and exit.
@itemx --data-size=@var{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 the dictionary size.
-Plzip will reduce the dictionary size if it is larger than the chosen
-data size.
+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.
@item -c
@itemx --stdout
@@ -225,8 +225,8 @@ Quiet operation. Suppress all messages.
@item -s @var{bytes}
@itemx --dictionary-size=@var{bytes}
-Set the dictionary size limit in bytes. Valid values range from 4KiB to
-512MiB. Plzip will use the smallest possible dictionary size for each
+Set the dictionary size limit in bytes. Valid values range from 4 KiB to
+512 MiB. 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 (@var{bytes} / 16) to it.
@@ -259,7 +259,8 @@ 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,
etc, you may need to use the @samp{--match-length} and
@samp{--dictionary-size} options directly to achieve optimal
-performance.
+performance. For example, @samp{-9m64} usually compresses executables
+more (and faster) than @samp{-9}.
@multitable {Level} {Dictionary size} {Match length limit}
@item Level @tab Dictionary size @tab Match length limit
@@ -280,7 +281,6 @@ Aliases for GNU gzip compatibility.
@end table
-@sp 1
Numbers given as arguments to options may be followed by a multiplier
and an optional @samp{B} for "byte".
@@ -346,7 +346,8 @@ All multibyte values are stored in little endian order.
@table @samp
@item ID string
-A four byte string, identifying the lzip format, with the value "LZIP".
+A four byte string, identifying the lzip format, with the value "LZIP"
+(0x4C, 0x5A, 0x49, 0x50).
@item VN (version number, 1 byte)
Just in case something needs to be modified in the future. 1 for now.
@@ -359,8 +360,8 @@ wedges between 0 and 7. The size of a wedge is (base_size / 16).@*
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.@*
-Example: 0xD3 = (2^19 - 6 * 2^15) = (512KiB - 6 * 32KiB) = 320KiB@*
-Valid values for dictionary size range from 4KiB to 512MiB.
+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
@@ -381,7 +382,7 @@ facilitates safe recovery of undamaged members from multi-member files.
@node Problems
-@chapter Reporting Bugs
+@chapter Reporting bugs
@cindex bugs
@cindex getting help