"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/zutils.texi" between
zutils-1.9.tar.lz and zutils-1.10.tar.lz

About: Zutils is a collection of utilities able to deal with any combination of compressed and non-compressed files transparently. The utilities zcat, zcmp, zdiff, zgrep and ztest supports the compressors bzip2, gzip, lzip and xz.

zutils.texi  (zutils-1.9.tar.lz):zutils.texi  (zutils-1.10.tar.lz)
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c %**start of header @c %**start of header
@setfilename zutils.info @setfilename zutils.info
@documentencoding ISO-8859-15 @documentencoding ISO-8859-15
@settitle Zutils Manual @settitle Zutils Manual
@finalout @finalout
@c %**end of header @c %**end of header
@set UPDATED 27 June 2020 @set UPDATED 5 January 2021
@set VERSION 1.9 @set VERSION 1.10
@dircategory Data Compression @dircategory Data Compression
@direntry @direntry
* Zutils: (zutils). Utilities dealing with compressed files * Zutils: (zutils). Utilities dealing with compressed files
@end direntry @end direntry
@ifnothtml @ifnothtml
@titlepage @titlepage
@title Zutils @title Zutils
@subtitle Utilities dealing with compressed files @subtitle Utilities dealing with compressed files
@subtitle for Zutils version @value{VERSION}, @value{UPDATED} @subtitle for Zutils version @value{VERSION}, @value{UPDATED}
@author by Antonio Diaz Diaz @author by Antonio Diaz Diaz
@page @page
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
@end titlepage @end titlepage
@contents @contents
@end ifnothtml @end ifnothtml
@ifnottex
@node Top @node Top
@top @top
This manual is for Zutils (version @value{VERSION}, @value{UPDATED}). This manual is for Zutils (version @value{VERSION}, @value{UPDATED}).
@menu @menu
* Introduction:: Purpose and features of zutils * Introduction:: Purpose and features of zutils
* Common options:: Options common to all utilities * Common options:: Options common to all utilities
* The zutilsrc file:: The zutils configuration file * The zutilsrc file:: The zutils configuration file
* Zcat:: Concatenating compressed files * Zcat:: Concatenating compressed files
* Zcmp:: Comparing compressed files byte by byte * Zcmp:: Comparing compressed files byte by byte
* Zdiff:: Comparing compressed files line by line * Zdiff:: Comparing compressed files line by line
* Zgrep:: Searching inside compressed files * Zgrep:: Searching inside compressed files
* Ztest:: Testing the integrity of compressed files * Ztest:: Testing the integrity of compressed files
* Zupdate:: Recompressing files to lzip format * Zupdate:: Recompressing files to lzip format
* Problems:: Reporting bugs * Problems:: Reporting bugs
* Concept index:: Index of concepts * Concept index:: Index of concepts
@end menu @end menu
@sp 1 @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, This manual is free documentation: you have unlimited permission to copy,
distribute, and modify it. distribute, and modify it.
@end ifnottex
@node Introduction @node Introduction
@chapter Introduction @chapter Introduction
@cindex introduction @cindex introduction
@uref{http://www.nongnu.org/zutils/zutils.html,,Zutils} @uref{http://www.nongnu.org/zutils/zutils.html,,Zutils}
is a collection of utilities able to process any combination of is a collection of utilities able to process any combination of
compressed and uncompressed files transparently. If any file given, compressed and uncompressed files transparently. If any file given,
including standard input, is compressed, its decompressed content is used. including standard input, is compressed, its decompressed content is used.
Compressed files are decompressed on the fly; no temporary files are Compressed files are decompressed on the fly; no temporary files are
skipping to change at line 193 skipping to change at line 195
@item @item
If the option @samp{-q} is passed to zutils, the compression program must If the option @samp{-q} is passed to zutils, the compression program must
also accept it. also accept it.
@item @item
It must return 0 if no errors occurred, and a non-zero value otherwise. It must return 0 if no errors occurred, and a non-zero value otherwise.
@end enumerate @end enumerate
@end table @end table
@node The zutilsrc file @node The zutilsrc file
@chapter The zutilsrc file @chapter The zutils configuration file 'zutilsrc'
@cindex the zutilsrc file @cindex zutilsrc
@file{zutilsrc} is the runtime configuration file for zutils. In it you @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. 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 @file{zutilsrc} is optional; you don't need to install it in order to run
order to run zutils. zutils.
The compressors specified in the command line override those specified 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 You may copy the system @file{zutilsrc} file @file{$@{sysconfdir@}/zutilsrc}
@file{$@{sysconfdir@}/zutilsrc} to @file{$HOME/.zutilsrc} and customize to @file{$HOME/.zutilsrc} and customize these options as you like. The file
these options as you like. The file syntax is fairly obvious (and there syntax is fairly obvious (and there are further instructions in it):
are further instructions in it):
@enumerate @enumerate
@item @item
Any line beginning with @samp{#} is a comment line. Any line beginning with @samp{#} is a comment line.
@item @item
Each non-comment line defines the command to be used for the corresponding Each non-comment line defines the command to be used for the corresponding
format, with the syntax: format, with the syntax:
@example @example
<format> = <compressor> [options] <format> = <compressor> [options]
@end example @end example
skipping to change at line 618 skipping to change at line 619
@item -I @item -I
Ignore binary files. Ignore binary files.
@item -l @item -l
@itemx --files-with-matches @itemx --files-with-matches
Only print names of files containing at least one match. Only print names of files containing at least one match.
@item -L @item -L
@itemx --files-without-match @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} @item -m @var{n}
@itemx --max-count=@var{n} @itemx --max-count=@var{n}
Stop after @var{n} matches. Stop after @var{n} matches.
@item -n @item -n
@itemx --line-number @itemx --line-number
Prefix each matched line with its line number in the input file. Prefix each matched line with its line number in the input file.
@item -o @item -o
skipping to change at line 776 skipping to change at line 780
comparison with the existing lzip version fails, an error is returned comparison with the existing lzip version fails, an error is returned
and the original file is not deleted. The operation of zupdate is meant and the original file is not deleted. The operation of zupdate is meant
to be safe and not cause any data loss. Therefore, existing lzip to be safe and not cause any data loss. Therefore, existing lzip
compressed files are never overwritten nor deleted. compressed files are never overwritten nor deleted.
Combining the options @samp{--force} and @samp{--keep}, as in Combining the options @samp{--force} and @samp{--keep}, as in
@w{@samp{zupdate -f -k *.gz}}, verifies that there are no differences @w{@samp{zupdate -f -k *.gz}}, verifies that there are no differences
between each pair of files in a multiformat set of files. between each pair of files in a multiformat set of files.
The names of the original files must have one of the following extensions:@* 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{.bz2}, @samp{.gz}, or @samp{.xz}, which are recompressed to
@samp{.tbz}, @samp{.tbz2}, @samp{.tgz}, and @samp{.txz} are recompressed to @samp{.lz};@*
@samp{.tlz}.@* @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 Keeping the combined extensions (@samp{.tgz} --> @samp{.tlz}) may be useful
when recompressing Slackware packages, for example. when recompressing Slackware packages, for example.
Recompressing a file is much like copying or moving it; therefore zupdate Recompressing a file is much like copying or moving it; therefore zupdate
preserves the access and modification dates, permissions, and, when preserves the access and modification dates, permissions, and, when
possible, ownership of the file just as @samp{cp -p} does. (If the user ID or 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 the group ID can't be duplicated, the file permission bits S_ISUID and
S_ISGID are cleared). S_ISGID are cleared).
The format for running zupdate is: The format for running zupdate is:
 End of changes. 10 change blocks. 
16 lines changed or deleted 21 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)