summaryrefslogtreecommitdiffstats
path: root/doc/zutils.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/zutils.texi')
-rw-r--r--doc/zutils.texi37
1 files changed, 21 insertions, 16 deletions
diff --git a/doc/zutils.texi b/doc/zutils.texi
index bb1c3b1..c494185 100644
--- a/doc/zutils.texi
+++ b/doc/zutils.texi
@@ -6,8 +6,8 @@
@finalout
@c %**end of header
-@set UPDATED 27 June 2020
-@set VERSION 1.9
+@set UPDATED 5 January 2021
+@set VERSION 1.10
@dircategory Data Compression
@direntry
@@ -29,6 +29,7 @@
@contents
@end ifnothtml
+@ifnottex
@node Top
@top
@@ -49,10 +50,11 @@ This manual is for Zutils (version @value{VERSION}, @value{UPDATED}).
@end menu
@sp 1
-Copyright @copyright{} 2009-2020 Antonio Diaz Diaz.
+Copyright @copyright{} 2009-2021 Antonio Diaz Diaz.
This manual is free documentation: you have unlimited permission to copy,
distribute, and modify it.
+@end ifnottex
@node Introduction
@@ -194,21 +196,20 @@ It must return 0 if no errors occurred, and a non-zero value otherwise.
@node The zutilsrc file
-@chapter The zutilsrc file
-@cindex the zutilsrc file
+@chapter The zutils configuration file 'zutilsrc'
+@cindex zutilsrc
@file{zutilsrc} is the runtime configuration file for zutils. In it you
may define the compressor name and options to be used for each format.
-The @file{zutilsrc} file is optional; you don't need to install it in
-order to run zutils.
+@file{zutilsrc} is optional; you don't need to install it in order to run
+zutils.
The compressors specified in the command line override those specified
-in the @file{zutilsrc} file.
+in @file{zutilsrc}.
-You may copy the system @file{zutilsrc} file
-@file{$@{sysconfdir@}/zutilsrc} to @file{$HOME/.zutilsrc} and customize
-these options as you like. The file syntax is fairly obvious (and there
-are further instructions in it):
+You may copy the system @file{zutilsrc} file @file{$@{sysconfdir@}/zutilsrc}
+to @file{$HOME/.zutilsrc} and customize these options as you like. The file
+syntax is fairly obvious (and there are further instructions in it):
@enumerate
@item
@@ -623,7 +624,10 @@ Only print names of files containing at least one match.
@item -L
@itemx --files-without-match
-Only print names of files not containing any matches.
+Only print names of files not containing any matches.@*
+Note: option -L fails (prints wrong results, returns wrong status, and even
+hangs) when using GNU grep versions 3.2 to 3.4 inclusive because of a wrong
+change in the exit status of grep, which was reverted in GNU grep 3.5.
@item -m @var{n}
@itemx --max-count=@var{n}
@@ -783,9 +787,10 @@ Combining the options @samp{--force} and @samp{--keep}, as in
between each pair of files in a multiformat set of files.
The names of the original files must have one of the following extensions:@*
-@samp{.bz2}, @samp{.gz}, and @samp{.xz} are recompressed to @samp{.lz}.@*
-@samp{.tbz}, @samp{.tbz2}, @samp{.tgz}, and @samp{.txz} are recompressed to
-@samp{.tlz}.@*
+@samp{.bz2}, @samp{.gz}, or @samp{.xz}, which are recompressed to
+@samp{.lz};@*
+@samp{.tbz}, @samp{.tbz2}, @samp{.tgz}, or @samp{.txz}, which are
+recompressed to @samp{.tlz}.@*
Keeping the combined extensions (@samp{.tgz} --> @samp{.tlz}) may be useful
when recompressing Slackware packages, for example.