Some updates to xz man page.

This commit is contained in:
Lasse Collin 2009-11-14 20:20:03 +02:00
parent 19b2674f07
commit 2ddcae247c
1 changed files with 49 additions and 5 deletions

View File

@ -5,7 +5,7 @@
.\" This file has been put into the public domain. .\" This file has been put into the public domain.
.\" You can do whatever you want with this file. .\" You can do whatever you want with this file.
.\" .\"
.TH XZ 1 "2009-08-27" "Tukaani" "XZ Utils" .TH XZ 1 "2009-11-14" "Tukaani" "XZ Utils"
.SH NAME .SH NAME
xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files
.SH SYNOPSIS .SH SYNOPSIS
@ -369,8 +369,11 @@ Read the filenames to process from
if if
.I file .I file
is omitted, filenames are read from standard input. Filenames must be is omitted, filenames are read from standard input. Filenames must be
terminated with the newline character. If filenames are given also as terminated with the newline character. A dash
command line arguments, they are processed before the filenames read from .RB ( \- )
is taken as a regular filename; it doesn't mean standard input.
If filenames are given also as command line arguments, they are
processed before the filenames read from
.IR file . .IR file .
.TP .TP
\fB\-\-files0\fR[\fB=\fIfile\fR] \fB\-\-files0\fR[\fB=\fIfile\fR]
@ -996,6 +999,48 @@ will display a progress indicator.
Specifying Specifying
.B \-\-verbose .B \-\-verbose
twice will give even more verbose output (useful mostly for debugging). twice will give even more verbose output (useful mostly for debugging).
.IP
The progress indicator shows the following information:
.RS
.IP \(bu 3
Completion percentage is shown if the size of the input file is known.
That is, percentage cannot be shown in pipes.
.IP \(bu 3
Amount of compressed data produced (compressing) or consumed (decompressing).
.IP \(bu 3
Amount of uncompressed data consumed (compressing) or produced
(decompressing).
.IP \(bu 3
Compression ratio, which is calculated by dividing the amount of
compressed data processed so far by the amount of uncompressed data
processed so far.
.IP \(bu 3
Compression or decompression speed. This is measured as the amount of
uncompressed data consumed (compression) or produced (decompression)
per second. It is shown once a few seconds have passed since
.B xz
started processing the file.
.IP \(bu 3
Elapsed time or estimated time remaining.
Elapsed time is displayed in the format M:SS or H:MM:SS.
The estimated remaining time is displayed in a less precise format
which never has colons, for example, 2 min 30 s. The estimate can
be shown only when the size of the input file is known and a couple of
seconds have already passed since
.B xz
started processing the file.
.RE
.IP
When standard error is not a terminal,
.B \-\-verbose
will make
.B xz
print the filename, compressed size, uncompressed size, compression ratio,
speed, and elapsed time on a single line to standard error after
compressing or decompressing the file. If operating took at least a few
seconds, also the speed and elapsed time are printed. If the operation
didn't finish, for example due to user interruption, also the completion
percentage is printed if the size of the input file is known.
.TP .TP
.BR \-Q ", " \-\-no\-warn .BR \-Q ", " \-\-no\-warn
Don't set the exit status to Don't set the exit status to
@ -1202,8 +1247,7 @@ The exact compressed output produced from the same uncompressed input file
may vary between XZ Utils versions even if compression options are identical. may vary between XZ Utils versions even if compression options are identical.
This is because the encoder can be improved (faster or better compression) This is because the encoder can be improved (faster or better compression)
without affecting the file format. The output can vary even between different 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 or builds of the same XZ Utils version, if different build options are used.
if the endianness of the hardware is different for different builds.
.PP .PP
The above means that implementing The above means that implementing
.B \-\-rsyncable .B \-\-rsyncable