]> git.cworth.org Git - gzip/blob - gzip.info
21a2d9f31ffdbbd5083728e070f3a4e4811e4d9e
[gzip] / gzip.info
1 This is gzip.info, produced by makeinfo version 4.2 from gzip.texi.
2
3 This manual is for Gzip (version 1.3.5, 29 September 2002), and
4 documents commands for compressing and decompressing data.
5
6    Copyright (C) 1998, 1999, 2001, 2002 Free Software Foundation, Inc.
7
8    Copyright (C) 1992, 1993 Jean-loup Gailly
9
10      Permission is granted to copy, distribute and/or modify this
11      document under the terms of the GNU Free Documentation License,
12      Version 1.1 or any later version published by the Free Software
13      Foundation; with no Invariant Sections, with the Front-Cover texts
14      being "A GNU Manual," and with the Back-Cover Texts as in (a)
15      below.  A copy of the license is included in the section entitled
16      "GNU Free Documentation License."
17
18      (a) The FSF's Back-Cover Text is: "You have freedom to copy and
19      modify this GNU Manual, like GNU software.  Copies published by
20      the Free Software Foundation raise funds for GNU development."
21    
22 INFO-DIR-SECTION Individual utilities
23 START-INFO-DIR-ENTRY
24 * gzip: (gzip)Invoking gzip.                    Compress files.
25 END-INFO-DIR-ENTRY
26
27 INFO-DIR-SECTION Utilities
28 START-INFO-DIR-ENTRY
29 * Gzip: (gzip).                 The gzip command for compressing files.
30 END-INFO-DIR-ENTRY
31
32 \1f
33 File: gzip.info,  Node: Top,  Up: (dir)
34
35 Compressing Files
36 *****************
37
38 This manual is for Gzip (version 1.3.5, 29 September 2002), and
39 documents commands for compressing and decompressing data.
40
41    Copyright (C) 1998, 1999, 2001, 2002 Free Software Foundation, Inc.
42
43    Copyright (C) 1992, 1993 Jean-loup Gailly
44
45      Permission is granted to copy, distribute and/or modify this
46      document under the terms of the GNU Free Documentation License,
47      Version 1.1 or any later version published by the Free Software
48      Foundation; with no Invariant Sections, with the Front-Cover texts
49      being "A GNU Manual," and with the Back-Cover Texts as in (a)
50      below.  A copy of the license is included in the section entitled
51      "GNU Free Documentation License."
52
53      (a) The FSF's Back-Cover Text is: "You have freedom to copy and
54      modify this GNU Manual, like GNU software.  Copies published by
55      the Free Software Foundation raise funds for GNU development."
56    
57 * Menu:
58
59 * Overview::            Preliminary information.
60 * Sample::              Sample output from `gzip'.
61 * Invoking gzip::       How to run `gzip'.
62 * Advanced usage::      Concatenated files.
63 * Environment::         The `GZIP' environment variable
64 * Tapes::               Using `gzip' on tapes.
65 * Problems::            Reporting bugs.
66 * Copying This Manual:: How to make copies of this manual.
67 * Concept Index::       Index of concepts.
68
69 \1f
70 File: gzip.info,  Node: Overview,  Next: Sample,  Up: Top
71
72 Overview
73 ********
74
75    `gzip' reduces the size of the named files using Lempel-Ziv coding
76 (LZ77).  Whenever possible, each file is replaced by one with the
77 extension `.gz', while keeping the same ownership modes, access and
78 modification times.  (The default extension is `-gz' for VMS, `z' for
79 MSDOS, OS/2 FAT and Atari.)  If no files are specified or if a file
80 name is "-", the standard input is compressed to the standard output.
81 `gzip' will only attempt to compress regular files.  In particular, it
82 will ignore symbolic links.
83
84    If the new file name is too long for its file system, `gzip'
85 truncates it.  `gzip' attempts to truncate only the parts of the file
86 name longer than 3 characters.  (A part is delimited by dots.) If the
87 name consists of small parts only, the longest parts are truncated.
88 For example, if file names are limited to 14 characters, gzip.msdos.exe
89 is compressed to gzi.msd.exe.gz.  Names are not truncated on systems
90 which do not have a limit on file name length.
91
92    By default, `gzip' keeps the original file name and timestamp in the
93 compressed file. These are used when decompressing the file with the
94 `-N' option. This is useful when the compressed file name was truncated
95 or when the time stamp was not preserved after a file transfer.
96
97    Compressed files can be restored to their original form using `gzip
98 -d' or `gunzip' or `zcat'.  If the original name saved in the
99 compressed file is not suitable for its file system, a new name is
100 constructed from the original one to make it legal.
101
102    `gunzip' takes a list of files on its command line and replaces each
103 file whose name ends with `.gz', `.z', `.Z', `-gz', `-z' or `_z' and
104 which begins with the correct magic number with an uncompressed file
105 without the original extension.  `gunzip' also recognizes the special
106 extensions `.tgz' and `.taz' as shorthands for `.tar.gz' and `.tar.Z'
107 respectively. When compressing, `gzip' uses the `.tgz' extension if
108 necessary instead of truncating a file with a `.tar' extension.
109
110    `gunzip' can currently decompress files created by `gzip', `zip',
111 `compress' or `pack'. The detection of the input format is automatic.
112 When using the first two formats, `gunzip' checks a 32 bit CRC (cyclic
113 redundancy check). For `pack', `gunzip' checks the uncompressed length.
114 The `compress' format was not designed to allow consistency checks.
115 However `gunzip' is sometimes able to detect a bad `.Z' file. If you
116 get an error when uncompressing a `.Z' file, do not assume that the
117 `.Z' file is correct simply because the standard `uncompress' does not
118 complain.  This generally means that the standard `uncompress' does not
119 check its input, and happily generates garbage output.  The SCO
120 `compress -H' format (`lzh' compression method) does not include a CRC
121 but also allows some consistency checks.
122
123    Files created by `zip' can be uncompressed by `gzip' only if they
124 have a single member compressed with the 'deflation' method. This
125 feature is only intended to help conversion of `tar.zip' files to the
126 `tar.gz' format.  To extract a `zip' file with a single member, use a
127 command like `gunzip <foo.zip' or `gunzip -S .zip foo.zip'.  To extract
128 `zip' files with several members, use `unzip' instead of `gunzip'.
129
130    `zcat' is identical to `gunzip -c'.  `zcat' uncompresses either a
131 list of files on the command line or its standard input and writes the
132 uncompressed data on standard output.  `zcat' will uncompress files
133 that have the correct magic number whether they have a `.gz' suffix or
134 not.
135
136    `gzip' uses the Lempel-Ziv algorithm used in `zip' and PKZIP.  The
137 amount of compression obtained depends on the size of the input and the
138 distribution of common substrings.  Typically, text such as source code
139 or English is reduced by 60-70%.  Compression is generally much better
140 than that achieved by LZW (as used in `compress'), Huffman coding (as
141 used in `pack'), or adaptive Huffman coding (`compact').
142
143    Compression is always performed, even if the compressed file is
144 slightly larger than the original. The worst case expansion is a few
145 bytes for the `gzip' file header, plus 5 bytes every 32K block, or an
146 expansion ratio of 0.015% for large files. Note that the actual number
147 of used disk blocks almost never increases. `gzip' preserves the mode,
148 ownership and timestamps of files when compressing or decompressing.
149
150    The `gzip' file format is specified in P. Deutsch, GZIP file format
151 specification version 4.3, Internet RFC 1952
152 (ftp://ftp.isi.edu/in-notes/rfc1952.txt) (May 1996).  The `zip'
153 deflation format is specified in P. Deutsch, DEFLATE Compressed Data
154 Format Specification version 1.3, Internet RFC 1951
155 (ftp://ftp.isi.edu/in-notes/rfc1951.txt) (May 1996).
156
157 \1f
158 File: gzip.info,  Node: Sample,  Next: Invoking gzip,  Prev: Overview,  Up: Top
159
160 Sample Output
161 *************
162
163    Here are some realistic examples of running `gzip'.
164
165    This is the output of the command `gzip -h':
166
167      gzip 1.3
168      (1999-12-21)
169      usage: gzip [-cdfhlLnNrtvV19] [-S suffix] [file ...]
170       -c --stdout      write on standard output, keep original files unchanged
171       -d --decompress  decompress
172       -f --force       force overwrite of output file and compress links
173       -h --help        give this help
174       -l --list        list compressed file contents
175       -L --license     display software license
176       -n --no-name     do not save or restore the original name and time stamp
177       -N --name        save or restore the original name and time stamp
178       -q --quiet       suppress all warnings
179       -r --recursive   operate recursively on directories
180       -S .suf  --suffix .suf     use suffix .suf on compressed files
181       -t --test        test compressed file integrity
182       -v --verbose     verbose mode
183       -V --version     display version number
184       -1 --fast        compress faster
185       -9 --best        compress better
186       file...          files to (de)compress. If none given, use standard input.
187      Report bugs to <bug-gzip@gnu.org>.
188
189    This is the output of the command `gzip -v texinfo.tex':
190
191      texinfo.tex:             69.7% -- replaced with texinfo.tex.gz
192
193    The following command will find all `gzip' files in the current
194 directory and subdirectories, and extract them in place without
195 destroying the original:
196
197      find . -name '*.gz' -print | sed 's/^\(.*\)[.]gz$/gunzip < "&" > "\1"/' | sh
198
199 \1f
200 File: gzip.info,  Node: Invoking gzip,  Next: Advanced usage,  Prev: Sample,  Up: Top
201
202 Invoking `gzip'
203 ***************
204
205    The format for running the `gzip' program is:
206
207      gzip OPTION ...
208
209    `gzip' supports the following options:
210
211 `--stdout'
212 `--to-stdout'
213 `-c'
214      Write output on standard output; keep original files unchanged.
215      If there are several input files, the output consists of a
216      sequence of independently compressed members. To obtain better
217      compression, concatenate all input files before compressing them.
218
219 `--decompress'
220 `--uncompress'
221 `-d'
222      Decompress.
223
224 `--force'
225 `-f'
226      Force compression or decompression even if the file has multiple
227      links or the corresponding file already exists, or if the
228      compressed data is read from or written to a terminal. If the
229      input data is not in a format recognized by `gzip', and if the
230      option `--stdout' is also given, copy the input data without
231      change to the standard output: let `zcat' behave as `cat'. If `-f'
232      is not given, and when not running in the background, `gzip'
233      prompts to verify whether an existing file should be overwritten.
234
235 `--help'
236 `-h'
237      Print an informative help message describing the options then quit.
238
239 `--list'
240 `-l'
241      For each compressed file, list the following fields:
242
243           compressed size: size of the compressed file
244           uncompressed size: size of the uncompressed file
245           ratio: compression ratio (0.0% if unknown)
246           uncompressed_name: name of the uncompressed file
247
248      The uncompressed size is given as `-1' for files not in `gzip'
249      format, such as compressed `.Z' files. To get the uncompressed
250      size for such a file, you can use:
251
252           zcat file.Z | wc -c
253
254      In combination with the `--verbose' option, the following fields
255      are also displayed:
256
257           method: compression method (deflate,compress,lzh,pack)
258           crc: the 32-bit CRC of the uncompressed data
259           date & time: time stamp for the uncompressed file
260
261      The crc is given as ffffffff for a file not in gzip format.
262
263      With `--verbose', the size totals and compression ratio for all
264      files is also displayed, unless some sizes are unknown. With
265      `--quiet', the title and totals lines are not displayed.
266
267      The `gzip' format represents the the input size modulo 2^32, so
268      the uncompressed size and compression ratio are listed incorrectly
269      for uncompressed files 4 GB and larger. To work around this
270      problem, you can use the following command to discover a large
271      uncompressed file's true size:
272
273           zcat file.gz | wc -c
274
275 `--license'
276 `-L'
277      Display the `gzip' license then quit.
278
279 `--no-name'
280 `-n'
281      When compressing, do not save the original file name and time
282      stamp by default. (The original name is always saved if the name
283      had to be truncated.) When decompressing, do not restore the
284      original file name if present (remove only the `gzip' suffix from
285      the compressed file name) and do not restore the original time
286      stamp if present (copy it from the compressed file). This option
287      is the default when decompressing.
288
289 `--name'
290 `-N'
291      When compressing, always save the original file name and time
292      stamp; this is the default. When decompressing, restore the
293      original file name and time stamp if present. This option is
294      useful on systems which have a limit on file name length or when
295      the time stamp has been lost after a file transfer.
296
297 `--quiet'
298 `-q'
299      Suppress all warning messages.
300
301 `--recursive'
302 `-r'
303      Travel the directory structure recursively. If any of the file
304      names specified on the command line are directories, `gzip' will
305      descend into the directory and compress all the files it finds
306      there (or decompress them in the case of `gunzip').
307
308 `--suffix SUF'
309 `-S SUF'
310      Use suffix `SUF' instead of `.gz'. Any suffix can be given, but
311      suffixes other than `.z' and `.gz' should be avoided to avoid
312      confusion when files are transferred to other systems.  A null
313      suffix forces gunzip to try decompression on all given files
314      regardless of suffix, as in:
315
316           gunzip -S "" *        (*.* for MSDOS)
317
318      Previous versions of gzip used the `.z' suffix. This was changed to
319      avoid a conflict with `pack'.
320
321 `--test'
322 `-t'
323      Test. Check the compressed file integrity.
324
325 `--verbose'
326 `-v'
327      Verbose. Display the name and percentage reduction for each file
328      compressed.
329
330 `--version'
331 `-V'
332      Version. Display the version number and compilation options, then
333      quit.
334
335 `--fast'
336 `--best'
337 `-N'
338      Regulate the speed of compression using the specified digit N,
339      where `-1' or `--fast' indicates the fastest compression method
340      (less compression) and `--best' or `-9' indicates the slowest
341      compression method (optimal compression).  The default compression
342      level is `-6' (that is, biased towards high compression at expense
343      of speed).
344
345 \1f
346 File: gzip.info,  Node: Advanced usage,  Next: Environment,  Prev: Invoking gzip,  Up: Top
347
348 Advanced usage
349 **************
350
351    Multiple compressed files can be concatenated. In this case,
352 `gunzip' will extract all members at once. If one member is damaged,
353 other members might still be recovered after removal of the damaged
354 member. Better compression can be usually obtained if all members are
355 decompressed and then recompressed in a single step.
356
357    This is an example of concatenating `gzip' files:
358
359      gzip -c file1  > foo.gz
360      gzip -c file2 >> foo.gz
361
362    Then
363
364      gunzip -c foo
365
366    is equivalent to
367
368      cat file1 file2
369
370    In case of damage to one member of a `.gz' file, other members can
371 still be recovered (if the damaged member is removed). However, you can
372 get better compression by compressing all members at once:
373
374      cat file1 file2 | gzip > foo.gz
375
376    compresses better than
377
378      gzip -c file1 file2 > foo.gz
379
380    If you want to recompress concatenated files to get better
381 compression, do:
382
383      zcat old.gz | gzip > new.gz
384
385    If a compressed file consists of several members, the uncompressed
386 size and CRC reported by the `--list' option applies to the last member
387 only. If you need the uncompressed size for all members, you can use:
388
389      zcat file.gz | wc -c
390
391    If you wish to create a single archive file with multiple members so
392 that members can later be extracted independently, use an archiver such
393 as `tar' or `zip'. GNU `tar' supports the `-z' option to invoke `gzip'
394 transparently. `gzip' is designed as a complement to `tar', not as a
395 replacement.
396
397 \1f
398 File: gzip.info,  Node: Environment,  Next: Tapes,  Prev: Advanced usage,  Up: Top
399
400 Environment
401 ***********
402
403    The environment variable `GZIP' can hold a set of default options for
404 `gzip'.  These options are interpreted first and can be overwritten by
405 explicit command line parameters.  For example:
406
407      for sh:    GZIP="-8v --name"; export GZIP
408      for csh:   setenv GZIP "-8v --name"
409      for MSDOS: set GZIP=-8v --name
410
411    On Vax/VMS, the name of the environment variable is `GZIP_OPT', to
412 avoid a conflict with the symbol set for invocation of the program.
413
414 \1f
415 File: gzip.info,  Node: Tapes,  Next: Problems,  Prev: Environment,  Up: Top
416
417 Using `gzip' on tapes
418 *********************
419
420    When writing compressed data to a tape, it is generally necessary to
421 pad the output with zeroes up to a block boundary. When the data is
422 read and the whole block is passed to `gunzip' for decompression,
423 `gunzip' detects that there is extra trailing garbage after the
424 compressed data and emits a warning by default if the garbage contains
425 nonzero bytes. You have to use the `--quiet' option to suppress the
426 warning. This option can be set in the `GZIP' environment variable, as
427 in:
428
429      for sh:    GZIP="-q"  tar -xfz --block-compress /dev/rst0
430      for csh:   (setenv GZIP "-q"; tar -xfz --block-compress /dev/rst0)
431
432    In the above example, `gzip' is invoked implicitly by the `-z'
433 option of GNU `tar'.  Make sure that the same block size (`-b' option
434 of `tar') is used for reading and writing compressed data on tapes.
435 (This example assumes you are using the GNU version of `tar'.)
436
437 \1f
438 File: gzip.info,  Node: Problems,  Next: Copying This Manual,  Prev: Tapes,  Up: Top
439
440 Reporting Bugs
441 **************
442
443    If you find a bug in `gzip', please send electronic mail to
444 <bug-gzip@gnu.org>.  Include the version number, which you can find by
445 running `gzip -V'.  Also include in your message the hardware and
446 operating system, the compiler used to compile `gzip', a description of
447 the bug behavior, and the input to `gzip' that triggered the bug.
448
449 \1f
450 File: gzip.info,  Node: Copying This Manual,  Next: Concept Index,  Prev: Problems,  Up: Top
451
452 Copying This Manual
453 *******************
454
455 * Menu:
456
457 * GNU Free Documentation License::  License for copying this manual.
458
459 \1f
460 File: gzip.info,  Node: GNU Free Documentation License,  Up: Copying This Manual
461
462 GNU Free Documentation License
463 ==============================
464
465                         Version 1.1, March 2000
466      Copyright (C) 2000 Free Software Foundation, Inc.
467      59 Temple Place, Suite 330, Boston, MA  02111-1307, USA
468      
469      Everyone is permitted to copy and distribute verbatim copies
470      of this license document, but changing it is not allowed.
471
472   0. PREAMBLE
473
474      The purpose of this License is to make a manual, textbook, or other
475      written document "free" in the sense of freedom: to assure everyone
476      the effective freedom to copy and redistribute it, with or without
477      modifying it, either commercially or noncommercially.  Secondarily,
478      this License preserves for the author and publisher a way to get
479      credit for their work, while not being considered responsible for
480      modifications made by others.
481
482      This License is a kind of "copyleft", which means that derivative
483      works of the document must themselves be free in the same sense.
484      It complements the GNU General Public License, which is a copyleft
485      license designed for free software.
486
487      We have designed this License in order to use it for manuals for
488      free software, because free software needs free documentation: a
489      free program should come with manuals providing the same freedoms
490      that the software does.  But this License is not limited to
491      software manuals; it can be used for any textual work, regardless
492      of subject matter or whether it is published as a printed book.
493      We recommend this License principally for works whose purpose is
494      instruction or reference.
495
496   1. APPLICABILITY AND DEFINITIONS
497
498      This License applies to any manual or other work that contains a
499      notice placed by the copyright holder saying it can be distributed
500      under the terms of this License.  The "Document", below, refers to
501      any such manual or work.  Any member of the public is a licensee,
502      and is addressed as "you".
503
504      A "Modified Version" of the Document means any work containing the
505      Document or a portion of it, either copied verbatim, or with
506      modifications and/or translated into another language.
507
508      A "Secondary Section" is a named appendix or a front-matter
509      section of the Document that deals exclusively with the
510      relationship of the publishers or authors of the Document to the
511      Document's overall subject (or to related matters) and contains
512      nothing that could fall directly within that overall subject.
513      (For example, if the Document is in part a textbook of
514      mathematics, a Secondary Section may not explain any mathematics.)
515      The relationship could be a matter of historical connection with
516      the subject or with related matters, or of legal, commercial,
517      philosophical, ethical or political position regarding them.
518
519      The "Invariant Sections" are certain Secondary Sections whose
520      titles are designated, as being those of Invariant Sections, in
521      the notice that says that the Document is released under this
522      License.
523
524      The "Cover Texts" are certain short passages of text that are
525      listed, as Front-Cover Texts or Back-Cover Texts, in the notice
526      that says that the Document is released under this License.
527
528      A "Transparent" copy of the Document means a machine-readable copy,
529      represented in a format whose specification is available to the
530      general public, whose contents can be viewed and edited directly
531      and straightforwardly with generic text editors or (for images
532      composed of pixels) generic paint programs or (for drawings) some
533      widely available drawing editor, and that is suitable for input to
534      text formatters or for automatic translation to a variety of
535      formats suitable for input to text formatters.  A copy made in an
536      otherwise Transparent file format whose markup has been designed
537      to thwart or discourage subsequent modification by readers is not
538      Transparent.  A copy that is not "Transparent" is called "Opaque".
539
540      Examples of suitable formats for Transparent copies include plain
541      ASCII without markup, Texinfo input format, LaTeX input format,
542      SGML or XML using a publicly available DTD, and
543      standard-conforming simple HTML designed for human modification.
544      Opaque formats include PostScript, PDF, proprietary formats that
545      can be read and edited only by proprietary word processors, SGML
546      or XML for which the DTD and/or processing tools are not generally
547      available, and the machine-generated HTML produced by some word
548      processors for output purposes only.
549
550      The "Title Page" means, for a printed book, the title page itself,
551      plus such following pages as are needed to hold, legibly, the
552      material this License requires to appear in the title page.  For
553      works in formats which do not have any title page as such, "Title
554      Page" means the text near the most prominent appearance of the
555      work's title, preceding the beginning of the body of the text.
556
557   2. VERBATIM COPYING
558
559      You may copy and distribute the Document in any medium, either
560      commercially or noncommercially, provided that this License, the
561      copyright notices, and the license notice saying this License
562      applies to the Document are reproduced in all copies, and that you
563      add no other conditions whatsoever to those of this License.  You
564      may not use technical measures to obstruct or control the reading
565      or further copying of the copies you make or distribute.  However,
566      you may accept compensation in exchange for copies.  If you
567      distribute a large enough number of copies you must also follow
568      the conditions in section 3.
569
570      You may also lend copies, under the same conditions stated above,
571      and you may publicly display copies.
572
573   3. COPYING IN QUANTITY
574
575      If you publish printed copies of the Document numbering more than
576      100, and the Document's license notice requires Cover Texts, you
577      must enclose the copies in covers that carry, clearly and legibly,
578      all these Cover Texts: Front-Cover Texts on the front cover, and
579      Back-Cover Texts on the back cover.  Both covers must also clearly
580      and legibly identify you as the publisher of these copies.  The
581      front cover must present the full title with all words of the
582      title equally prominent and visible.  You may add other material
583      on the covers in addition.  Copying with changes limited to the
584      covers, as long as they preserve the title of the Document and
585      satisfy these conditions, can be treated as verbatim copying in
586      other respects.
587
588      If the required texts for either cover are too voluminous to fit
589      legibly, you should put the first ones listed (as many as fit
590      reasonably) on the actual cover, and continue the rest onto
591      adjacent pages.
592
593      If you publish or distribute Opaque copies of the Document
594      numbering more than 100, you must either include a
595      machine-readable Transparent copy along with each Opaque copy, or
596      state in or with each Opaque copy a publicly-accessible
597      computer-network location containing a complete Transparent copy
598      of the Document, free of added material, which the general
599      network-using public has access to download anonymously at no
600      charge using public-standard network protocols.  If you use the
601      latter option, you must take reasonably prudent steps, when you
602      begin distribution of Opaque copies in quantity, to ensure that
603      this Transparent copy will remain thus accessible at the stated
604      location until at least one year after the last time you
605      distribute an Opaque copy (directly or through your agents or
606      retailers) of that edition to the public.
607
608      It is requested, but not required, that you contact the authors of
609      the Document well before redistributing any large number of
610      copies, to give them a chance to provide you with an updated
611      version of the Document.
612
613   4. MODIFICATIONS
614
615      You may copy and distribute a Modified Version of the Document
616      under the conditions of sections 2 and 3 above, provided that you
617      release the Modified Version under precisely this License, with
618      the Modified Version filling the role of the Document, thus
619      licensing distribution and modification of the Modified Version to
620      whoever possesses a copy of it.  In addition, you must do these
621      things in the Modified Version:
622
623        A. Use in the Title Page (and on the covers, if any) a title
624           distinct from that of the Document, and from those of
625           previous versions (which should, if there were any, be listed
626           in the History section of the Document).  You may use the
627           same title as a previous version if the original publisher of
628           that version gives permission.
629
630        B. List on the Title Page, as authors, one or more persons or
631           entities responsible for authorship of the modifications in
632           the Modified Version, together with at least five of the
633           principal authors of the Document (all of its principal
634           authors, if it has less than five).
635
636        C. State on the Title page the name of the publisher of the
637           Modified Version, as the publisher.
638
639        D. Preserve all the copyright notices of the Document.
640
641        E. Add an appropriate copyright notice for your modifications
642           adjacent to the other copyright notices.
643
644        F. Include, immediately after the copyright notices, a license
645           notice giving the public permission to use the Modified
646           Version under the terms of this License, in the form shown in
647           the Addendum below.
648
649        G. Preserve in that license notice the full lists of Invariant
650           Sections and required Cover Texts given in the Document's
651           license notice.
652
653        H. Include an unaltered copy of this License.
654
655        I. Preserve the section entitled "History", and its title, and
656           add to it an item stating at least the title, year, new
657           authors, and publisher of the Modified Version as given on
658           the Title Page.  If there is no section entitled "History" in
659           the Document, create one stating the title, year, authors,
660           and publisher of the Document as given on its Title Page,
661           then add an item describing the Modified Version as stated in
662           the previous sentence.
663
664        J. Preserve the network location, if any, given in the Document
665           for public access to a Transparent copy of the Document, and
666           likewise the network locations given in the Document for
667           previous versions it was based on.  These may be placed in
668           the "History" section.  You may omit a network location for a
669           work that was published at least four years before the
670           Document itself, or if the original publisher of the version
671           it refers to gives permission.
672
673        K. In any section entitled "Acknowledgments" or "Dedications",
674           preserve the section's title, and preserve in the section all
675           the substance and tone of each of the contributor
676           acknowledgments and/or dedications given therein.
677
678        L. Preserve all the Invariant Sections of the Document,
679           unaltered in their text and in their titles.  Section numbers
680           or the equivalent are not considered part of the section
681           titles.
682
683        M. Delete any section entitled "Endorsements".  Such a section
684           may not be included in the Modified Version.
685
686        N. Do not retitle any existing section as "Endorsements" or to
687           conflict in title with any Invariant Section.
688
689      If the Modified Version includes new front-matter sections or
690      appendices that qualify as Secondary Sections and contain no
691      material copied from the Document, you may at your option
692      designate some or all of these sections as invariant.  To do this,
693      add their titles to the list of Invariant Sections in the Modified
694      Version's license notice.  These titles must be distinct from any
695      other section titles.
696
697      You may add a section entitled "Endorsements", provided it contains
698      nothing but endorsements of your Modified Version by various
699      parties--for example, statements of peer review or that the text
700      has been approved by an organization as the authoritative
701      definition of a standard.
702
703      You may add a passage of up to five words as a Front-Cover Text,
704      and a passage of up to 25 words as a Back-Cover Text, to the end
705      of the list of Cover Texts in the Modified Version.  Only one
706      passage of Front-Cover Text and one of Back-Cover Text may be
707      added by (or through arrangements made by) any one entity.  If the
708      Document already includes a cover text for the same cover,
709      previously added by you or by arrangement made by the same entity
710      you are acting on behalf of, you may not add another; but you may
711      replace the old one, on explicit permission from the previous
712      publisher that added the old one.
713
714      The author(s) and publisher(s) of the Document do not by this
715      License give permission to use their names for publicity for or to
716      assert or imply endorsement of any Modified Version.
717
718   5. COMBINING DOCUMENTS
719
720      You may combine the Document with other documents released under
721      this License, under the terms defined in section 4 above for
722      modified versions, provided that you include in the combination
723      all of the Invariant Sections of all of the original documents,
724      unmodified, and list them all as Invariant Sections of your
725      combined work in its license notice.
726
727      The combined work need only contain one copy of this License, and
728      multiple identical Invariant Sections may be replaced with a single
729      copy.  If there are multiple Invariant Sections with the same name
730      but different contents, make the title of each such section unique
731      by adding at the end of it, in parentheses, the name of the
732      original author or publisher of that section if known, or else a
733      unique number.  Make the same adjustment to the section titles in
734      the list of Invariant Sections in the license notice of the
735      combined work.
736
737      In the combination, you must combine any sections entitled
738      "History" in the various original documents, forming one section
739      entitled "History"; likewise combine any sections entitled
740      "Acknowledgments", and any sections entitled "Dedications".  You
741      must delete all sections entitled "Endorsements."
742
743   6. COLLECTIONS OF DOCUMENTS
744
745      You may make a collection consisting of the Document and other
746      documents released under this License, and replace the individual
747      copies of this License in the various documents with a single copy
748      that is included in the collection, provided that you follow the
749      rules of this License for verbatim copying of each of the
750      documents in all other respects.
751
752      You may extract a single document from such a collection, and
753      distribute it individually under this License, provided you insert
754      a copy of this License into the extracted document, and follow
755      this License in all other respects regarding verbatim copying of
756      that document.
757
758   7. AGGREGATION WITH INDEPENDENT WORKS
759
760      A compilation of the Document or its derivatives with other
761      separate and independent documents or works, in or on a volume of
762      a storage or distribution medium, does not as a whole count as a
763      Modified Version of the Document, provided no compilation
764      copyright is claimed for the compilation.  Such a compilation is
765      called an "aggregate", and this License does not apply to the
766      other self-contained works thus compiled with the Document, on
767      account of their being thus compiled, if they are not themselves
768      derivative works of the Document.
769
770      If the Cover Text requirement of section 3 is applicable to these
771      copies of the Document, then if the Document is less than one
772      quarter of the entire aggregate, the Document's Cover Texts may be
773      placed on covers that surround only the Document within the
774      aggregate.  Otherwise they must appear on covers around the whole
775      aggregate.
776
777   8. TRANSLATION
778
779      Translation is considered a kind of modification, so you may
780      distribute translations of the Document under the terms of section
781      4.  Replacing Invariant Sections with translations requires special
782      permission from their copyright holders, but you may include
783      translations of some or all Invariant Sections in addition to the
784      original versions of these Invariant Sections.  You may include a
785      translation of this License provided that you also include the
786      original English version of this License.  In case of a
787      disagreement between the translation and the original English
788      version of this License, the original English version will prevail.
789
790   9. TERMINATION
791
792      You may not copy, modify, sublicense, or distribute the Document
793      except as expressly provided for under this License.  Any other
794      attempt to copy, modify, sublicense or distribute the Document is
795      void, and will automatically terminate your rights under this
796      License.  However, parties who have received copies, or rights,
797      from you under this License will not have their licenses
798      terminated so long as such parties remain in full compliance.
799
800  10. FUTURE REVISIONS OF THIS LICENSE
801
802      The Free Software Foundation may publish new, revised versions of
803      the GNU Free Documentation License from time to time.  Such new
804      versions will be similar in spirit to the present version, but may
805      differ in detail to address new problems or concerns.  See
806      `http://www.gnu.org/copyleft/'.
807
808      Each version of the License is given a distinguishing version
809      number.  If the Document specifies that a particular numbered
810      version of this License "or any later version" applies to it, you
811      have the option of following the terms and conditions either of
812      that specified version or of any later version that has been
813      published (not as a draft) by the Free Software Foundation.  If
814      the Document does not specify a version number of this License,
815      you may choose any version ever published (not as a draft) by the
816      Free Software Foundation.
817
818 ADDENDUM: How to use this License for your documents
819 ----------------------------------------------------
820
821    To use this License in a document you have written, include a copy of
822 the License in the document and put the following copyright and license
823 notices just after the title page:
824
825        Copyright (C)  YEAR  YOUR NAME.
826        Permission is granted to copy, distribute and/or modify this document
827        under the terms of the GNU Free Documentation License, Version 1.1
828        or any later version published by the Free Software Foundation;
829        with the Invariant Sections being LIST THEIR TITLES, with the
830        Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
831        A copy of the license is included in the section entitled ``GNU
832        Free Documentation License''.
833
834    If you have no Invariant Sections, write "with no Invariant Sections"
835 instead of saying which ones are invariant.  If you have no Front-Cover
836 Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being
837 LIST"; likewise for Back-Cover Texts.
838
839    If your document contains nontrivial examples of program code, we
840 recommend releasing these examples in parallel under your choice of
841 free software license, such as the GNU General Public License, to
842 permit their use in free software.
843
844 \1f
845 File: gzip.info,  Node: Concept Index,  Prev: Copying This Manual,  Up: Top
846
847 Concept Index
848 *************
849
850 * Menu:
851
852 * bugs:                                  Problems.
853 * concatenated files:                    Advanced usage.
854 * Environment:                           Environment.
855 * FDL, GNU Free Documentation License:   GNU Free Documentation License.
856 * invoking:                              Invoking gzip.
857 * options:                               Invoking gzip.
858 * overview:                              Overview.
859 * sample:                                Sample.
860 * tapes:                                 Tapes.
861
862
863 \1f
864 Tag Table:
865 Node: Top\7f1258
866 Node: Overview\7f2630
867 Node: Sample\7f7390
868 Node: Invoking gzip\7f9051
869 Node: Advanced usage\7f14032
870 Node: Environment\7f15621
871 Node: Tapes\7f16189
872 Node: Problems\7f17203
873 Node: Copying This Manual\7f17661
874 Node: GNU Free Documentation License\7f17877
875 Node: Concept Index\7f37741
876 \1f
877 End Tag Table