home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR40 / GNUZIP_.ZIP / README < prev    next >
Text File  |  1993-03-28  |  4KB  |  82 lines
  1. This is the file README for the gzip distribution, version 1.0.3.
  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 detection of the input format is
  14. automatic.  When using the first two formats, gunzip checks a 32 bit
  15. CRC. For pack, gunzip checks the uncompressed length.  The 'compress'
  16. format was not designed to allow consistency checks. However gunzip
  17. is sometimes able to detect a bad .Z file because there is some
  18. redundancy in the .Z compression format. If you get an error
  19. when uncompressing a .Z file, do not assume that the .Z file is
  20. correct simply because the standard uncompress does not complain.
  21. This generally means that the standard uncompress does not check its
  22. input, and happily generates garbage output.
  23.  
  24. gzip produces files with a .z extension. This was chosen to mimic the
  25. 'compress' .Z extension. Using exactly the same extension would have
  26. caused too much confusion. Using a completely different extension
  27. would have forced changes in other programs such as GNU tar (which has
  28. a -z option).  The .z extension is already used by the 'pack'
  29. Huffman encoder, but gunzip is able to decompress packed files.
  30.  
  31. Several planned features are not yet supported (see the file TODO).
  32. See the file INSTALL for installation instructions. See the file NEWS
  33. for a summary of changes since 0.5.
  34.  
  35. WARNINGS about broken optimizers:
  36.  
  37. - on the NeXT, "cc -finline-functions" is broken.  gzip produces
  38.   valid .z 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. - on SparcStation with SunOS 4.1.1 and the SC1.0 compiler, the optimizer
  45.   works up to -O3 but -O4 does not work.
  46.  
  47. - MSC 5.1 with -Ox and -DDYN_ALLOC generates bad code in inflate.c.
  48.   The default is static allocation (no DYN_ALLOC) and -Ox works.
  49.   But -Ox does not work on util.c, so you must use -Oait -Gs.
  50.  
  51. For all machines, Use "make check" to check that gzip was compiled correctly.
  52.  
  53. Please send all comments and bug reports by electronic mail to:
  54.    Jean-loup Gailly <jloup@chorus.fr>
  55.  
  56. or, if this fails, to bug-gnu-utils@prep.ai.mit.edu.
  57. Bug reports should ideally include:
  58.  
  59.     * The complete output of "gzip -V" (or the contents of revision.h
  60.       if you can't get gzip to compile)
  61.     * The hardware and operating system
  62.     * The compiler used to compile
  63.     * A description of the bug behavior
  64.     * The input to gzip, that triggered the bug
  65.  
  66. The package crypt++.el is highly recommended to manipulate gzip'ed
  67. file from emacs. It recognizes automatically encrypted and compressed
  68. files when they are first visited or written. It is available via
  69. anonymous ftp to roebling.poly.edu [128.238.5.31] in /pub/crypt++.el.
  70. The same directory contains also patches to dired, ange-ftp, info and
  71. tar.
  72.  
  73. gzip is free software, you can redistribute it and/or modify it under
  74. the terms of the GNU General Public License, a copy of which is
  75. provided under the name COPYING. The latest version of the gzip
  76. sources can always be found in prep.ai.mit.edu:/pub/gnu/gzip-*.tar*
  77. or any of the prep mirror sites. An MSDOS lha self-extracting exe is in
  78. hal.gnu.ai.mit.edu:/tmp/gzip*.exe.
  79.  
  80. Many thanks to those who provided me with bug reports and feedback.
  81. See the files THANKS and ChangeLog for more details.
  82.