X-Git-Url: https://git.gag.com/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fgzip.texi;h=7ff37adf6cd1adf698f54bfc260fc4c7124a8bad;hb=d738e90e8360e101b94fca8c79147f59565f62d8;hp=a6009d2ada14c9882b84317a6a41d716d5256f48;hpb=a2016c1de6e4884f6c8ed5cc498f3bf821c25ca4;p=debian%2Fgzip diff --git a/doc/gzip.texi b/doc/gzip.texi index a6009d2..7ff37ad 100644 --- a/doc/gzip.texi +++ b/doc/gzip.texi @@ -11,7 +11,7 @@ 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, 2009-2010 Free Software +Copyright @copyright{} 1998-1999, 2001-2002, 2006-2007, 2009-2013 Free Software Foundation, Inc. Copyright @copyright{} 1992, 1993 Jean-loup Gailly @@ -171,10 +171,10 @@ ownership and time stamps of files when compressing or decompressing. 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 @@ -195,6 +195,7 @@ Mandatory arguments to long options are mandatory for short options too. -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 @@ -207,6 +208,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. @@ -228,7 +230,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 @@ -276,6 +278,10 @@ whether an existing file should be overwritten. @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: @@ -353,6 +359,30 @@ 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 --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