Annotation of coherent/g/usr/bin/gzip/gzip.info, revision 1.1

1.1     ! root        1: Info file gzip.info, produced by Makeinfo, -*- Text -*- from input
        !             2: file gzip.texi.
        !             3: 
        !             4:    This file documents the the GNU `gzip' command for compressing
        !             5: files.
        !             6: 
        !             7:    Copyright (C) 1992-1993 Jean-loup Gailly
        !             8: 
        !             9:    Permission is granted to make and distribute verbatim copies of
        !            10: this manual provided the copyright notice and this permission notice
        !            11: are preserved on all copies.
        !            12: 
        !            13:    Permission is granted to copy and distribute modified versions of
        !            14: this manual under the conditions for verbatim copying, provided that
        !            15: the entire resulting derived work is distributed under the terms of a
        !            16: permission notice identical to this one.
        !            17: 
        !            18:    Permission is granted to copy and distribute translations of this
        !            19: manual into another language, under the above conditions for modified
        !            20: versions, except that this permission notice may be stated in a
        !            21: translation approved by the Foundation.
        !            22: 
        !            23: 
        !            24: File: gzip.info,  Node: Top,  Up: (dir)
        !            25: 
        !            26:    This file documents the `gzip' command to compress files.
        !            27: 
        !            28: * Menu:
        !            29: 
        !            30: * Copying::            How you can copy and share `gzip'.
        !            31: * Overview::           Preliminary information.
        !            32: * Sample::             Sample output from `gzip'.
        !            33: * Invoking gzip::      How to run `gzip'.
        !            34: * Advanced usage::     Concatenated files.
        !            35: * Environment::                The `GZIP' environment variable
        !            36: * Problems::           Reporting bugs.
        !            37: * Concept Index::      Index of concepts.
        !            38: 
        !            39: 
        !            40: File: gzip.info,  Node: Copying,  Next: Overview,  Up: Top
        !            41: 
        !            42: GNU GENERAL PUBLIC LICENSE
        !            43: **************************
        !            44: 
        !            45:                              Version 2, June 1991
        !            46: 
        !            47:      Copyright (C) 1989, 1991 Free Software Foundation, Inc.
        !            48:      675 Mass Ave, Cambridge, MA 02139, USA
        !            49:      
        !            50:      Everyone is permitted to copy and distribute verbatim copies
        !            51:      of this license document, but changing it is not allowed.
        !            52: 
        !            53: Preamble
        !            54: ========
        !            55: 
        !            56:    The licenses for most software are designed to take away your
        !            57: freedom to share and change it.  By contrast, the GNU General Public
        !            58: License is intended to guarantee your freedom to share and change free
        !            59: software--to make sure the software is free for all its users.  This
        !            60: General Public License applies to most of the Free Software
        !            61: Foundation's software and to any other program whose authors commit to
        !            62: using it.  (Some other Free Software Foundation software is covered by
        !            63: the GNU Library General Public License instead.)  You can apply it to
        !            64: your programs, too.
        !            65: 
        !            66:    When we speak of free software, we are referring to freedom, not
        !            67: price.  Our General Public Licenses are designed to make sure that you
        !            68: have the freedom to distribute copies of free software (and charge for
        !            69: this service if you wish), that you receive source code or can get it
        !            70: if you want it, that you can change the software or use pieces of it
        !            71: in new free programs; and that you know you can do these things.
        !            72: 
        !            73:    To protect your rights, we need to make restrictions that forbid
        !            74: anyone to deny you these rights or to ask you to surrender the rights. 
        !            75: These restrictions translate to certain responsibilities for you if you
        !            76: distribute copies of the software, or if you modify it.
        !            77: 
        !            78:    For example, if you distribute copies of such a program, whether
        !            79: gratis or for a fee, you must give the recipients all the rights that
        !            80: you have.  You must make sure that they, too, receive or can get the
        !            81: source code.  And you must show them these terms so they know their
        !            82: rights.
        !            83: 
        !            84:    We protect your rights with two steps: (1) copyright the software,
        !            85: and (2) offer you this license which gives you legal permission to
        !            86: copy, distribute and/or modify the software.
        !            87: 
        !            88:    Also, for each author's protection and ours, we want to make certain
        !            89: that everyone understands that there is no warranty for this free
        !            90: software.  If the software is modified by someone else and passed on,
        !            91: we want its recipients to know that what they have is not the
        !            92: original, so that any problems introduced by others will not reflect
        !            93: on the original authors' reputations.
        !            94: 
        !            95:    Finally, any free program is threatened constantly by software
        !            96: patents.  We wish to avoid the danger that redistributors of a free
        !            97: program will individually obtain patent licenses, in effect making the
        !            98: program proprietary.  To prevent this, we have made it clear that any
        !            99: patent must be licensed for everyone's free use or not licensed at all.
        !           100: 
        !           101:    The precise terms and conditions for copying, distribution and
        !           102: modification follow.
        !           103: 
        !           104:        TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
        !           105: 
        !           106:   1. This License applies to any program or other work which contains
        !           107:      a notice placed by the copyright holder saying it may be
        !           108:      distributed under the terms of this General Public License.  The
        !           109:      "Program", below, refers to any such program or work, and a "work
        !           110:      based on the Program" means either the Program or any derivative
        !           111:      work under copyright law: that is to say, a work containing the
        !           112:      Program or a portion of it, either verbatim or with modifications
        !           113:      and/or translated into another language.  (Hereinafter,
        !           114:      translation is included without limitation in the term
        !           115:      "modification".)  Each licensee is addressed as "you".
        !           116: 
        !           117:         Activities other than copying, distribution and modification
        !           118:      are not covered by this License; they are outside its scope.  The
        !           119:      act of running the Program is not restricted, and the output from
        !           120:      the Program is covered only if its contents constitute a work
        !           121:      based on the Program (independent of having been made by running
        !           122:      the Program).  Whether that is true depends on what the Program
        !           123:      does.
        !           124: 
        !           125:   2. You may copy and distribute verbatim copies of the Program's
        !           126:      source code as you receive it, in any medium, provided that you
        !           127:      conspicuously and appropriately publish on each copy an
        !           128:      appropriate copyright notice and disclaimer of warranty; keep
        !           129:      intact all the notices that refer to this License and to the
        !           130:      absence of any warranty; and give any other recipients of the
        !           131:      Program a copy of this License along with the Program.
        !           132: 
        !           133:         You may charge a fee for the physical act of transferring a
        !           134:      copy, and you may at your option offer warranty protection in
        !           135:      exchange for a fee.
        !           136: 
        !           137:   3. You may modify your copy or copies of the Program or any portion
        !           138:      of it, thus forming a work based on the Program, and copy and
        !           139:      distribute such modifications or work under the terms of Section 1
        !           140:      above, provided that you also meet all of these conditions:
        !           141: 
        !           142:        1. You must cause the modified files to carry prominent notices
        !           143:           stating that you changed the files and the date of any
        !           144:           change.
        !           145: 
        !           146:        2. You must cause any work that you distribute or publish, that
        !           147:           in whole or in part contains or is derived from the Program
        !           148:           or any part thereof, to be licensed as a whole at no charge
        !           149:           to all third parties under the terms of this License.
        !           150: 
        !           151:        3. If the modified program normally reads commands interactively
        !           152:           when run, you must cause it, when started running for such
        !           153:           interactive use in the most ordinary way, to print or
        !           154:           display an announcement including an appropriate copyright
        !           155:           notice and a notice that there is no warranty (or else,
        !           156:           saying that you provide a warranty) and that users may
        !           157:           redistribute the program under these conditions, and telling
        !           158:           the user how to view a copy of this License.  (Exception: if
        !           159:           the Program itself is interactive but does not normally
        !           160:           print such an announcement, your work based on the Program
        !           161:           is not required to print an announcement.)
        !           162: 
        !           163:              These requirements apply to the modified work as a whole.  If
        !           164:      identifiable sections of that work are not derived from the
        !           165:      Program, and can be reasonably considered independent and
        !           166:      separate works in themselves, then this License, and its terms,
        !           167:      do not apply to those sections when you distribute them as
        !           168:      separate works.  But when you distribute the same sections as
        !           169:      part of a whole which is a work based on the Program, the
        !           170:      distribution of the whole must be on the terms of this License,
        !           171:      whose permissions for other licensees extend to the entire whole,
        !           172:      and thus to each and every part regardless of who wrote it.
        !           173: 
        !           174:         Thus, it is not the intent of this section to claim rights or
        !           175:      contest your rights to work written entirely by you; rather, the
        !           176:      intent is to exercise the right to control the distribution of
        !           177:      derivative or collective works based on the Program.
        !           178: 
        !           179:         In addition, mere aggregation of another work not based on the
        !           180:      Program with the Program (or with a work based on the Program) on
        !           181:      a volume of a storage or distribution medium does not bring the
        !           182:      other work under the scope of this License.
        !           183: 
        !           184:   4. You may copy and distribute the Program (or a work based on it,
        !           185:      under Section 2) in object code or executable form under the
        !           186:      terms of Sections 1 and 2 above provided that you also do one of
        !           187:      the following:
        !           188: 
        !           189:        1. Accompany it with the complete corresponding machine-readable
        !           190:           source code, which must be distributed under the terms of
        !           191:           Sections 1 and 2 above on a medium customarily used for
        !           192:           software interchange; or,
        !           193: 
        !           194:        2. Accompany it with a written offer, valid for at least three
        !           195:           years, to give any third party, for a charge no more than
        !           196:           your cost of physically performing source distribution, a
        !           197:           complete machine-readable copy of the corresponding source
        !           198:           code, to be distributed under the terms of Sections 1 and 2
        !           199:           above on a medium customarily used for software interchange;
        !           200:           or,
        !           201: 
        !           202:        3. Accompany it with the information you received as to the
        !           203:           offer to distribute corresponding source code.  (This
        !           204:           alternative is allowed only for noncommercial distribution
        !           205:           and only if you received the program in object code or
        !           206:           executable form with such an offer, in accord with
        !           207:           Subsection b above.)
        !           208: 
        !           209:              The source code for a work means the preferred form of the
        !           210:      work for making modifications to it.  For an executable work,
        !           211:      complete source code means all the source code for all modules it
        !           212:      contains, plus any associated interface definition files, plus
        !           213:      the scripts used to control compilation and installation of the
        !           214:      executable.  However, as a special exception, the source code
        !           215:      distributed need not include anything that is normally
        !           216:      distributed (in either source or binary form) with the major
        !           217:      components (compiler, kernel, and so on) of the operating system
        !           218:      on which the executable runs, unless that component itself
        !           219:      accompanies the executable.
        !           220: 
        !           221:         If distribution of executable or object code is made by
        !           222:      offering access to copy from a designated place, then offering
        !           223:      equivalent access to copy the source code from the same place
        !           224:      counts as distribution of the source code, even though third
        !           225:      parties are not compelled to copy the source along with the
        !           226:      object code.
        !           227: 
        !           228:   5. You may not copy, modify, sublicense, or distribute the Program
        !           229:      except as expressly provided under this License.  Any attempt
        !           230:      otherwise to copy, modify, sublicense or distribute the Program is
        !           231:      void, and will automatically terminate your rights under this
        !           232:      License.  However, parties who have received copies, or rights,
        !           233:      from you under this License will not have their licenses
        !           234:      terminated so long as such parties remain in full compliance.
        !           235: 
        !           236:   6. You are not required to accept this License, since you have not
        !           237:      signed it.  However, nothing else grants you permission to modify
        !           238:      or distribute the Program or its derivative works.  These actions
        !           239:      are prohibited by law if you do not accept this License. 
        !           240:      Therefore, by modifying or distributing the Program (or any work
        !           241:      based on the Program), you indicate your acceptance of this
        !           242:      License to do so, and all its terms and conditions for copying,
        !           243:      distributing or modifying the Program or works based on it.
        !           244: 
        !           245:   7. Each time you redistribute the Program (or any work based on the
        !           246:      Program), the recipient automatically receives a license from the
        !           247:      original licensor to copy, distribute or modify the Program
        !           248:      subject to these terms and conditions.  You may not impose any
        !           249:      further restrictions on the recipients' exercise of the rights
        !           250:      granted herein.  You are not responsible for enforcing compliance
        !           251:      by third parties to this License.
        !           252: 
        !           253:   8. If, as a consequence of a court judgment or allegation of patent
        !           254:      infringement or for any other reason (not limited to patent
        !           255:      issues), conditions are imposed on you (whether by court order,
        !           256:      agreement or otherwise) that contradict the conditions of this
        !           257:      License, they do not excuse you from the conditions of this
        !           258:      License.  If you cannot distribute so as to satisfy
        !           259:      simultaneously your obligations under this License and any other
        !           260:      pertinent obligations, then as a consequence you may not
        !           261:      distribute the Program at all.  For example, if a patent license
        !           262:      would not permit royalty-free redistribution of the Program by
        !           263:      all those who receive copies directly or indirectly through you,
        !           264:      then the only way you could satisfy both it and this License
        !           265:      would be to refrain entirely from distribution of the Program.
        !           266: 
        !           267:         If any portion of this section is held invalid or
        !           268:      unenforceable under any particular circumstance, the balance of
        !           269:      the section is intended to apply and the section as a whole is
        !           270:      intended to apply in other circumstances.
        !           271: 
        !           272:         It is not the purpose of this section to induce you to
        !           273:      infringe any patents or other property right claims or to contest
        !           274:      validity of any such claims; this section has the sole purpose of
        !           275:      protecting the integrity of the free software distribution
        !           276:      system, which is implemented by public license practices.  Many
        !           277:      people have made generous contributions to the wide range of
        !           278:      software distributed through that system in reliance on
        !           279:      consistent application of that system; it is up to the
        !           280:      author/donor to decide if he or she is willing to distribute
        !           281:      software through any other system and a licensee cannot impose
        !           282:      that choice.
        !           283: 
        !           284:         This section is intended to make thoroughly clear what is
        !           285:      believed to be a consequence of the rest of this License.
        !           286: 
        !           287:   9. If the distribution and/or use of the Program is restricted in
        !           288:      certain countries either by patents or by copyrighted interfaces,
        !           289:      the original copyright holder who places the Program under this
        !           290:      License may add an explicit geographical distribution limitation
        !           291:      excluding those countries, so that distribution is permitted only
        !           292:      in or among countries not thus excluded.  In such case, this
        !           293:      License incorporates the limitation as if written in the body of
        !           294:      this License.
        !           295: 
        !           296:  10. The Free Software Foundation may publish revised and/or new
        !           297:      versions of the General Public License from time to time.  Such
        !           298:      new versions will be similar in spirit to the present version,
        !           299:      but may differ in detail to address new problems or concerns.
        !           300: 
        !           301:         Each version is given a distinguishing version number.  If the
        !           302:      Program specifies a version number of this License which applies
        !           303:      to it and "any later version", you have the option of following
        !           304:      the terms and conditions either of that version or of any later
        !           305:      version published by the Free Software Foundation.  If the
        !           306:      Program does not specify a version number of this License, you
        !           307:      may choose any version ever published by the Free Software
        !           308:      Foundation.
        !           309: 
        !           310:  11. If you wish to incorporate parts of the Program into other free
        !           311:      programs whose distribution conditions are different, write to
        !           312:      the author to ask for permission.  For software which is
        !           313:      copyrighted by the Free Software Foundation, write to the Free
        !           314:      Software Foundation; we sometimes make exceptions for this.  Our
        !           315:      decision will be guided by the two goals of preserving the free
        !           316:      status of all derivatives of our free software and of promoting
        !           317:      the sharing and reuse of software generally.
        !           318: 
        !           319:                                       NO WARRANTY
        !           320: 
        !           321:  12. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
        !           322:      WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
        !           323:      LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
        !           324:      HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
        !           325:      WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
        !           326:      NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
        !           327:      FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
        !           328:      QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
        !           329:      PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
        !           330:      SERVICING, REPAIR OR CORRECTION.
        !           331: 
        !           332:  13. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
        !           333:      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
        !           334:      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
        !           335:      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
        !           336:      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
        !           337:      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
        !           338:      OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
        !           339:      YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH
        !           340:      ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
        !           341:      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
        !           342: 
        !           343:                          END OF TERMS AND CONDITIONS
        !           344: 
        !           345: How to Apply These Terms to Your New Programs
        !           346: =============================================
        !           347: 
        !           348:    If you develop a new program, and you want it to be of the greatest
        !           349: possible use to the public, the best way to achieve this is to make it
        !           350: free software which everyone can redistribute and change under these
        !           351: terms.
        !           352: 
        !           353:    To do so, attach the following notices to the program.  It is safest
        !           354: to attach them to the start of each source file to most effectively
        !           355: convey the exclusion of warranty; and each file should have at least
        !           356: the "copyright" line and a pointer to where the full notice is found.
        !           357: 
        !           358:      ONE LINE TO GIVE THE PROGRAM'S NAME AND AN IDEA OF WHAT IT DOES.
        !           359:      Copyright (C) 19YY  NAME OF AUTHOR
        !           360:      
        !           361:      This program is free software; you can redistribute it and/or
        !           362:      modify it under the terms of the GNU General Public License
        !           363:      as published by the Free Software Foundation; either version 2
        !           364:      of the License, or (at your option) any later version.
        !           365:      
        !           366:      This program is distributed in the hope that it will be useful,
        !           367:      but WITHOUT ANY WARRANTY; without even the implied warranty of
        !           368:      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !           369:      GNU General Public License for more details.
        !           370:      
        !           371:      You should have received a copy of the GNU General Public License
        !           372:      along with this program; if not, write to the Free Software
        !           373:      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
        !           374: 
        !           375:    Also add information on how to contact you by electronic and paper
        !           376: mail.
        !           377: 
        !           378:    If the program is interactive, make it output a short notice like
        !           379: this when it starts in an interactive mode:
        !           380: 
        !           381:      Gnomovision version 69, Copyright (C) 19YY NAME OF AUTHOR
        !           382:      Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
        !           383:      type `show w'.  This is free software, and you are welcome
        !           384:      to redistribute it under certain conditions; type `show c' 
        !           385:      for details.
        !           386: 
        !           387:    The hypothetical commands `show w' and `show c' should show the
        !           388: appropriate parts of the General Public License.  Of course, the
        !           389: commands you use may be called something other than `show w' and `show
        !           390: c'; they could even be mouse-clicks or menu items--whatever suits your
        !           391: program.
        !           392: 
        !           393:    You should also get your employer (if you work as a programmer) or
        !           394: your school, if any, to sign a "copyright disclaimer" for the program,
        !           395: if necessary.  Here is a sample; alter the names:
        !           396: 
        !           397:      Yoyodyne, Inc., hereby disclaims all copyright
        !           398:      interest in the program `Gnomovision'
        !           399:      (which makes passes at compilers) written 
        !           400:      by James Hacker.
        !           401:      
        !           402:      SIGNATURE OF TY COON, 1 April 1989
        !           403:      Ty Coon, President of Vice
        !           404: 
        !           405:    This General Public License does not permit incorporating your
        !           406: program into proprietary programs.  If your program is a subroutine
        !           407: library, you may consider it more useful to permit linking proprietary
        !           408: applications with the library.  If this is what you want to do, use
        !           409: the GNU Library General Public License instead of this License.
        !           410: 
        !           411: 
        !           412: File: gzip.info,  Node: Overview,  Next: Sample,  Prev: Copying,  Up: Top
        !           413: 
        !           414: Overview
        !           415: ********
        !           416: 
        !           417:    `Gzip' reduces the size of the named files using Lempel-Ziv coding
        !           418: (LZ77).  Whenever possible, each file is replaced by one with the
        !           419: extension ".z", while keeping the same ownership modes, access and
        !           420: modification times.  (The extension is "-z" for VMS, "z" for MSDOS,
        !           421: OS/2 and Atari.)  If no files are specified, the standard input is
        !           422: compressed to the standard output. If the new file name is too long,
        !           423: `gzip' truncates it and keeps the original file name in the compressed
        !           424: file.  `gzip' will only attempt to compress regular files.  In
        !           425: particular, it will ignore symbolic links.
        !           426: 
        !           427:    Compressed files can be restored to their original form using
        !           428: "`gzip' -d" or `gunzip' or `zcat'.
        !           429: 
        !           430:    `gunzip' takes a list of files on its command line and replaces
        !           431: each file whose name ends with ".z" or ".Z" and which begins with the
        !           432: correct magic number with an uncompressed file without the original
        !           433: extension.  `gunzip' also recognizes the special extensions ".tgz" and
        !           434: ".taz" as shorthands for ".tar.z" or ".tar.Z".
        !           435: 
        !           436:    `gunzip' can currently decompress files created by `gzip', `zip',
        !           437: `compress' or `pack'. The detection of the input format is automatic. 
        !           438: When using the first two formats, `gunzip' checks a 32 bit CRC (cyclic
        !           439: redundancy check). For `pack', `gunzip' checks the uncompressed
        !           440: length. The `compress' format was not designed to allow consistency
        !           441: checks. However `gunzip' is sometimes able to detect a bad .Z file. If
        !           442: you get an error when uncompressing a .Z file, do not assume that the
        !           443: .Z file is correct simply because the standard `uncompress' does not
        !           444: complain.  This generally means that the standard `uncompress' does
        !           445: not check its input, and happily generates garbage output.
        !           446: 
        !           447:    Files created by `zip' can be uncompressed by `gzip' only if they
        !           448: have a single member compressed with the 'deflation' method. This
        !           449: feature is only intended to help conversion of `tar.zip' files to the
        !           450: `tar.z' format. To extract `zip' files with several members, use
        !           451: `unzip' instead of `gunzip'.
        !           452: 
        !           453:    `zcat' is identical to "`gunzip' -c".  `zcat' uncompresses either a
        !           454: list of files on the command line or its standard input and writes the
        !           455: uncompressed data on standard output.  `zcat' will uncompress files
        !           456: that have the correct magic number whether they have a ".z" suffix or
        !           457: not.
        !           458: 
        !           459:    `gzip' uses the Lempel-Ziv algorithm used in `zip' and PKZIP.  The
        !           460: amount of compression obtained depends on the size of the input and
        !           461: the distribution of common substrings.  Typically, text such as source
        !           462: code or English is reduced by 60-70%.  Compression is generally much
        !           463: better than that achieved by LZW (as used in `compress'), Huffman
        !           464: coding (as used in `pack'), or adaptive Huffman coding (`compact').
        !           465: 
        !           466:    Compression is always performed, even if the compressed file is
        !           467: slightly larger than the original. The worst case expansion is a few
        !           468: bytes for the gzip file header, plus 5 bytes every 32K block, or an
        !           469: expansion ratio of 0.015% for large files.  `gzip' preserves the mode,
        !           470: ownership and timestamps of files when compressing or decompressing.
        !           471: 
        !           472: 
        !           473: File: gzip.info,  Node: Sample,  Next: Invoking gzip,  Prev: Overview,  Up: Top
        !           474: 
        !           475: Sample Output
        !           476: *************
        !           477: 
        !           478:    Here are some realistic examples of running `gzip'.
        !           479: 
        !           480:    This is the output of the command `gzip':
        !           481: 
        !           482:      usage: gzip [-cdfhLrv19] [file ...]
        !           483:      For more help, type: gzip -h
        !           484: 
        !           485:    This is the output of the command `gzip -h':
        !           486: 
        !           487:      gzip 1.0.5 (4 Mar 93)
        !           488:      usage: gzip [-cdfhLrtvV19] [file ...]
        !           489:       -c --stdout      write on standard output, keep original files unchanged
        !           490:       -d --decompress  decompress
        !           491:       -f --force       force overwrite of output file and compress links
        !           492:       -h --help        give this help
        !           493:       -L --license     display software license
        !           494:       -q --quiet       suppress all warnings
        !           495:       -r --recurse     recurse through directories
        !           496:       -t --test        test compressed file integrity (implies -d)
        !           497:       -v --verbose     verbose mode
        !           498:       -V --version     display version number
        !           499:       -1 --fast        compress faster
        !           500:       -9 --best        compress better
        !           501:       file...          files to (de)compress. If none given, use standard input
        !           502: 
        !           503:    This is the output of the command `gzip -v gzip.c':
        !           504: 
        !           505:      gzip.c:                 69.8% -- replaced with gzip.c.z
        !           506: 
        !           507: 
        !           508: File: gzip.info,  Node: Invoking gzip,  Next: Advanced usage,  Prev: Sample,  Up: Top
        !           509: 
        !           510: Invoking `gzip'
        !           511: ***************
        !           512: 
        !           513:    The format for running the `gzip' program is:
        !           514: 
        !           515:      gzip OPTION ...
        !           516: 
        !           517:    `gzip' supports the following options:
        !           518: 
        !           519: `--help'
        !           520: `-h'
        !           521:      Print an informative help message describing the options.
        !           522: 
        !           523: `--stdout'
        !           524: `-c'
        !           525:      Write output on standard output; keep original files unchanged. 
        !           526:      If there are several input files, the output consists of a
        !           527:      sequence of independently compressed members. To obtain better
        !           528:      compression, concatenate all input files before compressing them.
        !           529: 
        !           530: `--decompress'
        !           531: `-d'
        !           532:      Decompress.
        !           533: 
        !           534: `--force'
        !           535: `-f'
        !           536:      Force compression or decompression even if the file has multiple
        !           537:      links or the corresponding file already exists. If -f is not
        !           538:      given, and when not running in the background, `gzip' prompts to
        !           539:      verify whether an existing file should be overwritten.
        !           540: 
        !           541: `--help'
        !           542: `-h'
        !           543:      Display a help screen.
        !           544: 
        !           545: `--license'
        !           546: `-L'
        !           547:      Display the `gzip' license.
        !           548: 
        !           549: `--recurse'
        !           550: `-r'
        !           551:      Travel the directory structure recursively. If any of the file
        !           552:      names specified on the command line are directories, `gzip' will
        !           553:      descend into the directory and compress all the files it finds
        !           554:      there (or decompress them in the case of `gunzip').
        !           555: 
        !           556: `--test'
        !           557: `-t'
        !           558:      Test. Check the compressed file integrity.
        !           559: 
        !           560: `--verbose'
        !           561: `-v'
        !           562:      Verbose. Display the name and percentage reduction for each file
        !           563:      compressed.
        !           564: 
        !           565: `--version'
        !           566: `-V'
        !           567:      Version. Display the version number and compilation options.
        !           568: 
        !           569: `--fast'
        !           570: `--best'
        !           571: `-#'
        !           572:      Regulate the speed of compression using the specified digit #,
        !           573:      where -1 or --fast indicates the fastest compression method (less
        !           574:      compression) and --best or -9 indicates the slowest compression
        !           575:      method (optimal compression).  The default compression level is
        !           576:      -5.
        !           577: 
        !           578: 
        !           579: File: gzip.info,  Node: Advanced usage,  Next: Environment,  Prev: Invoking gzip,  Up: Top
        !           580: 
        !           581: Advanced usage
        !           582: **************
        !           583: 
        !           584:    Multiple compressed files can be concatenated. In this case,
        !           585: `gunzip' will extract all members at once. If one member is damaged,
        !           586: other members might still be recovered after removal of the damaged
        !           587: member. Better compression can be usually obtained if all members are
        !           588: decompressed then recompressed in a single step.
        !           589: 
        !           590:    This is an example of concatenating gzip files:
        !           591: 
        !           592:      gzip -c file1  > foo.z
        !           593:      gzip -c file2 >> foo.z
        !           594: 
        !           595:    Then
        !           596: 
        !           597:      gunzip -c foo
        !           598: 
        !           599:    is equivalent to
        !           600: 
        !           601:      cat file1 file2
        !           602: 
        !           603:    In case of damage to one member of a .z file, other members can
        !           604: still be recovered (if the damaged member is removed). However, you
        !           605: can get better compression by compressing all members at once:
        !           606: 
        !           607:      cat file1 file2 | gzip > foo.z
        !           608: 
        !           609:    compresses better than
        !           610: 
        !           611:      gzip -c file1 file2 > foo.z
        !           612: 
        !           613:    If you want to recompress concatenated files to get better
        !           614: compression, do:
        !           615: 
        !           616:      zcat old.z | gzip > new.z
        !           617: 
        !           618: 
        !           619: File: gzip.info,  Node: Environment,  Next: Problems,  Prev: Advanced usage,  Up: Top
        !           620: 
        !           621: Environment
        !           622: ***********
        !           623: 
        !           624:    The environment variable `GZIP' can hold a set of default options
        !           625: for gzip.  These options are interpreted first and can be ovewritten by
        !           626: explicit command line parameters.  For example:
        !           627: 
        !           628:      for sh:    GZIP="-8 -v"; export GZIP
        !           629:      for csh:   setenv GZIP "-8 -v"
        !           630:      for MSDOS: set GZIP=-8 -v
        !           631: 
        !           632:    On Vax/VMS, the name of the environment variable is `GZIP_OPT', to
        !           633: avoid a conflict with the symbol set for invocation of the program.
        !           634: 
        !           635: 
        !           636: File: gzip.info,  Node: Problems,  Next: Concept Index,  Prev: Environment,  Up: Top
        !           637: 
        !           638: Reporting Bugs
        !           639: **************
        !           640: 
        !           641:    If you find a bug in `gzip', please send electronic mail to
        !           642: `[email protected]' or, if this fails, to
        !           643: `[email protected]'.  Include the version number, which
        !           644: you can find by running `gzip -V'.  Also include in your message the
        !           645: hardware and operating system, the compiler used to compile, a
        !           646: description of the bug behavior, and the input to gzip that triggered
        !           647: the bug.
        !           648: 
        !           649: 
        !           650: File: gzip.info,  Node: Concept Index,  Prev: Problems,  Up: Top
        !           651: 
        !           652: Concept Index
        !           653: *************
        !           654: 
        !           655: * Menu:
        !           656: 
        !           657: * Environment:                          Environment.
        !           658: * bugs:                                 Problems.
        !           659: * concatenated files:                   Advanced usage.
        !           660: * invoking:                             Invoking gzip.
        !           661: * options:                              Invoking gzip.
        !           662: * overview:                             Overview.
        !           663: * sample:                               Sample.
        !           664: 
        !           665: 
        !           666: 
        !           667: Tag Table:
        !           668: Node: Top864
        !           669: Node: Copying1297
        !           670: Node: Overview20555
        !           671: Node: Sample23686
        !           672: Node: Invoking gzip24889
        !           673: Node: Advanced usage26751
        !           674: Node: Environment27787
        !           675: Node: Problems28340
        !           676: Node: Concept Index28842
        !           677: 
        !           678: End Tag Table

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.