Update XZ Utils to 5.0.5

src/xz/xz.1

 '\" t
 .\"
 .\" Author: Lasse Collin
 .\"
 .\" This file has been put into the public domain.
 .\" You can do whatever you want with this file.
 .\"
-.TH XZ 1 "2012-05-27" "Tukaani" "XZ Utils"
+.TH XZ 1 "2013-06-21" "Tukaani" "XZ Utils"
 .
 .SH NAME
 xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files
 .
 .SH SYNOPSIS
 .B xz
-.RI [ option ]...
-.RI [ file ]...
-.PP
+.RI [ option... ]
+.RI [ file... ]
+.
+.SH COMMAND ALIASES
 .B unxz
 is equivalent to
 .BR "xz \-\-decompress" .
 .br
 .B xzcat
 is equivalent to
 .BR "xz \-\-decompress \-\-stdout" .
 .br
 .B lzma
 is equivalent to
@@ skipping 673 matching lines @@
 in the single-threaded mode.
 It may vary slightly between
 .B xz
 versions.
 Memory requirements of some of the future multithreaded modes may
 be dramatically higher than that of the single-threaded mode.
 .IP \(bu 3
 DecMem contains the decompressor memory requirements.
 That is, the compression settings determine
 the memory requirements of the decompressor.
-The exact decompressor memory usage is slighly more than
+The exact decompressor memory usage is slightly more than
 the LZMA2 dictionary size, but the values in the table
 have been rounded up to the next full MiB.
 .RE
 .TP
 .BR \-e ", " \-\-extreme
 Use a slower variant of the selected compression preset level
 .RB ( \-0 " ... " \-9 )
 to hopefully get a little bit better compression ratio,
 but with bad luck this can also make it worse.
 Decompressor memory usage is not affected,
@@ skipping 168 matching lines @@
 will increase the memory usage dramatically.
 Note that if multithreading will be the default,
 it will probably be done so that single-threaded and
 multithreaded modes produce the same output,
 so compression ratio won't be significantly affected
 if threading will be enabled by default.
 .
 .SS "Custom compressor filter chains"
 A custom filter chain allows specifying
 the compression settings in detail instead of relying on
-the settings associated to the preset levels.
+the settings associated to the presets.
 When a custom filter chain is specified,
-the compression preset level options
-(\fB\-0\fR ... \fB\-9\fR and \fB\-\-extreme\fR) are
-silently ignored.
+preset options (\fB\-0\fR ... \fB\-9\fR and \fB\-\-extreme\fR)
+earlier on the command line are forgotten.
+If a preset option is specified
+after one or more custom filter chain options,
+the new preset takes effect and
+the custom filter chain options specified earlier are forgotten.
 .PP
 A filter chain is comparable to piping on the command line.
 When compressing, the uncompressed input goes to the first filter,
 whose output goes to the next filter (if any).
 The output of the last filter gets written to the compressed file.
 The maximum number of filters in the chain is four,
 but typically a filter chain has only one or two filters.
 .PP
 Many filters have limitations on where they can be
 in the filter chain:
@@ skipping 12 matching lines @@
 it was specified when compressing.
 .PP
 Filters take filter-specific
 .I options
 as a comma-separated list.
 Extra commas in
 .I options
 are ignored.
 Every option has a default value, so you need to
 specify only those you want to change.
+.PP
+To see the whole filter chain and
+.IR options ,
+use
+.B "xz \-vv"
+(that is, use
+.B \-\-verbose
+twice).
+This works also for viewing the filter chain options used by presets.
 .TP
 \fB\-\-lzma1\fR[\fB=\fIoptions\fR]
 .PD 0
 .TP
 \fB\-\-lzma2\fR[\fB=\fIoptions\fR]
 .PD
 Add LZMA1 or LZMA2 filter to the filter chain.
 These filters can be used only as the last filter in the chain.
 .IP ""
 LZMA1 is a legacy filter,
@@ skipping 22 matching lines @@
 preset modifiers.
 The integer can be from
 .B 0
 to
 .BR 9 ,
 matching the command line options \fB\-0\fR ... \fB\-9\fR.
 The only supported modifier is currently
 .BR e ,
 which matches
 .BR \-\-extreme .
-The default
-.I preset
-is
-.BR 6 ,
-from which the default values for the rest of the LZMA1 or LZMA2
+If no
+.B preset
+is specified, the default values of LZMA1 or LZMA2
 .I options
-are taken.
+are taken from the preset
+.BR 6 .
 .TP
 .BI dict= size
 Dictionary (history buffer)
 .I size
 indicates how many bytes of the recently processed
 uncompressed data is kept in memory.
 The algorithm tries to find repeating byte sequences (matches) in
 the uncompressed data, and replace them with references
 to the data currently in the dictionary.
 The bigger the dictionary, the higher is the chance
@@ skipping 575 matching lines @@
 It makes the output of
 .B xz
 easier to parse by other programs.
 Currently
 .B \-\-robot
 is supported only together with
 .BR \-\-version ,
 .BR \-\-info\-memory ,
 and
 .BR \-\-list .
-It will be supported for normal compression and
+It will be supported for compression and
 decompression in the future.
 .
 .SS Version
 .B "xz \-\-robot \-\-version"
 will print the version number of
 .B xz
 and liblzma in the following format:
 .PP
 .BI XZ_VERSION= XYYYZZZS
 .br
@@ skipping 580 matching lines @@
 the same uncompressed input file
 may vary between XZ Utils versions even if
 compression options are identical.
 This is because the encoder can be improved
 (faster or better compression)
 without affecting the file format.
 The output can vary even between different
 builds of the same XZ Utils version,
 if different build options are used.
 .PP
-The above means that implementing
+The above means that once
 .B \-\-rsyncable
-to create rsyncable
-.B .xz
-files is not going to happen without
-freezing a part of the encoder
-implementation, which can then be used with
-.BR \-\-rsyncable .
+has been implemented,
+the resulting files won't necessarily be rsyncable
+unless both old and new files have been compressed
+with the same xz version.
+This problem can be fixed if a part of the encoder
+implementation is frozen to keep rsyncable output
+stable across xz versions.
 .
 .SS "Embedded .xz decompressors"
 Embedded
 .B .xz
 decompressor implementations like XZ Embedded don't necessarily
 support files created with integrity
 .I check
 types other than
 .B none
 and
@@ skipping 377 matching lines @@
 .BR xzmore (1),
 .BR gzip (1),
 .BR bzip2 (1),
 .BR 7z (1)
 .PP
 XZ Utils: <http://tukaani.org/xz/>
 .br
 XZ Embedded: <http://tukaani.org/xz/embedded.html>
 .br
 LZMA SDK: <http://7-zip.org/sdk.html>