diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/zcat.1 | 45 | ||||
| -rw-r--r-- | doc/zdiff.1 | 53 | ||||
| -rw-r--r-- | doc/zgrep.1 | 45 | ||||
| -rw-r--r-- | doc/zutils.info | bin | 0 -> 6005 bytes | |||
| -rw-r--r-- | doc/zutils.texinfo | 236 |
5 files changed, 379 insertions, 0 deletions
diff --git a/doc/zcat.1 b/doc/zcat.1 new file mode 100644 index 0000000..cd432f0 --- /dev/null +++ b/doc/zcat.1 @@ -0,0 +1,45 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. +.TH ZCAT "1" "August 2009" "Zcat 0.2" "User Commands" +.SH NAME +Zcat \- manual page for Zcat 0.2 +.SH SYNOPSIS +.B zcat +[\fIOPTIONS\fR] [\fICAT_OPTIONS\fR] [\fIFILES\fR] +.SH DESCRIPTION +Zcat \- Cat wrapper for compressed files. +.PP +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 name corresponding to the default compressor selected. +The supported compressors are gzip, bzip2, lzip and xz. +.PP +CAT_OPTIONS are passed directly to cat. +The exit status from cat is preserved. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-V\fR, \fB\-\-version\fR +output version information and exit +.TP +\fB\-\-gzip\fR +use gzip as default decompressor +.TP +\fB\-\-bzip2\fR +use bzip2 as default decompressor +.TP +\fB\-\-lzip\fR +use lzip as default decompressor (default) +.TP +\fB\-\-xz\fR +use xz as default decompressor +.SH "REPORTING BUGS" +Report bugs to lzip\-bug@nongnu.org +Lzip home page: http://www.nongnu.org/lzip/lzip.html +.SH COPYRIGHT +Copyright \(co 2009 Antonio Diaz Diaz. +This script is free software: you have unlimited permission +to copy, distribute and modify it. diff --git a/doc/zdiff.1 b/doc/zdiff.1 new file mode 100644 index 0000000..b28acfc --- /dev/null +++ b/doc/zdiff.1 @@ -0,0 +1,53 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. +.TH ZDIFF "1" "August 2009" "Zdiff 0.2" "User Commands" +.SH NAME +Zdiff \- manual page for Zdiff 0.2 +.SH SYNOPSIS +.B zdiff +[\fIOPTIONS\fR] [\fIDIFF_OPTIONS\fR] \fIFILE1 \fR[\fIFILE2\fR] +.SH DESCRIPTION +Zdiff \- Diff/cmp wrapper for compressed files. +.PP +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. The supported compressors are gzip, bzip2, lzip and xz. +.PP +Zcmp is a shortcut for "zdiff \fB\-\-cmp\fR" +.PP +Compares FILE1 to FILE2. If FILE2 is omitted, compares FILE1 to the +uncompressed contents of FILE1.[gz|bz2|lz] (depending on the default +compressor selected). DIFF_OPTIONS are passed directly to diff or cmp. +The exit status from diff or cmp is preserved. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-V\fR, \fB\-\-version\fR +output version information and exit +.TP +\fB\-\-gzip\fR +use gzip as default decompressor +.TP +\fB\-\-bzip2\fR +use bzip2 as default decompressor +.TP +\fB\-\-lzip\fR +use lzip as default decompressor (default) +.TP +\fB\-\-xz\fR +use xz as default decompressor +.TP +\fB\-\-diff\fR +use diff to compare files (default) +.TP +\fB\-\-cmp\fR +use cmp to compare files +.SH "REPORTING BUGS" +Report bugs to lzip\-bug@nongnu.org +Lzip home page: http://www.nongnu.org/lzip/lzip.html +.SH COPYRIGHT +Copyright \(co 2009 Antonio Diaz Diaz. +This script is free software: you have unlimited permission +to copy, distribute and modify it. diff --git a/doc/zgrep.1 b/doc/zgrep.1 new file mode 100644 index 0000000..8913a96 --- /dev/null +++ b/doc/zgrep.1 @@ -0,0 +1,45 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. +.TH ZGREP "1" "August 2009" "Zgrep 0.2" "User Commands" +.SH NAME +Zgrep \- manual page for Zgrep 0.2 +.SH SYNOPSIS +.B zgrep +[\fIOPTIONS\fR] [\fIGREP_OPTIONS\fR] \fIPATTERN \fR[\fIFILES\fR] +.SH DESCRIPTION +Zgrep \- Grep wrapper for compressed files. +.PP +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 +name corresponding to the default compressor selected. The supported +compressors are gzip, bzip2, lzip and xz. +.PP +GREP_OPTIONS are passed directly to grep. +The exit status from grep is preserved. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-V\fR, \fB\-\-version\fR +output version information and exit +.TP +\fB\-\-gzip\fR +use gzip as default decompressor +.TP +\fB\-\-bzip2\fR +use bzip2 as default decompressor +.TP +\fB\-\-lzip\fR +use lzip as default decompressor (default) +.TP +\fB\-\-xz\fR +use xz as default decompressor +.SH "REPORTING BUGS" +Report bugs to lzip\-bug@nongnu.org +Lzip home page: http://www.nongnu.org/lzip/lzip.html +.SH COPYRIGHT +Copyright \(co 2009 Antonio Diaz Diaz. +This script is free software: you have unlimited permission +to copy, distribute and modify it. diff --git a/doc/zutils.info b/doc/zutils.info Binary files differnew file mode 100644 index 0000000..1229e3b --- /dev/null +++ b/doc/zutils.info diff --git a/doc/zutils.texinfo b/doc/zutils.texinfo new file mode 100644 index 0000000..6367629 --- /dev/null +++ b/doc/zutils.texinfo @@ -0,0 +1,236 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename zutils.info +@settitle Zutils +@finalout +@c %**end of header + +@set UPDATED 13 August 2009 +@set VERSION 0.2 + +@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 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 name +corresponding to the default compressor selected. The supported +compressors are gzip, bzip2, lzip and xz. + +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 default decompressor. + +@item --bzip2 +Use bzip2 as default decompressor. + +@item --lzip +Use lzip as default decompressor (default). + +@item --xz +Use xz as default decompressor. + +@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. The supported compressors are gzip, bzip2, lzip and xz. + +@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, compares +@var{file1} to the uncompressed contents of @var{file1}.[gz|bz2|lz] +(depending on the default compressor selected). @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 --gzip +Use gzip as default decompressor. + +@item --bzip2 +Use bzip2 as default decompressor. + +@item --lzip +Use lzip as default decompressor (default). + +@item --xz +Use xz as default decompressor. + +@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 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 +name corresponding to the default compressor selected. The supported +compressors are gzip, bzip2, lzip and xz. + +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 default decompressor. + +@item --bzip2 +Use bzip2 as default decompressor. + +@item --lzip +Use lzip as default decompressor (default). + +@item --xz +Use xz as default decompressor. + +@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{lzip-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 |