X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Fgzip.texi;h=7f3d4523cf15542ef16d5668a7f1d37b2d5d04f1;hb=4ee107046a0ffd91f6c60c787326a5e27b799f6d;hp=c7f8d62ad94c338c02e09b95468663c169f17c59;hpb=800deb09b422a73c1212233a93839a223ff59678;p=debian%2Fgzip diff --git a/doc/gzip.texi b/doc/gzip.texi index c7f8d62..7f3d452 100644 --- a/doc/gzip.texi +++ b/doc/gzip.texi @@ -2,23 +2,23 @@ @c %**start of header @setfilename gzip.info @include version.texi -@settitle Gzip User's Manual +@settitle GNU Gzip @finalout @setchapternewpage odd @c %**end of header @copying -This manual is for Gzip +This manual is for GNU Gzip (version @value{VERSION}, @value{UPDATED}), and documents commands for compressing and decompressing data. -Copyright @copyright{} 1998, 1999, 2001, 2002, 2006, 2007 Free -Software Foundation, Inc. +Copyright @copyright{} 1998-1999, 2001-2002, 2006-2007, 2009-2012 Free Software +Foundation, Inc. Copyright @copyright{} 1992, 1993 Jean-loup Gailly @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.2 or +under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU @@ -26,24 +26,26 @@ Free Documentation License''. @end quotation @end copying -@c Debian install-info (up through at least version 1.9.20) uses only the -@c first dircategory. But install-info 1.10.28 rejects any attempt to -@c put the more-useful individual utility first. So put the less-useful -@c general category first. -@dircategory Utilities +@dircategory Compression @direntry -* Gzip: (gzip). The gzip command for compressing files. +* Gzip: (gzip). General (de)compression of files (lzw). @end direntry @dircategory Individual utilities @direntry -* gzip: (gzip)Invoking gzip. Compress files. +* gunzip: (gzip)Overview. Decompression. +* gzexe: (gzip)Overview. Compress executables. +* zcat: (gzip)Overview. Decompression to stdout. +* zdiff: (gzip)Overview. Compare compressed files. +* zforce: (gzip)Overview. Force .gz extension on files. +* zgrep: (gzip)Overview. Search compressed files. +* zmore: (gzip)Overview. Decompression output by pages. @end direntry @titlepage -@title gzip +@title GNU gzip @subtitle The data compression program -@subtitle for Gzip Version @value{VERSION} +@subtitle for Gzip version @value{VERSION} @subtitle @value{UPDATED} @author by Jean-loup Gailly @@ -56,7 +58,7 @@ Free Documentation License''. @ifnottex @node Top -@top Compressing Files +@top GNU Gzip: General file (de)compression @insertcopying @end ifnottex @@ -69,8 +71,8 @@ Free Documentation License''. * Environment:: The @env{GZIP} environment variable * Tapes:: Using @command{gzip} on tapes. * Problems:: Reporting bugs. -* Copying This Manual:: How to make copies of this manual. -* Concept Index:: Index of concepts. +* GNU Free Documentation License:: Copying and sharing this manual. +* Concept index:: Index of concepts. @end menu @node Overview @@ -80,7 +82,7 @@ Free Documentation License''. @command{gzip} reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension @samp{.gz}, while keeping the same ownership modes, access and -modification times. (The default extension is @option{-gz} for @abbr{VMS}, +modification times. (The default extension is @samp{-gz} for @abbr{VMS}, @samp{z} for @abbr{MSDOS}, @abbr{OS/2} @abbr{FAT} and Atari.) If no files are specified or if a file name is "-", the standard input is compressed to the standard @@ -113,8 +115,9 @@ compressed file is not suitable for its file system, a new name is constructed from the original one to make it legal. @command{gunzip} takes a list of files on its command line and replaces -each file whose name ends with @samp{.gz}, @samp{.z}, @samp{.Z}, -@option{-gz}, @option{-z} or @samp{_z} and which begins with the correct +each file whose name ends with @samp{.gz}, @samp{.z} +@samp{-gz}, @samp{-z}, or @samp{_z} (ignoring case) +and which begins with the correct magic number with an uncompressed file without the original extension. @command{gunzip} also recognizes the special extensions @samp{.tgz} and @samp{.taz} as shorthands for @samp{.tar.gz} and @samp{.tar.Z} @@ -175,7 +178,7 @@ format specification version 4.3, 1996). @node Sample -@chapter Sample Output +@chapter Sample output @cindex sample Here are some realistic examples of running @command{gzip}. @@ -204,6 +207,7 @@ Mandatory arguments to long options are mandatory for short options too. -V, --version display version number -1, --fast compress faster -9, --best compress better + --rsyncable Make rsync-friendly archive With no FILE, or when FILE is -, read standard input. @@ -225,7 +229,7 @@ stopping on the first failure: find . -name '* *' -prune -o -name '*.gz' -type f -print | sed " - s/'/'\\''/g + s/'/'\\\\''/g s/^\\(.*\\)\\.gz$/gunzip <'\\1.gz' >'\\1'/ " | sh -e @@ -350,6 +354,22 @@ specified on the command line are directories, @command{gzip} will descend into the directory and compress all the files it finds there (or decompress them in the case of @command{gunzip}). +@item --rsyncable +While compressing, synchronize the output occasionally based on the +input. This can reduce the compression slightly in some cases, but +means that the @code{rsync} program can take advantage of similarities +in the uncompressed input when syncronizing two files compressed with +this flag. @code{gunzip} cannot tell the difference between a +compressed file created with this option, and one created without it. + +@item --rsyncable +While compressing, synchronize the output occasionally based on +the input. This increases size by less than 1 percent most +cases, but means that the @command{rsync} program can much more efficiently +synchronize files compressed with this flag. @command{gunzip} +cannot tell the difference between a compressed file created +with this option, and one created without it. + @item --suffix @var{suf} @itemx -S @var{suf} Use suffix @var{suf} instead of @samp{.gz}. Any suffix can be @@ -511,17 +531,13 @@ a description of the bug behavior, and the input to @command{gzip} that triggered the bug.@refill -@node Copying This Manual -@appendix Copying This Manual - -@menu -* GNU Free Documentation License:: License for copying this manual. -@end menu +@node GNU Free Documentation License +@appendix GNU Free Documentation License @include fdl.texi -@node Concept Index -@appendix Concept Index +@node Concept index +@appendix Concept index @printindex cp