diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/zcat.1 | 22 | ||||
| -rw-r--r-- | doc/zcmp.1 | 6 | ||||
| -rw-r--r-- | doc/zdiff.1 | 6 | ||||
| -rw-r--r-- | doc/zgrep.1 | 22 | ||||
| -rw-r--r-- | doc/ztest.1 | 19 | ||||
| -rw-r--r-- | doc/zupdate.1 | 23 | ||||
| -rw-r--r-- | doc/zutils.info | 125 | ||||
| -rw-r--r-- | doc/zutils.texi | 101 |
8 files changed, 220 insertions, 104 deletions
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZCAT "1" "February 2018" "zcat (zutils) 1.7" "User Commands" +.TH ZCAT "1" "January 2019" "zcat (zutils) 1.8" "User Commands" .SH NAME zcat \- decompress and concatenate files to standard output .SH SYNOPSIS @@ -9,14 +9,17 @@ zcat \- decompress and concatenate files to standard output Zcat copies each given file 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 corresponding to the supported formats. +tries the compressed file names corresponding to the formats supported. .PP -If no files are specified, or if a file is specified as '\-', data are -read from standard input, decompressed if needed, and sent to standard -output. Data read from standard input must be of the same type; all -uncompressed or all in the same compression format. +If a file is specified as '\-', data are read from standard input, +decompressed if needed, and sent to standard output. Data read from +standard input must be of the same type; all uncompressed or all in the +same compression format. .PP -The supported formats are bzip2, gzip, lzip and xz. +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. +.PP +The formats supported are bzip2, gzip, lzip and xz. .PP Exit status is 0 if no errors occurred, non\-zero otherwise. .SH OPTIONS @@ -57,6 +60,9 @@ suppress all messages \fB\-r\fR, \fB\-\-recursive\fR operate recursively on directories .TP +\fB\-R\fR, \fB\-\-dereference\-recursive\fR +recursively follow symbolic links +.TP \fB\-s\fR, \fB\-\-squeeze\-blank\fR never more than one single blank line .TP @@ -88,7 +94,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZCMP "1" "February 2018" "zcmp (zutils) 1.7" "User Commands" +.TH ZCMP "1" "January 2019" "zcmp (zutils) 1.8" "User Commands" .SH NAME zcmp \- decompress and compare two files byte by byte .SH SYNOPSIS @@ -12,7 +12,7 @@ are numbered starting with 1. If any given file is compressed, its decompressed content is used. Compressed files are decompressed on the fly; no temporary files are created. .PP -The supported formats are bzip2, gzip, lzip and xz. +The formats supported are bzip2, gzip, lzip and xz. .PP Zcmp compares file1 to file2. If file2 is omitted zcmp tries the following: @@ -85,7 +85,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. diff --git a/doc/zdiff.1 b/doc/zdiff.1 index aee3b3a..4edcf5e 100644 --- a/doc/zdiff.1 +++ b/doc/zdiff.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZDIFF "1" "February 2018" "zdiff (zutils) 1.7" "User Commands" +.TH ZDIFF "1" "January 2019" "zdiff (zutils) 1.8" "User Commands" .SH NAME zdiff \- decompress and compare two files line by line .SH SYNOPSIS @@ -12,7 +12,7 @@ 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 filenames instead of those specified. .PP -The supported formats are bzip2, gzip, lzip and xz. +The formats supported are bzip2, gzip, lzip and xz. .PP Zdiff compares file1 to file2. If file2 is omitted zdiff tries the following: @@ -109,7 +109,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. diff --git a/doc/zgrep.1 b/doc/zgrep.1 index 5533b43..2418ef2 100644 --- a/doc/zgrep.1 +++ b/doc/zgrep.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZGREP "1" "February 2018" "zgrep (zutils) 1.7" "User Commands" +.TH ZGREP "1" "January 2019" "zgrep (zutils) 1.8" "User Commands" .SH NAME zgrep \- search compressed files for a regular expression .SH SYNOPSIS @@ -11,14 +11,17 @@ 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 extensions, zgrep tries the compressed file names corresponding to the -supported formats. +formats supported. .PP -If no files are specified, or if a file is specified as '\-', data are -read from standard input, decompressed if needed, and fed to grep. Data -read from standard input must be of the same type; all uncompressed or -all in the same compression format. +If a file is specified as '\-', data are read from standard input, +decompressed if needed, and fed to grep. Data read from standard input +must be of the same type; all uncompressed or all in the same +compression format. .PP -The supported formats are bzip2, gzip, lzip and xz. +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. +.PP +The formats supported are bzip2, gzip, lzip and xz. .PP Exit status is 0 if match, 1 if no match, 2 if trouble. .SH OPTIONS @@ -104,6 +107,9 @@ suppress all messages \fB\-r\fR, \fB\-\-recursive\fR operate recursively on directories .TP +\fB\-R\fR, \fB\-\-dereference\-recursive\fR +recursively follow symbolic links +.TP \fB\-s\fR, \fB\-\-no\-messages\fR suppress error messages .TP @@ -138,7 +144,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. diff --git a/doc/ztest.1 b/doc/ztest.1 index 7cad696..bffa73f 100644 --- a/doc/ztest.1 +++ b/doc/ztest.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZTEST "1" "February 2018" "ztest (zutils) 1.7" "User Commands" +.TH ZTEST "1" "January 2019" "ztest (zutils) 1.8" "User Commands" .SH NAME ztest \- verify the integrity of compressed files .SH SYNOPSIS @@ -7,12 +7,14 @@ ztest \- verify the integrity of compressed files [\fI\,options\/\fR] [\fI\,files\/\fR] .SH DESCRIPTION Ztest verifies the integrity of the specified compressed files. -Uncompressed files are ignored. If no files are specified, or if a file -is specified as '\-', the integrity of compressed data read from standard -input is verified. Data read from standard input must be all in the same -compression format. +Uncompressed files are ignored. If a file is specified as '\-', the +integrity of compressed data read from standard input is verified. Data +read from standard input must be all in the same compression format. .PP -The supported formats are bzip2, gzip, lzip and xz. +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. +.PP +The formats supported are bzip2, gzip, lzip and xz. .PP Note that error detection in the xz format is broken. First, some xz files lack integrity information. Second, not all xz decompressors can @@ -47,6 +49,9 @@ suppress all messages \fB\-r\fR, \fB\-\-recursive\fR operate recursively on directories .TP +\fB\-R\fR, \fB\-\-dereference\-recursive\fR +recursively follow symbolic links +.TP \fB\-v\fR, \fB\-\-verbose\fR be verbose (a 2nd \fB\-v\fR gives more) .TP @@ -66,7 +71,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. diff --git a/doc/zupdate.1 b/doc/zupdate.1 index f0025d7..955b8c5 100644 --- a/doc/zupdate.1 +++ b/doc/zupdate.1 @@ -1,19 +1,21 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1. -.TH ZUPDATE "1" "February 2018" "zupdate (zutils) 1.7" "User Commands" +.TH ZUPDATE "1" "January 2019" "zupdate (zutils) 1.8" "User Commands" .SH NAME zupdate \- recompress bzip2, gzip, xz files to lzip format .SH SYNOPSIS .B zupdate [\fI\,options\/\fR] [\fI\,files\/\fR] .SH DESCRIPTION -Zupdate recompresses files from bzip2, gzip, and xz formats to lzip format. -The originals are compared with the new files and then deleted. +Zupdate recompresses files from bzip2, gzip, and xz formats to lzip +format. Each original is compared with the new file and then deleted. Only regular files with standard file name extensions are recompressed, -other files are ignored. -Compressed files are decompressed and then recompressed on the fly; no -temporary files are created. -The lzip format is chosen as destination because it is by far the most -appropriate for long\-term data archiving. +other files are ignored. Compressed files are decompressed and then +recompressed on the fly; no temporary files are created. The lzip format +is chosen as destination because it is the most appropriate for +long\-term data archiving. +.PP +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches do nothing. .PP If the lzip compressed version of a file already exists, the file is skipped unless the '\-\-force' option is given. In this case, if the @@ -54,6 +56,9 @@ suppress all messages \fB\-r\fR, \fB\-\-recursive\fR operate recursively on directories .TP +\fB\-R\fR, \fB\-\-dereference\-recursive\fR +recursively follow symbolic links +.TP \fB\-v\fR, \fB\-\-verbose\fR be verbose (a 2nd \fB\-v\fR gives more) .TP @@ -76,7 +81,7 @@ Report bugs to zutils\-bug@nongnu.org .br Zutils home page: http://www.nongnu.org/zutils/zutils.html .SH COPYRIGHT -Copyright \(co 2018 Antonio Diaz Diaz. +Copyright \(co 2019 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html> .br This is free software: you are free to change and redistribute it. diff --git a/doc/zutils.info b/doc/zutils.info index 11ea41a..bf99e2d 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.7, 13 February 2018). +This manual is for Zutils (version 1.8, 1 January 2019). * Menu: @@ -29,7 +29,7 @@ This manual is for Zutils (version 1.7, 13 February 2018). * Concept index:: Index of concepts - Copyright (C) 2009-2018 Antonio Diaz Diaz. + Copyright (C) 2009-2019 Antonio Diaz Diaz. This manual is free documentation: you have unlimited permission to copy, distribute and modify it. @@ -50,8 +50,8 @@ are created. C++ programs. In particular the '--recursive' option is very efficient in those utilities supporting it. -The provided utilities are zcat, zcmp, zdiff, zgrep, ztest and zupdate. -The supported formats are bzip2, gzip, lzip and xz. +The utilities provided are zcat, zcmp, zdiff, zgrep, ztest and zupdate. +The formats supported are bzip2, gzip, lzip and xz. Zutils uses external compressors. The compressor to be used for each format is configurable at runtime. @@ -110,7 +110,8 @@ described here. '-V' '--version' - Print the version number on the standard output and exit. + Print the version number on the standard output and exit. This + version number should be included in all bug reports. '-M FORMAT_LIST' '--format=FORMAT_LIST' @@ -190,12 +191,17 @@ File: zutils.info, Node: Zcat, Next: Zcmp, Prev: The zutilsrc file, Up: Top zcat copies each given file 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 corresponding to the supported formats. +tries the compressed file names corresponding to the formats supported. +If a file fails to decompress, zcat continues copying the rest of the +files. - If no files are specified, or if a file is specified as '-', data -are read from standard input, decompressed if needed, and sent to -standard output. Data read from standard input must be of the same type; -all uncompressed or all in the same compression format. + If a file is specified as '-', data are read from standard input, +decompressed if needed, and sent to standard output. Data read from +standard input must be of the same type; all uncompressed or all in the +same compression format. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zcat is: @@ -240,7 +246,14 @@ Exit status is 0 if no errors occurred, non-zero otherwise. '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-s' '--squeeze-blank' @@ -459,12 +472,16 @@ 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 extensions, zgrep tries the compressed file names corresponding to the -supported formats. +formats supported. If a file fails to decompress, zgrep continues +searching the rest of the files. - If no files are specified, or if a file is specified as '-', data -are read from standard input, decompressed if needed, and fed to grep. -Data read from standard input must be of the same type; all uncompressed -or all in the same compression format. + If a file is specified as '-', data are read from standard input, +decompressed if needed, and fed to grep. Data read from standard input +must be of the same type; all uncompressed or all in the same +compression format. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zgrep is: @@ -573,7 +590,14 @@ grep program used supports them): '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-s' '--no-messages' @@ -602,10 +626,14 @@ File: zutils.info, Node: Ztest, Next: Zupdate, Prev: Zgrep, Up: Top ******* ztest verifies the integrity of the specified compressed files. -Uncompressed files are ignored. If no files are specified, or if a file -is specified as '-', the integrity of compressed data read from -standard input is verified. Data read from standard input must be all in -the same compression format. +Uncompressed files are ignored. If a file is specified as '-', the +integrity of compressed data read from standard input is verified. Data +read from standard input must be all in the same compression format. If +a file fails to decompress, ztest continues verifying the rest of the +files. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. Note that error detection in the xz format is broken. First, some xz files lack integrity information. Second, not all xz decompressors can @@ -640,7 +668,14 @@ environmental problems (file not found, invalid flags, I/O errors, etc), '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-v' '--verbose' @@ -658,9 +693,14 @@ zupdate recompresses files from bzip2, gzip, and xz formats to lzip format. Each original is compared with the new file and then deleted. Only regular files with standard file name extensions are recompressed, other files are ignored. Compressed files are decompressed and then -recompressed on the fly; no temporary files are created. The lzip format -is chosen as destination because it is by far the most appropriate for -long-term data archiving. +recompressed on the fly; no temporary files are created. If an error +happens while recompressing a file, zupdate exits immediately without +recompressing the rest of the files. The lzip format is chosen as +destination because it is the most appropriate for long-term data +archiving. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches do nothing. If the lzip compressed version of a file already exists, the file is skipped unless the '--force' option is given. In this case, if the @@ -679,7 +719,7 @@ files produced have the extensions '.lz' or '.tar.lz'. Recompressing a file is much like copying or moving it; therefore zupdate preserves the access and modification dates, permissions, and, -when possible, ownership of the file just as "cp -p" does. (If the user +when possible, ownership of the file just as 'cp -p' does. (If the user ID or the group ID can't be duplicated, the file permission bits S_ISUID and S_ISGID are cleared). @@ -718,7 +758,14 @@ otherwise. '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-v' '--verbose' @@ -770,18 +817,18 @@ Concept index Tag Table: Node: Top222 -Node: Introduction1151 -Node: Common options3775 -Ref: compressor-requirements5533 -Node: The zutilsrc file5905 -Node: Zcat6830 -Node: Zcmp8884 -Node: Zdiff11343 -Node: Zgrep14047 -Node: Ztest17541 -Node: Zupdate19375 -Node: Problems22247 -Node: Concept index22781 +Node: Introduction1149 +Node: Common options3773 +Ref: compressor-requirements5596 +Node: The zutilsrc file5968 +Node: Zcat6893 +Node: Zcmp9445 +Node: Zdiff11904 +Node: Zgrep14608 +Node: Ztest18603 +Node: Zupdate20938 +Node: Problems24364 +Node: Concept index24898 End Tag Table diff --git a/doc/zutils.texi b/doc/zutils.texi index 343c297..789643a 100644 --- a/doc/zutils.texi +++ b/doc/zutils.texi @@ -6,8 +6,8 @@ @finalout @c %**end of header -@set UPDATED 13 February 2018 -@set VERSION 1.7 +@set UPDATED 1 January 2019 +@set VERSION 1.8 @dircategory Data Compression @direntry @@ -49,7 +49,7 @@ This manual is for Zutils (version @value{VERSION}, @value{UPDATED}). @end menu @sp 1 -Copyright @copyright{} 2009-2018 Antonio Diaz Diaz. +Copyright @copyright{} 2009-2019 Antonio Diaz Diaz. This manual is free documentation: you have unlimited permission to copy, distribute and modify it. @@ -70,8 +70,8 @@ programs. In particular the @samp{--recursive} option is very efficient in those utilities supporting it. @noindent -The provided utilities are zcat, zcmp, zdiff, zgrep, ztest and zupdate.@* -The supported formats are bzip2, gzip, lzip and xz.@* +The utilities provided are zcat, zcmp, zdiff, zgrep, ztest and zupdate.@* +The formats supported are bzip2, gzip, lzip and xz.@* Zutils uses external compressors. The compressor to be used for each format is configurable at runtime. @@ -133,6 +133,7 @@ only supports the @samp{--help} form of this option. @item -V @itemx --version Print the version number on the standard output and exit. +This version number should be included in all bug reports. @item -M @var{format_list} @itemx --format=@var{format_list} @@ -221,12 +222,17 @@ where <format> is one of @samp{bz2}, @samp{gz}, @samp{lz} or @samp{xz}. zcat copies each given file 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 corresponding to the supported formats. +tries the compressed file names corresponding to the formats supported. +If a file fails to decompress, zcat continues copying the rest of the +files. -If no files are specified, or if a file is specified as @samp{-}, data -are read from standard input, decompressed if needed, and sent to -standard output. Data read from standard input must be of the same type; -all uncompressed or all in the same compression format. +If a file is specified as @samp{-}, data are read from standard input, +decompressed if needed, and sent to standard output. Data read from +standard input must be of the same type; all uncompressed or all in the +same compression format. + +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zcat is: @@ -274,7 +280,14 @@ Quiet operation. Suppress all messages. @item -r @itemx --recursive -Operate recursively on directories. +For each directory operand, read and process all files in that +directory, recursively. Follow symbolic links in the command line, but +skip symlinks that are encountered recursively. + +@item -R +@itemx --dereference-recursive +For each directory operand, read and process all files in that +directory, recursively, following all symbolic links. @item -s @itemx --squeeze-blank @@ -509,12 +522,16 @@ 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 extensions, zgrep tries the compressed file names corresponding to the -supported formats. +formats supported. If a file fails to decompress, zgrep continues +searching the rest of the files. -If no files are specified, or if a file is specified as @samp{-}, data -are read from standard input, decompressed if needed, and fed to grep. -Data read from standard input must be of the same type; all uncompressed -or all in the same compression format. +If a file is specified as @samp{-}, data are read from standard input, +decompressed if needed, and fed to grep. Data read from standard input +must be of the same type; all uncompressed or all in the same +compression format. + +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zgrep is: @@ -629,7 +646,14 @@ found, even if an error was detected. @item -r @itemx --recursive -Operate recursively on directories. +For each directory operand, read and process all files in that +directory, recursively. Follow symbolic links in the command line, but +skip symlinks that are encountered recursively. + +@item -R +@itemx --dereference-recursive +For each directory operand, read and process all files in that +directory, recursively, following all symbolic links. @item -s @itemx --no-messages @@ -658,10 +682,14 @@ Match only whole lines. @cindex ztest ztest verifies the integrity of the specified compressed files. -Uncompressed files are ignored. If no files are specified, or if a file -is specified as @samp{-}, the integrity of compressed data read from -standard input is verified. Data read from standard input must be all in -the same compression format. +Uncompressed files are ignored. If a file is specified as @samp{-}, the +integrity of compressed data read from standard input is verified. Data +read from standard input must be all in the same compression format. If +a file fails to decompress, ztest continues verifying the rest of the +files. + +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. Note that error detection in the xz format is broken. First, some xz files lack integrity information. Second, not all xz decompressors can @@ -703,7 +731,14 @@ Quiet operation. Suppress all messages. @item -r @itemx --recursive -Operate recursively on directories. +For each directory operand, read and process all files in that +directory, recursively. Follow symbolic links in the command line, but +skip symlinks that are encountered recursively. + +@item -R +@itemx --dereference-recursive +For each directory operand, read and process all files in that +directory, recursively, following all symbolic links. @item -v @itemx --verbose @@ -721,9 +756,14 @@ zupdate recompresses files from bzip2, gzip, and xz formats to lzip format. Each original is compared with the new file and then deleted. Only regular files with standard file name extensions are recompressed, other files are ignored. Compressed files are decompressed and then -recompressed on the fly; no temporary files are created. The lzip format -is chosen as destination because it is by far the most appropriate for -long-term data archiving. +recompressed on the fly; no temporary files are created. If an error +happens while recompressing a file, zupdate exits immediately without +recompressing the rest of the files. The lzip format is chosen as +destination because it is the most appropriate for long-term data +archiving. + +If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches do nothing. If the lzip compressed version of a file already exists, the file is skipped unless the @samp{--force} option is given. In this case, if the @@ -743,7 +783,7 @@ extensions @samp{.lz} or @samp{.tar.lz}. Recompressing a file is much like copying or moving it; therefore zupdate preserves the access and modification dates, permissions, and, -when possible, ownership of the file just as "cp -p" does. (If the user +when possible, ownership of the file just as @samp{cp -p} does. (If the user ID or the group ID can't be duplicated, the file permission bits S_ISUID and S_ISGID are cleared). @@ -785,7 +825,14 @@ Quiet operation. Suppress all messages. @item -r @itemx --recursive -Operate recursively on directories. +For each directory operand, read and process all files in that +directory, recursively. Follow symbolic links in the command line, but +skip symlinks that are encountered recursively. + +@item -R +@itemx --dereference-recursive +For each directory operand, read and process all files in that +directory, recursively, following all symbolic links. @item -v @itemx --verbose |