home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / zip22.zip / INSTALL < prev    next >
Text File  |  1997-10-06  |  7KB  |  182 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.      BeOS, 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, zip22.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 zip22.zip in the current directory.
  15.  
  16.           mkdir zipsrc
  17.           cd zipsrc
  18.           unzip ../zip22
  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 zcrypt27.zip and overwrite the dummy files
  24.      crypt.c and crypt.h.
  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 "UT" extra
  98.      fields (these ports contain USE_EF_UT_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.01 and newer)
  114.           make -f msdos/makefile.emx            (gcc/emx 0.9b and newer)
  115.           make -f os2/makefile.os2 gccdos       (gcc/emx 0.9b and newer)
  116.           wmake -f msdos\makefile.wat           (Watcom C 11.x 16-bit)
  117.           wmake -f msdos\makefile.wat PM=1      (Watcom C 11.x 32-bit, PMODE/W)
  118.  
  119.  
  120.      for Microsoft, Borland C++ and Turbo C, Watcom C/C++ and the various
  121.      free GNU C implementations, respectively. More detailed instructions
  122.      can be found in the respective makefiles.
  123.  
  124.  
  125.   WIN32 (Windows NT and Windows 95):
  126.  
  127.      Supported compilers are Microsoft Visual C++, Watcom C/C++ and
  128.      the free GNU C implementation gcc/emx+rsxnt. The makefiles supplied
  129.      in the win32/ subdirectory contain further information.
  130.  
  131.  
  132.   Windows DLL (Windows 3.1 16-bit and WIN32):
  133.  
  134.      Supported environments are Visual C++ 5.x (32-bit only) and
  135.      Borland C++ (4.52, and newer). For instructions how to build
  136.      the DLLs and where find the makefiles, look into windll/contents.
  137.  
  138.  
  139.   OS/2:
  140.  
  141.      Type
  142.  
  143.           {make} -f os2/makefile.os2
  144.  
  145.      to get a list of supported targets/compiling environments.
  146.      (replace "{make}" with the name of your OS/2 make utility.)
  147.  
  148.      To initiate the actual compiling process, you have to specify
  149.      a system target:
  150.  
  151.           {make} -f os2/makefile.os2 {system}
  152.  
  153.      An example: type
  154.  
  155.           nmake -f os2/makefile.os2 msc
  156.  
  157.      for Microsoft C 6.00.
  158.  
  159.  
  160.   VMS (OpenVMS):
  161.  
  162.      Apply
  163.  
  164.           @[.vms]make_zip
  165.  
  166.      or use DEC's MMS make utility (or the MMK clone) if available:
  167.  
  168.           mms /descr=[.vms]descrip.mms /macro=(__ALPHA__=1)   for Alpha AXP
  169.           mms /descr=[.vms]descrip.mms /macro=(__DECC__=1)    for DEC C on VAX
  170.           mms /descr=[.vms]descrip.mms /macro=(__VAXC__=1)    for VAX C
  171.           mms /descr=[.vms]descrip.mms /macro=(__GNUC__=1)    for GNU C on VAX
  172.  
  173.      (If you have installed both DEC C and VAX C on your VAX and want to use
  174.       the latter compiler, you should define the macro "__FORCE_VAXC__"
  175.       instead of "__VAXC__".)
  176.  
  177.      For further information please consult 00readme.txt in the vms/
  178.      subdirectory.
  179.  
  180. For command help on any of the zip* utilities, simply enter
  181. the name with no arguments.
  182.