home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / SOFTWARE / SOURCES / UNZIP52.ZIP / INSTALL (.txt) < prev    next >
Text File  |  1996-04-24  |  22KB  |  405 lines
  1. __________________________________________________________________________
  2.  
  3.   This is the Info-ZIP file INSTALL (for UnZip), last updated 24 Apr 96.
  4. __________________________________________________________________________
  5.  
  6.   Yes, this is a rather long file, but don't be intimidated:  much of its
  7.   length is due to coverage of multiple operating systems and of optional
  8.   customization features, large portions of which may be skipped.  --GRR
  9. __________________________________________________________________________
  10.  
  11.  
  12.  
  13. To compile UnZip, UnZipSFX and/or fUnZip (quick-start instructions):
  14. =========================================
  15.  
  16. (1) Unpack everything into a work directory somewhere, and make sure you're
  17.     in the main UnZip directory (the one with this file in it).
  18.  
  19. (2) Copy the appropriate makefile into the current directory, except under
  20.     OS/2.
  21.  
  22. (3) Run your "make" utility on the makefile (e.g., "nmake -f makefile.msc").
  23.  
  24. (4) Try out your new UnZip the way you would any new utility:  read the
  25.     docs first.
  26.  
  27.     Ah ha ha ha!!  Oh, that kills me.  But seriously...for VMS, UnZip must
  28.     be installed as a "foreign symbol"; see the Install section below or
  29.     [.vms]readme.vms for details.  (It basically involves adding a line
  30.     sort of like this to login.com:    $ unzip == "$disk:[dir]unzip.exe")
  31.     For DOS and other OSes without explicit timezone support (i.e., every-
  32.     body but Unix), make sure the "TZ" environment variable is set to a
  33.     valid and reasonable value; see your compiler docs for details.
  34.  
  35.  
  36.  
  37. To compile UnZip, UnZipSFX and/or fUnZip (detailed instructions):
  38. =========================================
  39.  
  40. (1) Unpack *.c and *.h (the actual source files), preserving the directory
  41.     structure (e.g., ./unix/unix.c).  The sole exception is TOPS-20, where
  42.     tops20/* should be unpacked into the current directory, but TOPS-20
  43.     is no longer fully supported anyway.
  44.  
  45.     If you wish to compile with decryption enabled, you must get the zcrypt
  46.     package (see the "Where" file).  Unpack crypt.c and crypt.h from the
  47.     zcrypt archive, overwriting the dummy versions supplied with UnZip.  If
  48.     you don't have any sort of unzipper available, you'll have to compile the
  49.     non-crypt version first and use that to unpack the full crypt sources,
  50.     then recompile.  (The zipcloak.c file included in the zcrypt archive is
  51.     for use only with the Zip 2.x sources, so don't bother unpacking it.)
  52.  
  53.  
  54. (2) Choose the appropriate makefile based on the description in the Con-
  55.     tents file for your OS (that is, there's only one for Unix or OS/2, but
  56.     MS-DOS and several other OSes have several, depending on the compiler).
  57.     Copy it into the current directory and rename if necessary or desired.
  58.     (Some makefiles can be invoked in place; see (5) below.)
  59.  
  60.     Special point of confusion:  some MS-DOS targets are in non-MSDOS
  61.     makefiles.  In particular, for DOS emx+gcc use the gccdos target of
  62.     the OS/2 makefile (os2/makefile.os2), and for djgpp use the gcc_dos
  63.     target of the Unix makefile (unix/Makefile).  In addition, OS/2 users
  64.     of MSC can cross-compile to MS-DOS with makefile.os2's mscdos target.
  65.  
  66.     Extra special point of confusion:  makefile.os2 expects to remain in
  67.     the os2 subdirectory.  Invoke it as "nmake -f os2/makefile.os2 gcc",
  68.     for example.
  69.  
  70.  
  71. (3) If you want a non-standard version of UnZip, define one or more of the
  72.     following optional macros, either by adding them to the LOCAL_UNZIP
  73.     environment variable or by editing your makefile as appropriate.  The
  74.     syntax differs from compiler to compiler, but macros are often defined
  75.     via "-DMACRO_NAME" or similar (for one called MACRO_NAME).  Note that
  76.     some of these may not be fully supported in future releases (or even
  77.     in the current release).  Note also that very short command lines in
  78.     MS-DOS (128 characters) may place severe limits on how many of these
  79.     can be used; if need be, the definitions can be placed at the top of
  80.     unzip.h instead (it is included in all source files)--for example,
  81.     "#define MACRO_NAME".
  82.  
  83.       DOSWILD   (MS-DOS only)
  84.         Treat trailing "*.*" like Unix "*" (i.e., matches anything); treat
  85.         trailing "*." as match for files without a dot (i.e., matches any-
  86.         thing, as long as no dots in name).  Special treatment only occurs
  87.         if patterns are at end of arguments; i.e., "a*.*" matches all files
  88.         starting with "a", but "*.*c" matches all files ending in "c" *only*
  89.         if they have a dot somewhere before the "c".  Thus "*.*.*" could be
  90.         used (albeit awkwardly) to specify all filenames with at least one
  91.         dot in them, and "*." matches all filenames with no dots in them.
  92.         [The default method of specifying these would be "*.*" and "* -x *.*",
  93.         respectively, where the second example makes use of UnZip's exclude-
  94.         files option.]  All other regular expressions (including "?" and
  95.         "[range_of_chars]") retain their Unix-like behavior.
  96.  
  97.       VMSWILD   (VMS only)
  98.         Use parentheses rather than brackets to delimit sets (ranges), and
  99.         use '%' instead of '?' as the single-character wildcard for internal
  100.         filename matching.  (External matching of zipfile names always uses
  101.         the standard VMS wildcard facilities; character sets are disallowed.)
  102.  
  103.       VMSCLI   (VMS only)
  104.         Use VMS-style "slash options" (/FOOBAR) instead of the default Unix-
  105.         style hyphenated options (-f).  This capability was added quite late
  106.         in the beta cycle and isn't fully tested, so some features may not
  107.         work as expected.  Also, it doesn't affect options stored in environ-
  108.         ment variables (UNZIP_OPTS or ZIPINFO_OPTS); those use the Unix style
  109.         regardless.
  110.  
  111.       CHECK_VERSIONS   (VMS only)
  112.         UnZip "extra fields" are used to store VMS (RMS) filesystem info,
  113.         and the format of this information may differ in various versions
  114.         of VMS.  Defining this option will enable UnZip warnings when the
  115.         stored extra-field VMS version(s) do(es) not match the version of
  116.         VMS currently being used.  This is a common occurrence in zipfiles
  117.         received from other sites, but since the format of the filesystem
  118.         does not seem to have changed in years (including on Alpha and Open-
  119.         VMS systems), the warnings are not enabled by default.
  120.  
  121.       RETURN_CODES   (VMS only)
  122.         VMS interprets return codes according to a rigid set of guidelines,
  123.         which means it misinterprets normal UnZip return codes as all sorts
  124.         of really nasty errors.  Therefore VMS UnZip returns an alternate set
  125.         of return codes; since these may be difficult to interpret, define
  126.         RETURN_CODES for human-readable explanations.
  127.  
  128.       ASM_CRC   (Amiga/Aztec C; many x86 systems:  DOS, OS/2, Win32, Unix)
  129.         Use an assembler routine to calculate the CRC for each file (speed).
  130.  
  131.       ASM_INFLATECODES   (Amiga/Aztec C only, for now)
  132.         Use an assembler version of inflate_codes() for speed.
  133.  
  134.       OLD_EXDIR
  135.         No longer supported.
  136.  
  137.       SFX_EXDIR
  138.         Enable the "-d <extract_dir>" option for UnZipSFX.  By default it is
  139.         disabled so as to generate the smallest possible executable stub, but
  140.         for use with automated installation scripts and the like it may be
  141.         useful to enable -d.
  142.  
  143.       NO_ZIPINFO
  144.         Compile without ZipInfo mode (-Z) enabled; makes a smaller executable
  145.         because many text strings are left out.  Automatically enabled for
  146.         some small-model compiles under MS-DOS and OS/2, so ordinarily there
  147.         is no need to specify this explicitly.  (Note that even with this
  148.         defined, the resulting executable may still be too big to extract
  149.         some zipfiles correctly, if compiled with the small memory model.)
  150.  
  151.       LZW_CLEAN
  152.         The "shrinking" algorithm from PKZIP 1.0 is an LZW variant.  Unisys
  153.         patented the Lempel-Ziv-Welch algorithm in 1985 and has publicly
  154.         claimed that decompression is covered by it.  (IBM also patented the
  155.         same thing in a filing 3 weeks prior to Unisys's.)  Unisys has also
  156.         publ