\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename zutils.info
@settitle Zutils
@finalout
@c %**end of header

@set UPDATED 1 October 2009
@set VERSION 0.5

@dircategory Data Compression
@direntry
* Zutils: (zutils).             Utilities dealing with compressed files
@end direntry


@titlepage
@title Zutils
@subtitle Utilities dealing with compressed files
@subtitle for Zutils version @value{VERSION}, @value{UPDATED}
@author by Antonio Diaz Diaz

@page
@vskip 0pt plus 1filll
@end titlepage

@contents

@node Top
@top

This manual is for Zutils (version @value{VERSION}, @value{UPDATED}).

@menu
* Introduction::	Purpose and features of zutils
* Zcat::		Concatenating compressed files
* Zcmp/Zdiff::		Comparing compressed files
* Zgrep::		Searching inside compressed files
* Problems::		Reporting bugs
* Concept Index::	Index of concepts
@end menu

@sp 1
Copyright @copyright{} 2008, 2009 Antonio Diaz Diaz.

This manual is free documentation: you have unlimited permission
to copy, distribute and modify it.


@node Introduction
@chapter Introduction
@cindex introduction

Zutils is a collection of utilities for dealing with any combination of
compressed and non-compressed files transparently. The supported
compressors are gzip, bzip2, lzip and xz.

The currently provided utilities are zcat, zcmp, zdiff, zegrep, zfgrep
and zgrep.


@node Zcat
@chapter Zcat
@cindex zcat

Zcat is a wrapper script around the cat command that allows transparent
concatenation of any combination of compressed and non-compressed files.
If any given file is compressed, its uncompressed content is used. If a
given file does not exist, zcat tries the compressed file names
corresponding to the supported compressors. If no files are specified,
the standard input is decompressed using the selected compressor and
sent to stdout.

The format for running zcat is:

@example
zcat [@var{options}] [@var{cat_options}] [@var{files}]
@end example

@noindent
@var{cat_options} are passed directly to cat. The exit status from cat
is preserved.

Zcat supports the following options:

@table @samp
@item --help
@itemx -h
Print an informative help message describing the options and exit.

@item --version
@itemx -V
Print the version number of zcat on the standard output and exit.

@item --gzip
Use gzip as decompressor for stdin (default).

@item --bzip2
Use bzip2 as decompressor for stdin.

@item --lzip
Use lzip as decompressor for stdin.

@item --xz
Use xz as decompressor for stdin.

@end table


@node Zcmp/Zdiff
@chapter Zcmp/Zdiff
@cindex zcmp
@cindex zdiff

Zdiff is a wrapper script around the diff and cmp commands that allows
transparent comparison of any combination of compressed and
non-compressed files. If any given file is compressed, its uncompressed
content is used.

@noindent
Zcmp is a shortcut for @samp{zdiff --cmp}

The format for running zdiff is:

@example
zdiff [@var{options}] [@var{diff_options}] @var{file1} [@var{file2}]
@end example

@noindent
Compares @var{file1} to @var{file2}. If @var{file2} is omitted and
@var{file1} is compressed, compares @var{file1} to the file with the
corresponding decompressed file name (removes the extension from
@var{file1}). If @var{file2} is omitted and @var{file1} is not
compressed, compares @var{file1} to the uncompressed contents of
@var{file1}.[gz|bz2|lz|xz] (the first one that is found).
@var{diff_options} are passed directly to diff or cmp. The exit status
from diff or cmp is preserved.

Zdiff supports the following options:

@table @samp
@item --help
@itemx -h
Print an informative help message describing the options and exit.

@item --version
@itemx -V
Print the version number of zdiff on the standard output and exit.

@item --diff
Use diff to compare files (default).

@item --cmp
Use cmp to compare files.

@end table

Zdiff has the limitation that messages from the diff or cmp programs
refer to temporary filenames instead of those specified.


@node Zgrep
@chapter Zgrep
@cindex zegrep
@cindex zfgrep
@cindex zgrep

Zgrep is a wrapper script around the grep command that allows
transparent search on any combination of compressed and non-compressed
files. If any given file is compressed, its uncompressed content is
used. If a given file does not exist, zgrep tries the compressed file
names corresponding to the supported compressors. If no files are
specified, the standard input is decompressed using the selected
compressor and fed to grep.

@noindent
Zegrep is a shortcut for @samp{zgrep -E}@*
Zfgrep is a shortcut for @samp{zgrep -F}


The format for running zgrep is:

@example
zgrep [@var{options}] [@var{grep_options}] @var{pattern} [@var{files}]
@end example

@noindent
@var{grep_options} are passed directly to grep. The exit status from
grep is preserved.

Zgrep supports the following options:

@table @samp
@item --help
@itemx -h
Print an informative help message describing the options and exit.

@item --version
@itemx -V
Print the version number of zgrep on the standard output and exit.

@item --gzip
Use gzip as decompressor for stdin (default).

@item --bzip2
Use bzip2 as decompressor for stdin.

@item --lzip
Use lzip as decompressor for stdin.

@item --xz
Use xz as decompressor for stdin.

@end table


@node Problems
@chapter Reporting Bugs
@cindex bugs
@cindex getting help

There are probably bugs in zutils. There are certainly errors and
omissions in this manual. If you report them, they will get fixed. If
you don't, no one will ever know about them and they will remain unfixed
for all eternity, if not longer.

If you find a bug in zutils, please send electronic mail to
@email{zutils-bug@@nongnu.org}. Include the version number, which you can
find by running @w{@samp{zdiff --version}}.


@node Concept Index
@unnumbered Concept Index

@printindex cp

@bye