home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip532.zip / INSTALL < prev    next >
Text File  |  1997-10-21  |  26KB  |  483 lines
  1. __________________________________________________________________________
  2.  
  3.   This is the Info-ZIP file INSTALL (for UnZip), last updated 20 Oct 97.
  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.
  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., everybody
  32.     but Unix, Windows 95 and NT), make sure the "TZ" environment variable is
  33.     set to a 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.
  51.  
  52.  
  53. (2) Choose the appropriate makefile based on the description in the Con-
  54.     tents file for your OS (that is, there's only one for Unix or OS/2, but
  55.     MS-DOS and several other OSes have several, depending on the compiler).
  56.     Copy it into the current directory and rename if necessary or desired.
  57.     (Some makefiles can be invoked in place; see (5) below.)
  58.  
  59.     Don't be afraid to read the makefile!  Many options will be explained only
  60.     in the comments contained therein.  The defaults may not quite suit your
  61.     system.  When making changes, remember that some "make" utilities expect
  62.     tabs as part of the makefile syntax.  Failure with cryptic error messages
  63.     will result if your editor quietly replaces those tabs with spaces.
  64.  
  65.     Special point of confusion:  some non-MSDOS makefiles contain MS-DOS
  66.     targets (useful for cross-compilations). An example is the OS/2 makefile
  67.     os2/makefile.os2 that contains the gccdos target for DOS emx+gcc and
  68.     some more DOS related targets for Watcom C and MSC. But since version 5.3,
  69.     the msdos subdirectory contains makefiles for all supported DOS compilers.
  70.     [The old djgpp, djgpp1 and gcc_dos targets in unix/Makefile have been
  71.     removed in 5.3; use msdos/makefile.dj* instead.]
  72.  
  73.     Extra-special point of confusion:  makefile.os2 expects to remain in
  74.     the os2 subdirectory.  Invoke it via "nmake -f os2/makefile.os2 gcc",
  75.     for example.
  76.  
  77.  
  78. (3) If you want a non-standard version of UnZip, define one or more of the
  79.     following optional macros, either by adding them to the LOCAL_UNZIP
  80.     environment variable or by editing your makefile as appropriate.  The
  81.     syntax differs from compiler to compiler, but macros are often defined
  82.     via "-DMACRO_NAME" or similar (for one called MACRO_NAME).  Note that
  83.     some of these may not be fully supported in future releases (or even
  84.     in the current release).  Note also that very short command lines in
  85.     MS-DOS (128 characters) may place severe limits on how many of these
  86.     can be used; if need be, the definitions can be placed at the top of
  87.     unzip.h instead (it is included in all source files)--for example,
  88.     "#define MACRO_NAME", one macro per line.
  89.  
  90.       DOSWILD   (MS-DOS only)
  91.         Treat trailing "*.*" like Unix "*" (i.e., matches anything); treat
  92.         trailing "*." as match for files without a dot (i.e., matches any-
  93.         thing, as long as no dots in name).  Special treatment only occurs
  94.         if patterns are at end of arguments; i.e., "a*.*" matches all files
  95.         starting with "a", but "*.*c" matches all files ending in "c" *only*
  96.         if they have a dot somewhere before the "c".  Thus "*.*.*" could be
  97.         used (albeit awkwardly) to specify all filenames with at least one
  98.         dot in them, and "*." matches all filenames with no dots in them.
  99.         [The default method of specifying these would be "*.*" and "* -x *.*",
  100.         respectively, where the second example makes use of UnZip's exclude-
  101.         files option.]  All other regular expressions (including "?" and
  102.         "[range_of_chars]") retain their Unix-like behavior.
  103.  
  104.       VMSWILD   (VMS only)
  105.         Use parentheses rather than brackets to delimit sets (ranges), and
  106.         use '%' instead of '?' as the single-character wildcard for internal
  107.         filename matching.  (External matching of zipfile names always uses
  108.         the standard VMS wildcard facilities; character sets are disallowed.)
  109.  
  110.       VMSCLI   (VMS only)
  111.         Use VMS-style "slash options" (/FOOBAR) instead of the default Unix-
  112.         style hyphenated options (-f).  This capability does not affect options
  113.         stored in environment variables (UNZIP_OPTS or ZIPINFO_OPTS); those use
  114.         the Unix style regardless. Beginning with UnZip 5.32, the supplied
  115.         VMS Makefiles and make procedures generate both VMS-style and default
  116.         "UNIX style" executables; you should NOT add VMSCLI to the custom
  117.         options.
  118.  
  119.       CHECK_VERSIONS   (VMS only)
  120.         UnZip "extra fields" are used to store VMS (RMS) filesystem info,
  121.         and the format of this information may differ in various versions
  122.         of VMS.  Defining this option will enable UnZip warnings when the
  123.         stored extra-field VMS version(s) do(es) not match the version of
  124.         VMS currently being used.  This is a common occurrence in zipfiles
  125.         received from other sites, but since the format of the filesystem
  126.         does not seem to have changed in years (including on Alpha and Open-
  127.         VMS systems), the warnings are not enabled by default.
  128.  
  129.       RETURN_CODES   (VMS only)
  130.         VMS interprets return codes according to a rigid set of guidelines,
  131.         which means it misinterprets normal UnZip return codes as all sorts
  132.         of really nasty errors.  Therefore VMS UnZip returns an alternate set
  133.         of return codes; since these may be difficult to interpret, define
  134.         RETURN_CODES for human-readable explanations.
  135.  
  136.       VMS_TEXT_CONV   (everybody except VMS)
  137.         VMS text files archived with the "-V" option are only semi-readable at
  138.         best when extracted on other systems.  Defining this option enables
  139.         UnZip's -aa option to attempt to convert such files to native text
  140.         format.  Non-VMS UnZips don't actually detect the precise VMS format
  141.         of the files, however, but instead rely on some reasonably good
  142.         heuristics (i.e., guesses).  Therefore this option is not enabled by
  143.         default, but it can be extremely useful on those rare occasions when
  144.         a VMS text file must be extracted as normal text.
  145.  
  146.       USE_VFAT   (MS-DOS only, for using same executable under DOS and Win95/NT)
  147.         djgpp 2.x and emx/gcc+RSX 5.1 can detect when they are running under a
  148.         Win32 DOS box and will accordingly enable long-filename support.  For
  149.         now only djgpp 2.x and emx/gcc with RSX 5.1 or later have this feature
  150.         (and it is defined by default in msdos/makefile.dj2 and makefile.emx),
  151.         but if/when other compilers build in similar support, define this
  152.         macro to enable its use.  See also msdos/doscfg.h.  [Note that djgpp
  153.         2.0's LFN support is flaky; users should upgrade to 2.01 or later.]
  154.  
  155.       NOTIMESTAMP
  156.         This option disables the -T option, which basically does exactly what
  157.         Zip's -go options do (i.e., set the timestamp of the zipfile to that of
  158.         the newest file in the archive without rewriting the archive).  Unlike
  159.         Zip, however, UnZip supports wildcard specifications for the archive
  160.         name; for example, "unzip -T *.zip" will set the dates of all zipfiles
  161.         in the current directory.  (UnZip's option is also much faster.)
  162.  
  163.       DATE_FORMAT=DF_DMY or DF_MDY or DF_YMD
  164.         This option controls the order in which date components are printed
  165.         in listings:  day-month-year or month-day-year or year-month-day.
  166.         For DOS derivatives the format is automatically obtained from the
  167.         operating system; most others default to DF_MDY.
  168.  
  169.       UNIXBACKUP   (Unix only)
  170.         This option enables a -B option that instructs UnZip to rename files
  171.         that would normally be overwritten.  The renamed files are given a
  172.         tilde suffix (`~').  Note that previously renamed files may be over-
  173.         written without notice, even if the -n option is given.
  174.  
  175.       OS2_EAS
  176.         List the sizes of OS/2 EAs and ACLs for each file as two extra columns
  177.         in "unzip -l" output.  This is primarily useful for OS/2 systems, but
  178.         because zipfiles are portable, OS2_EAS can be defined for any system.
  179.         (May be extended someday to show sizes of Mac resource forks, RISCOS
  180.         and VMS file info, etc.)
  181.  
  182.       DELETE_IF_FULL  (anybody with unlink() function)
  183.         If a write error is encountered (most likely due to a full disk),
  184.         enabling this option will cause the incomplete file to be deleted
  185.         instead of closed normally.  This is particularly useful for the
  186.         Windows CE port, which must generally contend with extremely limited
  187.         resources.
  188.  
  189.       ASM_CRC   (Amiga/Aztec C; many x86 systems:  DOS, OS/2, Win32, Unix)
  190.         Use an assembler routine to calculate the CRC for each file (speed).
  191.  
  192.       ASM_INFLATECODES   (Amiga/Aztec C only, for now)
  193.         Use an assembler version of inflate_codes() for speed.
  194.  
  195.       OLD_EXDIR
  196.         No longer supported.
  197.  
  198.       SFX_EXDIR
  199.         Enable the "-d <extract_dir>" option for UnZipSFX.  By default it is
  200.         disabled so as to generate the smallest possible executable stub, but
  201.         for use with automated installation scripts and the like it may be
  202.         useful to enable -d.
  203.  
  204.       NO_ZIPINFO
  205.         Compile without ZipInfo mode (-Z) enabled; makes a smaller executable
  206.         because many text strings are left out.  Automatically enabled for
  207.         some small-model compiles under MS-DOS and OS/2, so ordinarily there
  208.         is no need to specify this explicitly.  (Note that even with this
  209.         defined, the resulting executable may still be too big to extract
  210.         some zipfiles correctly, if compiled with the small memory model.)
  211.  
  212.       LZW_CLEAN   (now default)
  213.       USE_UNSHRINK
  214.         The "shrinking" algorithm from PKZIP 1.0 is an LZW variant.  Unisys
  215.         patented the Lempel-Ziv-Welch algorithm in 1985 and has publicly
  216.         claimed that decompression is covered by it.  (IBM also patented the
  217.         same thing in a filing 3 weeks prior to Unisys's.)  Therefore un-
  218.         shrinking is disabled by default, but those with LZW licenses can
  219.         enable it by defining USE_UNSHRINK.  (Unshrinking was used by PKZIP
  220.         1.0 and 1.1, and Zip 1.0 and 1.1.  All newer archives use only the
  221.         deflation method.)
  222.  
  223.       COPYRIGHT_CLEAN   (now default)
  224.       USE_SMITH_CODE
  225.         The last chunk of code in UnZip that was blatantly derived from Sam
  226.         Smith's unzip 2.0 (as in, "substantially similar") is in unreduce.c.
  227.         Since reducing was only used by very early PKZIP beta versions (0.9x),
  228.         support for it is now omitted by default (COPYRIGHT_CLEAN).  To in-
  229.         clude unreducing capability, define USE_SMITH_CODE.  Note that this
  230.         subjects UnZip to any and all restrictions in Smith's copyright; see
  231.         the UnZip COPYING file for details.
  232.  
  233.       PASSWD_FROM_STDIN   (with full crypt sources only; Unix, VMS only)
  234.         Used to allow the password on encrypted files to be read from stdin
  235.         rather than the default stderr.  This was useful for those who wished
  236.         to automate the testing or decoding of encrypted archives (say, in a
  237.         shell script via ``echo "password" | unzip -tq archive''), but as of
  238.         version 5.3, UnZip has a -P option for passing a password directly to
  239.         the program.  PASSWD_FROM_STDIN will therefore probably be phased out
  240.         in future versions.  Note that the same security warnings given in the
  241.         description of the -P option apply here as well.
  242.  
  243.       DEBUG
  244.         Used for debugging purposes; enables Trace() statements.  Generally
  245.         it's best to compile only one or two modules this way.
  246.  
  247.       DEBUG_TIME
  248.         Used for debugging the timezone code in fileio.c; enables TTrace()
  249.         statements.  This code is only used for the freshen/update options
  250.         (-f and -u), and non-Unix compilers often get it wrong.
  251.  
  252.  
  253. (4) If you regularly compile new versions of UnZip and always want the same
  254.     non-standard option(s), you may wish to add it (them) to the LOCAL_UNZIP
  255.     environment variable (assuming it's supported in your makefile).  Under
  256.     MS-DOS, for example, add this to AUTOEXEC.BAT:
  257.  
  258.         set LOCAL_UNZIP=-DDOSWILD -DDATE_FORMAT=DF_DMY
  259.  
  260.     You can also use the variable to hold special compiler options (e.g.,
  261.     -FPi87 for Microsoft C, if the x87 libraries are the only ones on your
  262.     disk and they follow Microsoft's default naming conventions; MSC also
  263.     supports the CL environment variable, however).
  264.  
  265.  
  266. (5) Run the make utility on your chosen makefile:
  267.  
  268.       Unix
  269.         For most systems it's possible to invoke the makefile in place, at
  270.         the possible cost of an ignorable warning; do "make -f unix/Makefile
  271.         list" to get a list of possible system targets, and then "make -f
  272.         unix/Makefile target" for your chosen target.  The "generic" target
  273.         works for most systems, but if it fails with a message about ftime()
  274.         unresolved or timezone redefined, do "make clean", "make help", and
  275.         then either "make generic2" or "make generic3" as instructed.  If all
  276.         else fails, read the makefile itself; it contains numerous comments.
  277.         (One of these days we'll make a configure script that automates this
  278.         procedure better.)
  279.  
  280.       VMS
  281.         For a one-time build of the default UnZip, simply run the supplied
  282.         command file MAKE_UNZ.COM.  To use either DEC C on an Alpha or the
  283.         default compiler (DEC C if available, else VAX C) on a VAX, type
  284.         "@make_unz" (after copying make_unz.com into the current directory;
  285.         otherwise do "@[.vms]make_unz" to invoke it in place).
  286.         If you want to force the use of VAX C when both VAX C and DEC C are
  287.         available, do "@make_unz vaxc" (or "@[.vms]make_unz vaxc").
  288.         To use GNU C (gcc) on either platform, do "@make_unz gnuc".
  289.         (NOTE: Currently, gcc for VMS(AXP) is not yet available!)
  290.         The command procedure MAKE_UNZ.COM now recognizes custom feature
  291.         options supplied in the logical name LOCAL_UNZIP; details are
  292.         explained in the comments at the top of MAKE_UNZ.COM.
  293.  
  294.         For repeated makes or other hacker-like tinkering with the sources,
  295.         or to create a custom version of UnZip, you may use the included "MMS"
  296.         makefile, DESCRIP.MMS.  Copy it into the current directory, read the
  297.         comments at the top of it and run MadGoat's free MMS clone "MMK" on it.
  298.         Newer versions of DEC's MMS should work, too, but older ones apparently
  299.         choke on some MMK-specific extensions in DESCRIP.MMS.  (If somebody
  300.         has an "older" version that works, let us know and we'll remove this
  301.         caveat.)
  302.  
  303.       MS-DOS
  304.         See the msdos\Contents file for notes regarding which makefile(s) to
  305.         use with which compiler.  In summary:  pick one of msdos\makefile.*
  306.         as appropriate, or (as noted above) use the OS/2 gccdos target for
  307.         emx+gcc.  There is also an mscdos cross-compilation target in
  308.         os2\makefile.os2 and a sco_dos cross-compilation target in the Unix
  309.         makefile.  For Watcom 16-bit or 32-bit versions, see the comments in
  310.         the OS/2 section below.
  311.  
  312.         After choosing the appropriate makefile and editing as necessary or
  313.         desired, invoke the corresponding make utility.  Microsoft's NMAKE
  314.         and the free dmake and GNU make utilities are generally the most
  315.         versatile.  The makefiles in the msdos directory can be invoked in
  316.         place ("nmake -f msdos\makefile.msc", for example).
  317.  
  318.       OS/2
  319.         Either GNU make, nmake or dmake may be used with the OS/2 makefile;
  320.         all are freely available on the net.  Do "nmake -f os2\makefile.os2",
  321.         for example, to get a list of supported targets.  More generally,
  322.         read the comments at the top of the makefile for an explanation of
  323.         the differences between some of the same-compiler targets.
  324.  
  325.       Win32 (WinNT or Win95)
  326.         You will need Microsoft Visual C++ 2.x for Win95 or NT (Intel, MIPS,
  327.         Alpha, PowerPC?), or Watcom C++ for Win95 or NT (Intel only). As an
  328.         alternative for Intel platforms, GNU C (the emx/rsxnt port) is now
  329.         supported as well. DEC C/C++ for NT/Alpha may or may not still work.
  330.         For the Watcom compiler, use WMAKE and win32\makefile.wat; for the
  331.         others, use NMAKE and win32\Makefile. With emx+gcc, a good choice is
  332.         GNUMake 3.75 from the djgpp V2.01 distribution.
  333.  
  334.       WinCE (WinCE or WinNT)
  335.         Only Microsoft Visual C++ 5.0 or later is supported.  Use the included
  336.         project file and check wince\README for details.
  337.  
  338.       AmigaDOS
  339.         SAS/Lattice C and Manx Aztec C are supported.  For SAS C 6.x do "smake
  340.         -f amiga/smakefile all"; for Aztec C do "make -f amiga/makefile.azt
  341.         all".  The Aztec C version supports assembly-language versions of two
  342.         routines; these are enabled by default.
  343.  
  344.       Atari TOS
  345.         Turbo C is no longer supported; use gcc and the MiNT libraries, and
  346.         do "make".  Note that all versions of gcc prior to 2.5.8 have a bug
  347.         affecting 68000-based machines (optimizer adds 68020 instructions).
  348.         See atari\README for comments on using other compilers.
  349.  
  350.       Macintosh
  351.         Think C is the only currently supported compiler, although the Mac
  352.         Programmer's Workbench (MPW) was supported at one time and still has
  353.         hooks in unzip.h.  For Think C, un-BinHex the Think C project file and
  354.         UnZip resource file (using Stuffit Expander or BinHex 4.0 or later),
  355.         then open the project and click on the compile button.
  356.  
  357.       Acorn (RISC OS)
  358.         Extract the files from the archive and place in standard 'Acorn' C
  359.         form (i.e., *.c, *.h and *.s become c.*, h.* and s.*, respectively),
  360.         either using the UNZIP$EXTS environment variable and a pre-built UnZip
  361.         binary, or using Spark[FS] and doing it manually.  Then copy the
  362.         Acorn.Makefile to the main UnZip directory and either type 'amu' or
  363.         use the desktop make utility.
  364.  
  365.       VM/CMS
  366.         Unpack all the files and transfer them with ASCII -> EBCDIC conver-
  367.         sion to an appropriate directory/minidisk/whatever, then execute
  368.         UNZVMC to compile and link all the sources.  This may require C/370
  369.         version 2.1 or later and certain `nucleus extensions,' although
  370.         UnZip 5.3 has been reported to compile fine with the `ADCYCLE C/370
  371.         v1.2 compiler.'  Note that it will abend without access to the C/370
  372.         runtime library.  See the README.CMS file for more details.
  373.  
  374.       MVS
  375.         Unpack all the files and transfer them to an appropriate PDS with
  376.         ASCII -> EBCDIC conversion enabled, then edit UNZMVSC.JOB as required,
  377.         and execute it to compile and link all the sources.  C/370 2.1 or
  378.         later is required.  See README.MVS for further details.  [This is a
  379.         new port and may need a little more work even to compile.]
  380.  
  381.       Human68K
  382.         [This is a Japanese machine and OS.]  It appears that GNU make and
  383.         gcc are required; presumably just do "gmake -f human68k/Makefile.gcc"
  384.         to build everything.  This port has not been tested since the 5.12
  385.         release.
  386.  
  387.       TOPS-20
  388.         [No longer fully supported due to new, unported features, although
  389.         patches are always accepted.]  Unpack all files into the current
  390.         directory only (including those in the zipfile's tops20 directory),
  391.         then use make.mic and "do make".
  392.  
  393.       BeOS
  394.         You can run the BeOS makefile in place by typing "make -f
  395.         beos/Makefile".  In fact, this is how the author tests it.
  396.  
  397.     Running the appropriate make utility should produce three executables on
  398.     most systems, one for UnZip/ZipInfo, one for UnZipSFX, and one for fUnZip.
  399.     (VMS is one prominent exception:  fUnZip makes no sense on it.  The Amiga
  400.     produces a fourth executable called MakeSFX, which is necessary because
  401.     Amiga self-extracting archives cannot be created by simple concatenation.
  402.     If necessary the source amiga/makesfx.c can be compiled on other systems.)
  403.     Read any OS-specific README files for notes on setting things up for
  404.     normal use (especially for VMS) and for warnings about known quirks and
  405.     bugs in various compilers (especially for MS-DOS).
  406.  
  407.     Also note that many OSes require a timezone variable to be set correctly
  408.     (often "TZ"); Unix and VMS generally do so by default, Win95/NT do if set
  409.     up properly, but other OSes generally do not.  See the discussion of the
  410.     -f and -u options in the UnZip man page (or unzip.doc).  BeOS doesn't
  411.     currently support timezone information at all, but this will probably be
  412.     added soon.
  413.  
  414.     Then test your new UnZip on a few archives and let us know if there are
  415.     problems (but *please* first make certain that the archives aren't actu-
  416.     ally corrupted and that you didn't make one of the silly mistakes dis-
  417.     cussed in the documentation).  If possible, double-check any problems
  418.     with PKUNZIP or with a previous version of UnZip prior to reporting a
  419.     "bug."  The zipfile itself may be damaged.
  420.  
  421.  
  422.  
  423. To install:
  424. ===========
  425.  
  426. Unix
  427.   The default prefix for the installation location is /usr/local (things
  428.   go into the bin and man/man1 subdirectories beneath the prefix), and
  429.   the default man-page extension is "1" (corresponding to man/man1, above).
  430.   To install as per the defaults, do "make install"; otherwise do "make
  431.   prefix=/your/path manext=your_extension install".  (For Intel Unix flavors
  432.   where the assembler CRC routines were used [ASM_CRC], use the install_asm
  433.   target instead of the regular install target.)  For example, to install
  434.   in your home directory with "l" as the man-page extension (for "local"),
  435.   do "make prefix=$HOME manext=l install".  Permissions will be 755 for the
  436.   executables and 644 for the man pages.  In general root must perform in-
  437.   stallation into a public directory.  Do "rehash" if your shell requires
  438.   it in order to find the new executables.
  439.  
  440. VMS
  441.   Install UnZip as foreign symbol by adding this to login.com:
  442.  
  443.        $ unzip == "$disk:[dir]unzip.exe"
  444.        $ zipinfo == "$disk:[dir]unzip.exe ""-Z"""
  445.  
  446.   where "disk" and "dir" are the location of the UnZip executable; the "$"
  447.   before the disk name is important, as are the double-double-quotes around
  448.   the -Z.  Some people, including the author, prefer a short alias such as
  449.   "ii" instead of "zipinfo"; edit to taste.  Optionally also install unzipsfx
  450.   for use with the MAKESFX.COM command file.  See vms/README (or [.VMS]README.)
  451.   for details on this and for notes/warnings about zipfiles and UnZip under
  452.   VMS.
  453.  
  454. OS/2, MS-DOS, NT, Atari, Amiga
  455.   Move or copy unzip.exe (or unzip.ttp, or UnZip, or whatever) to a direc-
  456.   tory in your path; also possibly copy the UnZip executable to zipinfo.exe
  457.   (or ii.exe), or else create an alias or a batch/command file for ZipInfo
  458.   ("@unzip -Z %1 %2 %3 %4 %5 %6 %7 %8 %9" under MS-DOS).  The latter is only
  459.   relevant if NO_ZIPINFO was *not* defined, obviously...  Under djgpp 2.x,
  460.   zipinfo.exe is a 2K stub symbolically linked to unzip.exe.
  461.  
  462. Acorn RISC OS
  463.   Copy the executables unzip, funzip and zipinfo to somewhere in your
  464.   Run$Path.  See your Welcome manual if you don't know about Run$Path.
  465.  
  466. BeOS
  467.   The default prefix for the installation location is /boot/usr/local
  468.   (things go into the bin and man/man1 subdirectories beneath the prefix),
  469.   and the default man-page extension is "1" (corresponding to the man/man1,
  470.   above).  Of course, these Unix man-pages aren't useful until someone ports
  471.   something that can format them... plain text versions are also installed
  472.   with an extension of ".doc".  To install, do a "make install", or to
  473.   change the prefix, do "make prefix=/your/path install".  For example, to
  474.   install in /boot/bin, do "make prefix=/boot/bin install".
  475.  
  476. Macintosh
  477.   Move the executable(s) somewhere--for example, drag it (or them) to your
  478.   Applications folder.  For easy access, make an alias in the Launcher Control
  479.   Panel or directly on your desktop.
  480.  
  481. Human68K, TOPS-20, AOS/VS, MVS, VM/CMS, etc.
  482.   Dunno, sorry...
  483.