Imported Debian patch 1.3.12-5

[gzip] / gzip.1

diff --git a/gzip.1 b/gzip.1
index 06986eb02eb32908daa76462da612532fb3ab8ba..2989842b80f8ac7340a5a648e87a98417edb8d8d 100644 (file)
--- a/gzip.1
+++ b/gzip.1
@@ -121,7 +121,13 @@ Files created by
 .I zip
 can be uncompressed by gzip only if they have a single member compressed
 with the 'deflation' method. This feature is only intended to help
 .I zip
 can be uncompressed by gzip only if they have a single member compressed
 with the 'deflation' method. This feature is only intended to help

-conversion of tar.zip files to the tar.gz format. To extract zip files
+conversion of tar.zip files to the tar.gz format.  To extract a
+.I zip
+file with a single member, use a command like
+.I "gunzip <foo.zip"
+or
+.IR "gunzip -S .zip foo.zip" .
+To extract zip files

 with several members, use
 .I unzip
 instead of
 with several members, use
 .I unzip
 instead of


@@ -170,6 +176,16 @@ number of used disk blocks almost never increases.
 .I gzip
 preserves the mode, ownership and timestamps of files when compressing
 or decompressing.
 .I gzip
 preserves the mode, ownership and timestamps of files when compressing
 or decompressing.

+.PP
+The
+.I gzip
+file format is specified in P. Deutsch, \s-1GZIP\s0 file format
+specification version 4.3, <ftp://ftp.isi.edu/in-notes/rfc1952.txt>,
+Internet RFC 1952 (May 1996).  The
+.I zip
+deflation format is specified in P. Deutsch, \s-1DEFLATE\s0 Compressed
+Data Format Specification version 1.3,
+<ftp://ftp.isi.edu/in-notes/rfc1951.txt>, Internet RFC 1951 (May 1996).

 
 .SH OPTIONS
 .TP
 
 .SH OPTIONS
 .TP


@@ -194,7 +210,7 @@ is read from or written to a terminal. If the input data is not in
 a format recognized by
 .I gzip,
 and if the option --stdout is also given, copy the input data without change
 a format recognized by
 .I gzip,
 and if the option --stdout is also given, copy the input data without change

-to the standard ouput: let
+to the standard output: let

 .I zcat
 behave as
 .I cat.
 .I zcat
 behave as
 .I cat.


@@ -274,6 +290,15 @@ will descend into the directory and compress all the files it finds there
 .I gunzip
 ).
 .TP
 .I gunzip
 ).
 .TP

+.B --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
+.BR rsync (1)
+program can much more efficiently synchronize files compressed with this flag.
+.I gunzip
+cannot tell the difference between a compressed file created with this option,
+and one created without it.
+.TP

 .B \-S .suf   --suffix .suf
 Use suffix .suf instead of .gz. Any suffix can be given, but suffixes
 other than .z and .gz should be avoided to avoid confusion when files
 .B \-S .suf   --suffix .suf
 Use suffix .suf instead of .gz. Any suffix can be given, but suffixes
 other than .z and .gz should be avoided to avoid confusion when files


@@ -457,7 +482,7 @@ GNU tar. Make sure that the same block size (-b option of tar) is used
 for reading and writing compressed data on tapes.  (This example
 assumes you are using the GNU version of tar.)
 .SH BUGS
 for reading and writing compressed data on tapes.  (This example
 assumes you are using the GNU version of tar.)
 .SH BUGS

-The gzip format represents the the input size modulo 2^32, so the
+The gzip format represents the input size modulo 2^32, so the

 --list option reports incorrect uncompressed sizes and compression
 ratios for uncompressed files 4 GB and larger.  To work around this
 problem, you can use the following command to discover a large
 --list option reports incorrect uncompressed sizes and compression
 ratios for uncompressed files 4 GB and larger.  To work around this
 problem, you can use the following command to discover a large


@@ -474,7 +499,7 @@ the default compression level (-6). On some highly redundant files,
 compresses better than
 .I gzip.
 .SH "COPYRIGHT NOTICE"
 compresses better than
 .I gzip.
 .SH "COPYRIGHT NOTICE"

-Copyright \(co 1998, 1999, 2001 Free Software Foundation, Inc.
+Copyright \(co 1998, 1999, 2001, 2002 Free Software Foundation, Inc.

 .br
 Copyright \(co 1992, 1993 Jean-loup Gailly
 .PP
 .br
 Copyright \(co 1992, 1993 Jean-loup Gailly
 .PP