diff options
Diffstat (limited to 'doc/zutils.info')
| -rw-r--r-- | doc/zutils.info | 84 |
1 files changed, 42 insertions, 42 deletions
diff --git a/doc/zutils.info b/doc/zutils.info index 83f07b7..090ec48 100644 --- a/doc/zutils.info +++ b/doc/zutils.info @@ -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 |