\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename gzip.info
+@include version.texi
@settitle Gzip User's Manual
@finalout
@setchapternewpage odd
@c %**end of header
-
-@ifinfo
@dircategory Utilities
@direntry
-* Gzip: (gzip). The gzip command for compressing files.
+* gzip: (gzip). The gzip command for compressing files.
@end direntry
-This file documents the the GNU @code{gzip} command for compressing files.
+@copying
+This file documents the GNU `gzip' command for compressing files.
-Copyright (C) 1998, 1999, 2001 Free Software Foundation, Inc.
-Copyright (C) 1992-1993 Jean-loup Gailly
+This manual is for Gzip
+(version @value{VERSION}, @value{UPDATED}),
+and documents commands for compressing and decompressing data.
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
+Copyright @copyright{} 1998, 1999, 2001, 2002 Free Software
+Foundation, Inc.
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
+Copyright @copyright{} 1992, 1993 Jean-loup Gailly
-@end ignore
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the entire
-resulting derived work is distributed under the terms of a permission
-notice identical to this one.
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
+and with the Back-Cover Texts as in (a) below. A copy of the
+license is included in the section entitled ``GNU Free Documentation
+License.''
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions,
-except that this permission notice may be stated in a translation approved
-by the Foundation.
-@end ifinfo
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software. Copies published by the Free
+Software Foundation raise funds for GNU development.''
+@end quotation
+@end copying
@titlepage
@title gzip
@subtitle The data compression program
-@subtitle Edition 1.3.2, for Gzip Version 1.3.2
-@subtitle November 2001
+@subtitle for Gzip Version @value{VERSION}
+@subtitle @value{UPDATED}
@author by Jean-loup Gailly
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1998, 1999, 2001 Free Software Foundation, Inc.
-
-Copyright @copyright{} 1992-1993 Jean-loup Gailly
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the entire
-resulting derived work is distributed under the terms of a permission
-notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions,
-except that this permission notice may be stated in a translation approved
-by the Foundation.
+@insertcopying
@end titlepage
+@contents
+
+@ifnottex
@node Top, , , (dir)
+@top Compressing Files
-@ifinfo
-This file documents the @code{gzip} command to compress files.
-@end ifinfo
+@insertcopying
+@end ifnottex
@menu
* Overview:: Preliminary information.
* Environment:: The @code{GZIP} environment variable
* Tapes:: Using @code{gzip} on tapes.
* Problems:: Reporting bugs.
+* Copying This Manual:: How to make copies of this manual.
* Concept Index:: Index of concepts.
@end menu
Files created by @code{zip} can be uncompressed by @code{gzip} only if
they have a single member compressed with the 'deflation' method. This
feature is only intended to help conversion of @code{tar.zip} files to
-the @code{tar.gz} format. To extract @code{zip} files with several
+the @code{tar.gz} format. To extract a @code{zip} file with a single
+member, use a command like @samp{gunzip <foo.zip} or @samp{gunzip -S
+.zip foo.zip}. To extract @code{zip} files with several
members, use @code{unzip} instead of @code{gunzip}.
@code{zcat} is identical to @samp{gunzip -c}. @code{zcat}
into the directory and compress all the files it finds there (or
decompress them in the case of @code{gunzip}).
+@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 @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 @samp{@var{suf}} instead of @samp{.gz}. Any suffix can be
tapes. (This example assumes you are using the GNU version of
@code{tar}.)
-@node Problems, Concept Index, Tapes, Top
+@node Problems, Copying This Manual, Tapes, Top
@chapter Reporting Bugs
@cindex bugs
a description of the bug behavior, and the input to @code{gzip} that triggered
the bug.@refill
-@node Concept Index, , Problems, Top
-@unnumbered Concept Index
+@node Copying This Manual, Concept Index, Problems, Top
+@appendix Copying This Manual
+
+@menu
+* GNU Free Documentation License:: License for copying this manual.
+@end menu
+
+@include fdl.texi
+
+@node Concept Index, , Copying This Manual, Top
+@appendix Concept Index
@printindex cp
-@contents
@bye
projects / gzip / blobdiff