Imported Debian patch 1.3.5-15

[gzip] / gzip.1

diff --git a/gzip.1 b/gzip.1
index 06986eb02eb32908daa76462da612532fb3ab8ba..8960b877012b9716f2a47f8cf6aec7ea647345a6 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


@@ -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


@@ -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