@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-2013 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
@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
@ifnottex
@node Top
-@top Compressing Files
+@top GNU Gzip: General file (de)compression
@insertcopying
@end ifnottex
* 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
@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
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}
The @command{gzip} file format is specified in P. Deutsch, @sc{gzip} file
format specification version 4.3,
-@uref{ftp://ftp.isi.edu/in-notes/rfc1952.txt, Internet @abbr{RFC} 1952} (May
+@uref{http://www.ietf.org/rfc/rfc1952.txt, Internet @abbr{RFC} 1952} (May
1996). The @command{zip} deflation format is specified in P. Deutsch,
@sc{deflate} Compressed Data Format Specification version 1.3,
-@uref{ftp://ftp.isi.edu/in-notes/rfc1951.txt, Internet @abbr{RFC} 1951} (May
+@uref{http://www.ietf.org/rfc/rfc1951.txt, Internet @abbr{RFC} 1951} (May
1996).
@node Sample
-@chapter Sample Output
+@chapter Sample output
@cindex sample
Here are some realistic examples of running @command{gzip}.
-d, --decompress decompress
-f, --force force overwrite of output file and compress links
-h, --help give this help
+ -k, --keep keep (don't delete) input files
-l, --list list compressed file contents
-L, --license display software license
-n, --no-name do not save or restore the original name and time stamp
-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.
find . -name '*
*' -prune -o -name '*.gz' -type f -print |
sed "
- s/'/'\\''/g
+ s/'/'\\\\''/g
s/^\\(.*\\)\\.gz$/gunzip <'\\1.gz' >'\\1'/
" |
sh -e
@itemx -h
Print an informative help message describing the options then quit.
+@item --keep
+@itemx -k
+Keep (don't delete) input files during compression or decompression.
+
@item --list
@itemx -l
For each compressed file, list the following fields:
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 --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 --suffix @var{suf}
@itemx -S @var{suf}
Use suffix @var{suf} instead of @samp{.gz}. Any suffix can be
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
projects / debian / gzip / blobdiff