Merging upstream version 1.4.
Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
parent
0fcc2a9007
commit
799d754a32
18 changed files with 115 additions and 119 deletions
doc
|
@ -12,7 +12,7 @@ File: zutils.info, Node: Top, Next: Introduction, Up: (dir)
|
|||
Zutils Manual
|
||||
*************
|
||||
|
||||
This manual is for Zutils (version 1.4-pre2, 30 April 2015).
|
||||
This manual is for Zutils (version 1.4, 29 May 2015).
|
||||
|
||||
* Menu:
|
||||
|
||||
|
@ -54,8 +54,8 @@ The provided utilities are zcat, zcmp, zdiff, zgrep, ztest and zupdate.
|
|||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
The compressor to be used for each format is configurable at runtime.
|
||||
|
||||
Zcat, zcmp, zdiff, and zgrep are improved replacements for the shell
|
||||
scripts provided by GNU gzip. Ztest is unique to zutils. Zupdate is
|
||||
zcat, zcmp, zdiff, and zgrep are improved replacements for the shell
|
||||
scripts provided by GNU gzip. ztest is unique to zutils. zupdate is
|
||||
similar to gzip's znew.
|
||||
|
||||
NOTE: Bzip2 and lzip provide well-defined values of exit status,
|
||||
|
@ -63,14 +63,14 @@ which makes them safe to use with zutils. Gzip and xz may return
|
|||
ambiguous warning values, making them less reliable back ends for
|
||||
zutils. *Note compressor-requirements::.
|
||||
|
||||
FORMAT NOTE: The "-format" option allows the processing of a subset
|
||||
FORMAT NOTE: The '--format' option allows the processing of a subset
|
||||
of formats in search and recursive modes:
|
||||
'zgrep foo -r --format=bz2,lz somedir'.
|
||||
|
||||
FORMAT NOTE 2: If the '--force-format' option is given, the files are
|
||||
passed to the corresponding decompressor without verifying their format,
|
||||
allowing for example the processing of compress'd (.Z) files with gzip:
|
||||
'zcmp --force-format=gz file.Z file.lz'.
|
||||
FORMAT NOTE 2: If the '--force-format' option is given, the files
|
||||
are passed to the corresponding decompressor without verifying their
|
||||
format, allowing for example the processing of compress'd (.Z) files
|
||||
with gzip: 'zcmp --force-format=gz file.Z file.lz'.
|
||||
|
||||
LANGUAGE NOTE: Uncompressed = not compressed = plain data; it may
|
||||
never have been compressed. Decompressed is used to refer to data which
|
||||
|
@ -105,7 +105,7 @@ described here.
|
|||
'-h'
|
||||
'--help'
|
||||
Print an informative help message describing the options and exit.
|
||||
Zgrep only supports the '--help' form of this option.
|
||||
zgrep only supports the '--help' form of this option.
|
||||
|
||||
'-V'
|
||||
'--version'
|
||||
|
@ -113,14 +113,14 @@ described here.
|
|||
|
||||
'-M FORMAT_LIST'
|
||||
'--format=FORMAT_LIST'
|
||||
Exclude formats not listed in the comma-separated FORMAT_LIST.
|
||||
Valid formats are 'bz2', 'gz', 'lz', 'xz' and 'un' for
|
||||
'uncompressed', meaning "any file name without a known extension".
|
||||
This option excludes files based on extension, instead of format,
|
||||
because it is more efficient. The exclusion only applies to names
|
||||
generated automatically (for example when adding extensions to a
|
||||
file name or when operating recursively on directories). Files
|
||||
given in the command line are always processed.
|
||||
Process only the formats listed in the comma-separated
|
||||
FORMAT_LIST. Valid formats are 'bz2', 'gz', 'lz', 'xz' and 'un'
|
||||
for 'uncompressed', meaning "any file name without a known
|
||||
extension". This option excludes files based on extension, instead
|
||||
of format, because it is more efficient. The exclusion only
|
||||
applies to names generated automatically (for example when adding
|
||||
extensions to a file name or when operating recursively on
|
||||
directories). Files given in the command line are always processed.
|
||||
|
||||
Each format in FORMAT_LIST enables file names with the following
|
||||
extensions:
|
||||
|
@ -186,7 +186,7 @@ File: zutils.info, Node: Zcat, Next: Zcmp, Prev: The zutilsrc file, Up: Top
|
|||
4 Zcat
|
||||
******
|
||||
|
||||
Zcat copies each given file ('-' means standard input), to standard
|
||||
zcat copies each given file ('-' means standard input), to standard
|
||||
output. If any given file is compressed, its decompressed content is
|
||||
used. If a given file does not exist, and its name does not end with one
|
||||
of the known extensions, zcat tries the compressed file names
|
||||
|
@ -203,7 +203,7 @@ same compression format.
|
|||
|
||||
Exit status is 0 if no errors occurred, non-zero otherwise.
|
||||
|
||||
Zcat supports the following options:
|
||||
zcat supports the following options:
|
||||
|
||||
'-A'
|
||||
'--show-all'
|
||||
|
@ -269,7 +269,7 @@ File: zutils.info, Node: Zcmp, Next: Zdiff, Prev: Zcat, Up: Top
|
|||
5 Zcmp
|
||||
******
|
||||
|
||||
Zcmp compares two files ('-' means standard input), and if they differ,
|
||||
zcmp compares two files ('-' means standard input), and if they differ,
|
||||
tells the first byte and line number where they differ. Bytes and lines
|
||||
are numbered starting with 1. If any given file is compressed, its
|
||||
decompressed content is used. Compressed files are decompressed on the
|
||||
|
@ -295,7 +295,7 @@ following:
|
|||
An exit status of 0 means no differences were found, 1 means some
|
||||
differences were found, and 2 means trouble.
|
||||
|
||||
Zcmp supports the following options:
|
||||
zcmp supports the following options:
|
||||
|
||||
'-b'
|
||||
'--print-bytes'
|
||||
|
@ -346,9 +346,9 @@ File: zutils.info, Node: Zdiff, Next: Zgrep, Prev: Zcmp, Up: Top
|
|||
6 Zdiff
|
||||
*******
|
||||
|
||||
Zdiff compares two files ('-' means standard input), and if they
|
||||
zdiff compares two files ('-' means standard input), and if they
|
||||
differ, shows the differences line by line. If any given file is
|
||||
compressed, its decompressed content is used. Zdiff is a front end to
|
||||
compressed, its decompressed content is used. zdiff is a front end to
|
||||
the diff program and has the limitation that messages from diff refer to
|
||||
temporary file names instead of those specified.
|
||||
|
||||
|
@ -372,7 +372,7 @@ following:
|
|||
An exit status of 0 means no differences were found, 1 means some
|
||||
differences were found, and 2 means trouble.
|
||||
|
||||
Zdiff supports the following options:
|
||||
zdiff supports the following options:
|
||||
|
||||
'-a'
|
||||
'--text'
|
||||
|
@ -453,7 +453,7 @@ File: zutils.info, Node: Zgrep, Next: Ztest, Prev: Zdiff, Up: Top
|
|||
7 Zgrep
|
||||
*******
|
||||
|
||||
Zgrep is a front end to the grep program that allows transparent search
|
||||
zgrep is a front end to the grep program that allows transparent search
|
||||
on any combination of compressed and uncompressed files. If any given
|
||||
file is compressed, its decompressed content is used. If a given file
|
||||
does not exist, and its name does not end with one of the known
|
||||
|
@ -472,7 +472,7 @@ compression format.
|
|||
An exit status of 0 means at least one match was found, 1 means no
|
||||
matches were found, and 2 means trouble.
|
||||
|
||||
Zgrep supports the following options:
|
||||
zgrep supports the following options:
|
||||
|
||||
'-a'
|
||||
'--text'
|
||||
|
@ -593,7 +593,7 @@ File: zutils.info, Node: Ztest, Next: Zupdate, Prev: Zgrep, Up: Top
|
|||
8 Ztest
|
||||
*******
|
||||
|
||||
Ztest verifies the integrity of the specified compressed files.
|
||||
ztest verifies the integrity of the specified compressed files.
|
||||
Uncompressed files are ignored. If no files are specified, the integrity
|
||||
of compressed data read from standard input is verified. Data read from
|
||||
standard input must be all in the same compression format.
|
||||
|
@ -609,7 +609,7 @@ The exit status is 0 if all compressed files verify OK, 1 if
|
|||
environmental problems (file not found, invalid flags, I/O errors, etc),
|
||||
2 if any compressed file is corrupt or invalid.
|
||||
|
||||
Ztest supports the following options:
|
||||
ztest supports the following options:
|
||||
|
||||
'-O FORMAT'
|
||||
'--force-format=FORMAT'
|
||||
|
@ -641,7 +641,7 @@ File: zutils.info, Node: Zupdate, Next: Problems, Prev: Ztest, Up: Top
|
|||
9 Zupdate
|
||||
*********
|
||||
|
||||
Zupdate recompresses files from bzip2, gzip, and xz formats to lzip
|
||||
zupdate recompresses files from bzip2, gzip, and xz formats to lzip
|
||||
format. The originals are compared with the new files and then deleted.
|
||||
Only regular files with standard file name extensions are recompressed,
|
||||
other files are ignored. Compressed files are decompressed and then
|
||||
|
@ -678,7 +678,7 @@ Exit status is 0 if all the compressed files were successfully
|
|||
recompressed (if needed), compared and deleted (if requested). Non-zero
|
||||
otherwise.
|
||||
|
||||
Zupdate supports the following options:
|
||||
zupdate supports the following options:
|
||||
|
||||
'-f'
|
||||
'--force'
|
||||
|
@ -757,18 +757,18 @@ Concept index
|
|||
|
||||
Tag Table:
|
||||
Node: Top222
|
||||
Node: Introduction1149
|
||||
Node: Common options3698
|
||||
Ref: compressor-requirements5451
|
||||
Node: The zutilsrc file5823
|
||||
Node: Zcat6749
|
||||
Node: Zcmp8796
|
||||
Node: Zdiff11256
|
||||
Node: Zgrep13896
|
||||
Node: Ztest16991
|
||||
Node: Zupdate18495
|
||||
Node: Problems21370
|
||||
Node: Concept index21904
|
||||
Node: Introduction1142
|
||||
Node: Common options3692
|
||||
Ref: compressor-requirements5450
|
||||
Node: The zutilsrc file5822
|
||||
Node: Zcat6748
|
||||
Node: Zcmp8795
|
||||
Node: Zdiff11255
|
||||
Node: Zgrep13895
|
||||
Node: Ztest16990
|
||||
Node: Zupdate18494
|
||||
Node: Problems21369
|
||||
Node: Concept index21903
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue