home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / zip21.zip / install.doc < prev    next >
Text File  |  1996-04-27  |  6KB  |  164 lines
  1. HOW TO INSTALL ZIP
  2.  
  3.      Zip is distributed as C source code that can be compiled on a
  4.      wide range of systems: Unix, VMS, MSDOS, OS/2, NT, Amiga, Atari,
  5.      VM/CMS, ...  You will need Unzip 5.0p1 (under any system) or
  6.      PKUNZIP 2.04g or later (under MSDOS) to unpack the distribution
  7.      file, zip21.zip. But since you read this, you have unpacked it
  8.      already, or you cheated and got a tar.Z file...
  9.  
  10. Installation on Unix
  11.  
  12.      Let's assume that you start from scratch and have not yet
  13.      unpacked the sources. First, unpack the source as follows,
  14.      assuming that you have zip21.zip in the current directory.
  15.  
  16.           mkdir zipsrc
  17.           cd zipsrc
  18.           unzip ../zip21
  19.  
  20.      This extracts all source files and documentation in the
  21.      directory called "zipsrc". If you wish to build a version
  22.      of zip with encryption capabilities, you must also get the
  23.      separate package zcrypt26.zip and overwrite the dummy files
  24.      crypt.c, crypt.h and zipcloak.c.
  25.  
  26.      You then do:
  27.  
  28.           make -f unix/Makefile system
  29.  
  30.      where "system" is one of: generic, generic_gcc,
  31.      att6300, coherent, cray_v3, minix, sco_x286, xenix, zilog.
  32.  
  33.      Try "make -f unix/Makefile generic" first, this works on many systems.
  34.      If this fails, then use one of the special targets given above.
  35.  
  36.      Among other special systems are Cray Unicos, Zilog Zeus and MINIX.
  37.  
  38.      If you get error messages "constant expected" in deflate.c, add
  39.      -DDYN_ALLOC to CFLAGS in your makefile entry.
  40.  
  41.      If you have lots of memory, try compiling with -DBIG_MEM. If your
  42.      system supports mmap(), try compiling with -DMMAP. This generally
  43.      gives faster compression but uses more memory. See the unix/Makefile
  44.      entry mmap_gcc for an example.
  45.  
  46.      If none of these compiles, links, and functions properly on
  47.      your Unix system, see the file README for how to get help.
  48.  
  49.      If the appropriate system was selected, then the executables
  50.      zip, zipnote and zipsplit will be created.  You can copy them
  51.      to an appropriate directory in the search path using:
  52.  
  53.           make -f unix/Makefile install
  54.  
  55.      The defaults are /usr/local/bin for the executables and
  56.      /usr/man/man1 for the manual page. Change the macros BINDIR
  57.      and MANDIR in makefile if appropriate.
  58.  
  59.      You can use the command "set" to see the current search
  60.      path.  If you are using the C-Shell (csh), enter the com-
  61.      mand:
  62.  
  63.           rehash
  64.  
  65.      so csh can find the new command in the path.  You are now
  66.      ready to use Zip.
  67.  
  68.      You can get rid of the now unnecessary source and object
  69.      files with:
  70.  
  71.           cd ..
  72.           rm -r zipsrc
  73.  
  74.      This will remove the directory zip and its contents created
  75.      by unzip.  You should keep the zip20.zip file around though,
  76.      in case you need to build it again or want to give it to a
  77.      colleague.
  78.  
  79.      You can add the following lines to the file /etc/magic for
  80.      usage by the 'file' command:
  81.  
  82. 0    string        PK        Zip archive
  83. >4    byte        011        (at least v0.9 to extract)
  84. >4    byte        012        (at least v1.0 to extract)
  85. >4    byte        013        (at least v1.1 to extract)
  86. >4    byte        024        (at least v2.0 to extract)
  87. >4      byte            025             (at least v2.0 to extract)
  88.  
  89.  
  90. Installation on other systems
  91.  
  92.      The steps for installation under VMS, MSDOS, OS/2, NT, Amiga and
  93.      Atari are similar to the above: first unzip the distribution
  94.      files into their own directory. The system dependant files are
  95.      stored in special subdirectories.
  96.  
  97.      For all the non-unix ports which support the creation of "UX" extra
  98.      fields (these port contain USE_EF_UX_TIME in the list of optional
  99.      features displayed with "zip -v"), the timezone environment variable TZ
  100.      should be set according to the local timezone in order for the -f,
  101.      -u and -o options to work correctly.
  102.  
  103.   MSDOS:
  104.  
  105.      Do one of:
  106.  
  107.           make msdos\makefile.msc               (Microsoft C 5.1)
  108.           nmake -f msdos\makefile.msc           (Microsoft C 6.0 and newer)
  109.           make -fmsdos\makefile.bor -DCC_REV=1  (Borland Turbo C++ 1.0)
  110.           make -fmsdos\makefile.bor             (Borland C++ 2.0 and newer)
  111.           make -fmsdos\makefile.tc              (Borland Turbo C 2.0)
  112.           make -f msdos/makefile.dj1            (DJGPP v1.12m4)
  113.           make -f msdos/makefile.dj2            (DJGPP v2)
  114.           make -f os2/makefile.os2 gccdos       (gcc/emx 0.9b and newer)
  115.           make -f wizdll\zipdll16.mak           (Borland C++ 2.0 and newer)
  116.           make -f wizdll\zipdll32.mak           (Borland C++ 2.0 and newer)
  117.  
  118.      for Microsoft, Borland C++ and Turbo C, and the various free GNU C
  119.      implementations, respectively.
  120.  
  121.  
  122.   OS/2:
  123.  
  124.      Type
  125.  
  126.           {make} -f os2/makefile.os2
  127.  
  128.      to get a list of supported targets/compiling environments.
  129.      (replace "{make}" with the name of your OS/2 make utility.)
  130.  
  131.      To initiate the actual compiling process, you have to specify
  132.      a system target:
  133.  
  134.           {make} -f os2/makefile.os2 {system}
  135.  
  136.      An example: type
  137.  
  138.           nmake -f os2/makefile.os2 msc
  139.  
  140.      for Microsoft C 6.00.
  141.  
  142.   VMS (OpenVMS):
  143.  
  144.      Apply
  145.  
  146.           @[.vms]make_zip
  147.  
  148.      or use DEC's MMS make utility (or the MMK clone) if available:
  149.  
  150.           mms /descr=[.vms]descrip.mms /macro=(__ALPHA__=1)   for Alpha AXP
  151.           mms /descr=[.vms]descrip.mms /macro=(__DECC__=1)    for DEC C on VAX
  152.           mms /descr=[.vms]descrip.mms /macro=(__VAXC__=1)    for VAX C
  153.           mms /descr=[.vms]descrip.mms /macro=(__GNUC__=1)    for GNU C on VAX
  154.  
  155.      (If you have installed both DEC C and VAX C on your VAX and want to use
  156.       the latter compiler, you should define the macro "__FORCE_VAXC__"
  157.       instead of "__VAXC__".)
  158.  
  159.      For further information please consult 00readme.txt in the vms/
  160.      subdirectory.
  161.  
  162. For command help on any of the zip* utilities, simply enter
  163. the name with no arguments.
  164.