home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / GZ122_32.ZIP / README < prev   
Text File  |  1993-06-17  |  8KB  |  160 lines
  1. This is the file README for the gzip distribution, version 1.2.2.
  2.  
  3. gzip (GNU zip) is a compression utility designed to be a replacement
  4. for 'compress'. Its main advantages over compress are much better
  5. compression and freedom from patented algorithms.  The GNU Project
  6. uses it as the standard compression program for its system.
  7.  
  8. gzip currently uses by default the LZ77 algorithm used in zip 1.9 (the
  9. portable pkzip compatible archiver). The gzip format was however
  10. designed to accommodate several compression algorithms. See below
  11. for a comparison of zip and gzip.
  12.  
  13. gunzip can currently decompress files created by gzip, compress or
  14. pack. The detection of the input format is automatic.  For the
  15. gzip format, gunzip checks a 32 bit CRC. For pack, gunzip checks the
  16. uncompressed length.  The 'compress' format was not designed to allow
  17. consistency checks. However gunzip is sometimes able to detect a bad
  18. .Z file because there is some redundancy in the .Z compression format.
  19. If you get an error when uncompressing a .Z file, do not assume that
  20. the .Z file is correct simply because the standard uncompress does not
  21. complain.  This generally means that the standard uncompress does not
  22. check its input, and happily generates garbage output.
  23.  
  24. gzip produces files with a .gz extension. Previous versions of gzip
  25. used the .z extension, which was already used by the 'pack'
  26. Huffman encoder. gunzip is able to decompress .z files (packed
  27. or gzip'ed).
  28.  
  29. Several planned features are not yet supported (see the file TODO).
  30. See the file NEWS for a summary of changes since 0.5.  See the file
  31. INSTALL for installation instructions. Some answers to frequently
  32. asked questions are given in the file INSTALL, please read it. (In
  33. particular, please don't ask me once more for an /etc/magic entry.)
  34.  
  35. WARNINGS about broken optimizers:
  36.  
  37. - on the NeXT, "cc -finline-functions" is broken.  gzip produces
  38.   valid .gz files but they are much too large because the string
  39.   matching code misses most matches. Use "cc -O" instead.
  40.  
  41. - on the Mips R4000, gcc -O (version 2.3.1) generates bad code, use cc
  42.   or just gcc -g instead.
  43.  
  44. - gcc 2.3.3 and 2.4.3 on the SGI Indigo IRIX 4.0.5 also produce bad code.
  45.   Use instead: make CC='cc -O2' or gcc without -O.
  46.  
  47. - On Solaris 2.1 for x86, the January 1993 "OEM" compiler release
  48.   generates bad code. This is fixed in the June 1993 "FCS" release.
  49.  
  50. - on Sparc with SunOS 4.1.1 and the SC1.0 compiler, the optimizer
  51.   works up to -O3 but -O4 does not work.
  52.  
  53. - MSC 5.1 with -Ox and -DDYN_ALLOC generates bad code in inflate.c.
  54.   The default is static allocation (no DYN_ALLOC) and -Ox works on inflate.c.
  55.   But -Ox does not work on util.c, so you must use -Oait -Gs.
  56.  
  57. - On dnix 5.3 2.2 cc version 2.37c is buggy. Version 2.38d works.
  58.  
  59. - On an Alliant running Concentrix, cc (even without optimization) generates
  60.   incorrect code. You have to use gcc.
  61.  
  62. For all machines, Use "make check" to check that gzip was compiled correctly.
  63.  
  64. Please send all comments and bug reports by electronic mail to:
  65.    Jean-loup Gailly <jloup@chorus.fr>
  66.  
  67. or, if this fails, to bug-gnu-utils@prep.ai.mit.edu.
  68. Bug reports should ideally include:
  69.  
  70.     * The complete output of "gzip -V" (or the contents of revision.h
  71.       if you can't get gzip to compile)
  72.     * The hardware and operating system (try "uname -a")
  73.     * The compiler used to compile (if it is gcc, use "gcc -v")
  74.     * A description of the bug behavior
  75.     * The input to gzip, that triggered the bug
  76.  
  77. If you send me patches for machines I don't have access to, please test them
  78. very carefully. gzip is used for backups, it must be extremely reliable.
  79.  
  80. The package crypt++.el is highly recommended to manipulate gzip'ed
  81. file from emacs. It recognizes automatically encrypted and compressed
  82. files when they are first visited or written. It is available via
  83. anonymous ftp to roebling.poly.edu [128.238.5.31] in /pub/crypt++.el.
  84. The same directory contains also patches to dired, ange-ftp and info.
  85. GNU tar 1.11.2 has a -z option to invoke directly gzip, so you don't have
  86. to patch it.
  87.  
  88. The znew and gzexe shell scripts provided with gzip benefit from
  89. (but do not require) the cpmod utility to transfer file attributes.
  90. It is available by anonymous ftp on gatekeeper.dec.com in
  91. /.0/usenet/comp.sources.unix/volume11/cpmod.Z.
  92.  
  93. The sample programs zread.c, sub.c and add.c are provided as examples
  94. of useful complements to gzip. Read the comments inside each source file.
  95. The perl script ztouch is also provided as example (not installed
  96. by default since it relies on perl).
  97.  
  98.  
  99. gzip is free software, you can redistribute it and/or modify it under
  100. the terms of the GNU General Public License, a copy of which is
  101. provided under the name COPYING. The latest version of gzip are always
  102. available by ftp in prep.ai.mit.edu:/pub/gnu, or in any of the prep
  103. mirror sites:
  104.  
  105. - sources in gzip-*.tar (or .shar or .tar.gz)
  106. - Solaris 2 executables in sparc-sun-solaris2/gzip-binaries-*.tar
  107. - MSDOS lha self-extracting exe in gzip-msdos-*.exe. Once extracted,
  108.   copy gzip.exe to gunzip.exe and zcat.exe, or use "gzip -d" to decompress.
  109.   gzip386.exe runs much faster but only on 386 and above; it needs go32.exe,
  110.   available in omnigate.clarkson.edu:/pub/msdos/djgpp/djdev110.zip
  111.  
  112. A VMS executable is available in ftp.spc.edu:[.macro32.savesets]gzip-1-*.zip
  113. (use [.macro32]unzip.exe to extract). A PRIMOS executable is available
  114. in ftp.lysator.liu.se:/pub/primos/run/gzip.run.
  115.  
  116. Many thanks to those who provided me with bug reports and feedback.
  117. See the files THANKS and ChangeLog for more details.
  118.  
  119.  
  120.         Note about zip vs. gzip:
  121.  
  122. The name 'gzip' was a very unfortunate choice, because zip and gzip
  123. are two really different programs, although the actual compression and
  124. decompression sources were written by the same persons. A different
  125. name should have been used for gzip, but it is too late to change now.
  126.  
  127. zip is an archiver: it compresses several files into a single archive
  128. file. gzip is a simple compressor: each file is compressed separately.
  129. Both share the same compression and decompression code for the
  130. 'deflate' method.  unzip can also decompress old zip archives
  131. (implode, shrink and reduce methods). gunzip can also decompress files
  132. created by compress and pack. zip 1.9 and gzip do not support
  133. compression methods other than deflation. (zip 1.0 supports shrink and
  134. implode). Better compression methods may be added in future versions
  135. of gzip. zip will always stick to absolute compatibility with pkzip,
  136. it is thus constrained by PKWare, which is a commercial company.  The
  137. gzip header format is deliberately different from that of pkzip to
  138. avoid such a constraint.
  139.  
  140. On Unix, gzip is mostly useful in combination with tar. GNU tar
  141. 1.11.2 has a -z option to invoke gzip automatically.  "tar -z"
  142. compresses better than zip, since gzip can then take advantage of
  143. redundancy between distinct files. The drawback is that you must
  144. scan the whole tar.gz file in order to extract a single file near
  145. the end; unzip can directly seek to the end of the zip file. There
  146. is no overhead when you extract the whole archive anyway.
  147. If a member of a .zip archive is damaged, other files can still
  148. be recovered. If a .tar.gz file is damaged, files beyond the failure
  149. point cannot be recovered. (Future versions of gzip will have
  150. error recovery features.)
  151.  
  152. gzip and gunzip are distributed as a single program. zip and unzip
  153. are, for historical reasons, two separate programs, although the
  154. authors of these two programs work closely together in the info-zip
  155. team. zip and unzip are not associated with the GNU project.
  156. The sources are available by ftp in
  157.  
  158.      oak.oakland.edu:/pub/misc/unix/zip19p1.zip
  159.      oak.oakland.edu:/pub/misc/unix/unz50p1.tar-z
  160.