home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / packer / gzip / readme < prev    next >
Encoding:
Text File  |  1994-02-03  |  4.4 KB  |  94 lines
  1. This is the file README for the gzip distribution, version 1.0.7.
  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.
  11.  
  12. gunzip can currently decompress files created by gzip, zip (with
  13. restrictions), compress or pack. (The SCO 'compress -H' format will be
  14. supported in a future version.)  The detection of the input format is
  15. automatic.  When using the first two formats, gunzip checks a 32 bit
  16. CRC. For pack, gunzip checks the uncompressed length.  The 'compress'
  17. format was not designed to allow consistency checks. However gunzip is
  18. sometimes able to detect a bad .Z file because there is some
  19. redundancy in the .Z compression format. If you get an error when
  20. uncompressing a .Z file, do not assume that the .Z file is correct
  21. simply because the standard uncompress does not complain.  This
  22. generally means that the standard uncompress does not check its input,
  23. and happily generates garbage output.
  24.  
  25. gzip produces files with a .z extension. This was chosen to mimic the
  26. 'compress' .Z extension. Using exactly the same extension would have
  27. caused too much confusion. Using a completely different extension
  28. would have forced changes in other programs such as GNU tar (which has
  29. a -z option).  The .z extension is already used by the 'pack'
  30. Huffman encoder, but gunzip is able to decompress packed files.
  31.  
  32. Several planned features are not yet supported (see the file TODO).
  33. See the file INSTALL for installation instructions. See the file NEWS
  34. for a summary of changes since 0.5.
  35.  
  36. WARNINGS about broken optimizers:
  37.  
  38. - on the NeXT, "cc -finline-functions" is broken.  gzip produces
  39.   valid .z files but they are much too large because the string
  40.   matching code misses most matches. Use "cc -O" instead.
  41.  
  42. - on the Mips R4000, gcc -O (version 2.3.1) generates bad code, use cc
  43.   or just gcc -g instead.
  44.  
  45. - gcc 2.3.3 on the SGI Indigo IRIX 4.0.5 also produces bad code. Use
  46.   instead: make CC='cc -O2'
  47.  
  48. - on SparcStation with SunOS 4.1.1 and the SC1.0 compiler, the optimizer
  49.   works up to -O3 but -O4 does not work.
  50.  
  51. - MSC 5.1 with -Ox and -DDYN_ALLOC generates bad code in inflate.c.
  52.   The default is static allocation (no DYN_ALLOC) and -Ox works on inflate.c.
  53.   But -Ox does not work on util.c, so you must use -Oait -Gs.
  54.  
  55. For all machines, Use "make check" to check that gzip was compiled correctly.
  56.  
  57. Please send all comments and bug reports by electronic mail to:
  58.    Jean-loup Gailly <jloup@chorus.fr>
  59.  
  60. or, if this fails, to bug-gnu-utils@prep.ai.mit.edu.
  61. Bug reports should ideally include:
  62.  
  63.     * The complete output of "gzip -V" (or the contents of revision.h
  64.       if you can't get gzip to compile)
  65.     * The hardware and operating system
  66.     * The compiler used to compile
  67.     * A description of the bug behavior
  68.     * The input to gzip, that triggered the bug
  69.  
  70. The package crypt++.el is highly recommended to manipulate gzip'ed
  71. file from emacs. It recognizes automatically encrypted and compressed
  72. files when they are first visited or written. It is available via
  73. anonymous ftp to roebling.poly.edu [128.238.5.31] in /pub/crypt++.el.
  74. The same directory contains also patches to dired, ange-ftp, info and
  75. tar. A patch for tar 1.11.1 is included in the gzip distribution
  76. because too many people independently reinvent it (see gzip-tar.patch).
  77.  
  78. The znew and gzexe shell scripts provided with gzip benefit from
  79. (but do not require) the cpmod utility to transfer file attributes.
  80. It is available by anonymous ftp on gatekeeper.dec.com in
  81. /.0/usenet/comp.sources.unix/volume11/cpmod.Z.
  82.  
  83. gzip is free software, you can redistribute it and/or modify it under
  84. the terms of the GNU General Public License, a copy of which is
  85. provided under the name COPYING. The latest version of the gzip
  86. sources can always be found in prep.ai.mit.edu:/pub/gnu/gzip-*.tar*
  87. or any of the prep mirror sites. An MSDOS lha self-extracting exe is in
  88. gzip-msdos-*.exe. The Soloaris 2 executables are in gzip-solaris-*.tar.
  89. A VMS executable is available in ftp.spc.edu:[.macro32.savesets]gzip-1-*.zip
  90. (use [.macro32]unzip.exe to extract).
  91.  
  92. Many thanks to those who provided me with bug reports and feedback.
  93. See the files THANKS and ChangeLog for more details.
  94.