X-Git-Url: https://git.cworth.org/git?p=gzip;a=blobdiff_plain;f=gzip.info;h=ae999aec417ba89abaf708bf4e6e28c30bc7e56d;hp=21a2d9f31ffdbbd5083728e070f3a4e4811e4d9e;hb=8ba3484138b5d1e72fd4ef49d27159263cb6bea6;hpb=db00b4e39677b0dbf3ea6f7694e0eac7be4ef141 diff --git a/gzip.info b/gzip.info index 21a2d9f..ae999ae 100644 --- a/gzip.info +++ b/gzip.info @@ -1,6 +1,13 @@ -This is gzip.info, produced by makeinfo version 4.2 from gzip.texi. +This is gzip.info, produced by makeinfo version 4.7 from gzip.texi. -This manual is for Gzip (version 1.3.5, 29 September 2002), and +INFO-DIR-SECTION Utilities +START-INFO-DIR-ENTRY +* gzip: (gzip). The gzip command for compressing files. +END-INFO-DIR-ENTRY + + This file documents the GNU `gzip' command for compressing files. + + This manual is for Gzip (version 1.3.5, 10 September 2006), and documents commands for compressing and decompressing data. Copyright (C) 1998, 1999, 2001, 2002 Free Software Foundation, Inc. @@ -18,16 +25,6 @@ documents commands for compressing and decompressing data. (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." - -INFO-DIR-SECTION Individual utilities -START-INFO-DIR-ENTRY -* gzip: (gzip)Invoking gzip. Compress files. -END-INFO-DIR-ENTRY - -INFO-DIR-SECTION Utilities -START-INFO-DIR-ENTRY -* Gzip: (gzip). The gzip command for compressing files. -END-INFO-DIR-ENTRY  File: gzip.info, Node: Top, Up: (dir) @@ -35,7 +32,9 @@ File: gzip.info, Node: Top, Up: (dir) Compressing Files ***************** -This manual is for Gzip (version 1.3.5, 29 September 2002), and +This file documents the GNU `gzip' command for compressing files. + + This manual is for Gzip (version 1.3.5, 10 September 2006), and documents commands for compressing and decompressing data. Copyright (C) 1998, 1999, 2001, 2002 Free Software Foundation, Inc. @@ -53,7 +52,7 @@ documents commands for compressing and decompressing data. (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." - + * Menu: * Overview:: Preliminary information. @@ -69,10 +68,10 @@ documents commands for compressing and decompressing data.  File: gzip.info, Node: Overview, Next: Sample, Up: Top -Overview -******** +1 Overview +********** - `gzip' reduces the size of the named files using Lempel-Ziv coding +`gzip' reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension `.gz', while keeping the same ownership modes, access and modification times. (The default extension is `-gz' for VMS, `z' for @@ -157,10 +156,10 @@ Format Specification version 1.3, Internet RFC 1951  File: gzip.info, Node: Sample, Next: Invoking gzip, Prev: Overview, Up: Top -Sample Output -************* +2 Sample Output +*************** - Here are some realistic examples of running `gzip'. +Here are some realistic examples of running `gzip'. This is the output of the command `gzip -h': @@ -199,10 +198,10 @@ destroying the original:  File: gzip.info, Node: Invoking gzip, Next: Advanced usage, Prev: Sample, Up: Top -Invoking `gzip' -*************** +3 Invoking `gzip' +***************** - The format for running the `gzip' program is: +The format for running the `gzip' program is: gzip OPTION ... @@ -305,6 +304,15 @@ Invoking `gzip' descend into the directory and compress all the files it finds there (or decompress them in the case of `gunzip'). +`--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 `rsync' program can take advantage of similarities + in the uncompressed input when syncronizing two files compressed + with this flag. `gunzip' cannot tell the difference between a + compressed file created with this option, and one created without + it. + `--suffix SUF' `-S SUF' Use suffix `SUF' instead of `.gz'. Any suffix can be given, but @@ -345,13 +353,13 @@ Invoking `gzip'  File: gzip.info, Node: Advanced usage, Next: Environment, Prev: Invoking gzip, Up: Top -Advanced usage -************** +4 Advanced usage +**************** - Multiple compressed files can be concatenated. In this case, -`gunzip' will extract all members at once. If one member is damaged, -other members might still be recovered after removal of the damaged -member. Better compression can be usually obtained if all members are +Multiple compressed files can be concatenated. In this case, `gunzip' +will extract all members at once. If one member is damaged, other +members might still be recovered after removal of the damaged member. +Better compression can be usually obtained if all members are decompressed and then recompressed in a single step. This is an example of concatenating `gzip' files: @@ -397,10 +405,10 @@ replacement.  File: gzip.info, Node: Environment, Next: Tapes, Prev: Advanced usage, Up: Top -Environment -*********** +5 Environment +************* - The environment variable `GZIP' can hold a set of default options for +The environment variable `GZIP' can hold a set of default options for `gzip'. These options are interpreted first and can be overwritten by explicit command line parameters. For example: @@ -414,17 +422,16 @@ avoid a conflict with the symbol set for invocation of the program.  File: gzip.info, Node: Tapes, Next: Problems, Prev: Environment, Up: Top -Using `gzip' on tapes -********************* +6 Using `gzip' on tapes +*********************** - When writing compressed data to a tape, it is generally necessary to -pad the output with zeroes up to a block boundary. When the data is -read and the whole block is passed to `gunzip' for decompression, -`gunzip' detects that there is extra trailing garbage after the -compressed data and emits a warning by default if the garbage contains -nonzero bytes. You have to use the `--quiet' option to suppress the -warning. This option can be set in the `GZIP' environment variable, as -in: +When writing compressed data to a tape, it is generally necessary to pad +the output with zeroes up to a block boundary. When the data is read and +the whole block is passed to `gunzip' for decompression, `gunzip' +detects that there is extra trailing garbage after the compressed data +and emits a warning by default if the garbage contains nonzero bytes. +You have to use the `--quiet' option to suppress the warning. This +option can be set in the `GZIP' environment variable, as in: for sh: GZIP="-q" tar -xfz --block-compress /dev/rst0 for csh: (setenv GZIP "-q"; tar -xfz --block-compress /dev/rst0) @@ -437,10 +444,10 @@ of `tar') is used for reading and writing compressed data on tapes.  File: gzip.info, Node: Problems, Next: Copying This Manual, Prev: Tapes, Up: Top -Reporting Bugs -************** +7 Reporting Bugs +**************** - If you find a bug in `gzip', please send electronic mail to +If you find a bug in `gzip', please send electronic mail to . Include the version number, which you can find by running `gzip -V'. Also include in your message the hardware and operating system, the compiler used to compile `gzip', a description of @@ -449,8 +456,8 @@ the bug behavior, and the input to `gzip' that triggered the bug.  File: gzip.info, Node: Copying This Manual, Next: Concept Index, Prev: Problems, Up: Top -Copying This Manual -******************* +Appendix A Copying This Manual +****************************** * Menu: @@ -459,13 +466,14 @@ Copying This Manual  File: gzip.info, Node: GNU Free Documentation License, Up: Copying This Manual -GNU Free Documentation License -============================== +A.1 GNU Free Documentation License +================================== Version 1.1, March 2000 + Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA - + Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. @@ -815,10 +823,10 @@ GNU Free Documentation License you may choose any version ever published (not as a draft) by the Free Software Foundation. -ADDENDUM: How to use this License for your documents ----------------------------------------------------- +A.1.1 ADDENDUM: How to use this License for your documents +---------------------------------------------------------- - To use this License in a document you have written, include a copy of +To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: @@ -844,34 +852,36 @@ permit their use in free software.  File: gzip.info, Node: Concept Index, Prev: Copying This Manual, Up: Top -Concept Index -************* +Appendix B Concept Index +************************ +[index] * Menu: -* bugs: Problems. -* concatenated files: Advanced usage. -* Environment: Environment. +* bugs: Problems. (line 6) +* concatenated files: Advanced usage. (line 6) +* Environment: Environment. (line 6) * FDL, GNU Free Documentation License: GNU Free Documentation License. -* invoking: Invoking gzip. -* options: Invoking gzip. -* overview: Overview. -* sample: Sample. -* tapes: Tapes. + (line 6) +* invoking: Invoking gzip. (line 6) +* options: Invoking gzip. (line 6) +* overview: Overview. (line 6) +* sample: Sample. (line 6) +* tapes: Tapes. (line 6)  Tag Table: -Node: Top1258 -Node: Overview2630 -Node: Sample7390 -Node: Invoking gzip9051 -Node: Advanced usage14032 -Node: Environment15621 -Node: Tapes16189 -Node: Problems17203 -Node: Copying This Manual17661 -Node: GNU Free Documentation License17877 -Node: Concept Index37741 +Node: Top1170 +Node: Overview2609 +Node: Sample7370 +Node: Invoking gzip9032 +Node: Advanced usage14463 +Node: Environment16053 +Node: Tapes16622 +Node: Problems17637 +Node: Copying This Manual18096 +Node: GNU Free Documentation License18334 +Node: Concept Index38211  End Tag Table