view release on metacpan or  search on metacpan

unzip-6.0/INSTALL  view on Meta::CPAN

        Common files, such as the help libraries (UNZIP.HLP for the
        default UNIX-like command-line interface, UNZIP_CLI.HLP for the
        VMS-like command-line interface), are placed in the main
        directory.  With a mixed-architecture VMS cluster, the same main
        directory on a shared disk may may be used by all system types.
        (Using the NOHELP option with BUILD_UNZIP.COM can keep it from
        making the same help files repeatedly.)

        Some further information may be found in the files
        [.VMS]README. and [.VMS]00BINARY.VMS, though much of what's
        there is now obsolete.

      MS-DOS
        See the msdos\Contents file for notes regarding which makefile(s) to
        use with which compiler.  In summary:  pick one of msdos\makefile.*
        as appropriate, or (as noted above) use the OS/2 gccdos target for
        emx+gcc.  There is also an mscdos cross-compilation target in
        os2\makefile.os2 and a sco_dos cross-compilation target in the Unix
        makefile.  For Watcom 16-bit or 32-bit versions, see the comments in
        the OS/2 section below.

        After choosing the appropriate makefile and editing as necessary or
        desired, invoke the corresponding make utility.  Microsoft's NMAKE
        and the free dmake and GNU make utilities are generally the most
        versatile.  The makefiles in the msdos directory can be invoked in
        place ("nmake -f msdos\makefile.msc", for example).

      OS/2
        Either GNU make, nmake or dmake may be used with the OS/2 makefile;
        all are freely available on the net.  Do "nmake -f os2\makefile.os2",
        for example, to get a list of supported targets.  More generally,
        read the comments at the top of the makefile for an explanation of
        the differences between some of the same-compiler targets.

      Win32 (WinNT or Win9x)
        For creating Win32 executables, the Microsoft Visual C++ compiler
        platforms from version 2.x up to 8.0 (Visual Studio .Net C++ 2005)
        are supported.  Recent build test have been run on VC++ 6.0, 7.1
        and 8.0.  The linker of newer Microsoft Visual C++ versions (beginning
        with Visual C++ 2008 - [VC++ 9.0]) create executables that are marked
        to run on Windows 2000 and newer, only.  Although these Visual C++
        environments may succeed in building Win32 Info-ZIP executables,
        they cannot (and must not) be used to create binaries for public
        distribution.
        Alternative compilers for the Intel platforms are OpenWatcom C++,
        GNU C (preferably the mingw32 port, CygWin and emx/rsxnt may also
        work), Borland C++, or lcc-win32.
        DEC C/C++ for NT/Alpha may or may not still work.
        For the Watcom compiler, use WMAKE and win32\makefile.wat; for the
        Microsoft compilers, use NMAKE and win32\Makefile; for mingw32 and
        CygWin, GNU Make and win32\Makefile.gcc should do the job.
        With emx+gcc, a good choice is GNUMake 3.75 (or higher) from the
        djgpp V2 distribution used on win32\Makefile.emx.

        The unzip32.dll WinDLL executables can be built using the appropiate
        Makefile in the win32\ subdirectory, or by using the Microsoft Visual
        C++ project files supplied below the windll subdirectory.  Besides the
        MSC compilers, gcc-mingw32, Watcom C and Borland C allow to build the
        Windows UnZip DLL.  By default, the Makefiles for compilers that use
        the Microsoft C runtime are configured to link against the shared
        multithreading C runtime DLL.  Depending on the intended usage for
        unzip32.dll, a statically linked dll might be more suitable.  The
        make scripts for MSC support build variants with static linking; you
        should look up the configuration switch DLLSTANDALONE in the MSC
        Makefile or the "Static..." build configurations in the Visual Studio
        project files.

      WinCE (WinCE or WinNT)
        Only Microsoft Visual C++ 5.0, 6.0 or Visual C++ embedded 3.0 or later
        are supported.  Use the appropiate version of the included project
        files and check wince\README for details.

      AmigaDOS
        SAS/Lattice C and Manx Aztec C are supported.  For SAS C 6.x do "smake
        -f amiga/smakefile all"; for Aztec C do "make -f amiga/makefile.azt
        all".  The Aztec C version supports assembly-language versions of two
        routines; these are enabled by default.

      Atari TOS
        Turbo C is no longer supported; use gcc and the MiNT libraries, and
        do "make".  Note that all versions of gcc prior to 2.5.8 have a bug
        affecting 68000-based machines (optimizer adds 68020 instructions).
        See atari\README for comments on using other compilers.

      Macintosh
        Metrowerks CodeWarrior Pro 4 with Universal Interfaces 3.1 is the only
        currently supported compiler, although the Mac Programmer's Workbench
        (MPW) and Think C were supported at one time and still have some hooks.
        Other Compilers may work too, no compiler specific instructions
        (pragma, header, macros, ...) were used in the code.
        For CodeWarrior Pro 4, un-BinHex the CodeWarrior project file and
        UnZip resource file (using Stuffit Expander or BinHex 4.0 or later),
        then open the project and click on the compile button.
        See ":macos:Contents" for the possible project targets.
        Link order of the standard libraries is very important: Link all
        sources first and all standard libraries last.

      Acorn (RISC OS)
        Extract the files from the archive and place in standard 'Acorn' C
        form (i.e., *.c, *.h and *.s become c.*, h.* and s.*, respectively),
        either using the UNZIP$EXTS environment variable and a pre-built UnZip
        binary, or using Spark[FS] and doing it manually.  Then copy the
        Acorn.Makefile to the main UnZip directory and either type 'amu' or
        use the desktop make utility.

      VM/CMS
        Unpack all the files and transfer them with ASCII -> EBCDIC conver-
        sion to an appropriate directory/minidisk/whatever, then execute
        UNZVMC to compile and link all the sources.  This may require C/370
        version 2.1 or later and certain `nucleus extensions,' although
        UnZip 5.3 has been reported to compile fine with the `ADCYCLE C/370
        v1.2 compiler.'  Note that it will abend without access to the C/370
        runtime library.  See the README.CMS file for more details.

      MVS
        Unpack all the files and transfer them to an appropriate PDS with
        ASCII -> EBCDIC conversion enabled, then edit UNZMVSC.JOB as required,
        and execute it to compile and link all the sources.  C/370 2.1 or
        later is required.  See README.MVS for further details.  [This is a
        new port and may need a little more work even to compile.]