view release on metacpan or  search on metacpan

unzip-6.0/INSTALL  view on Meta::CPAN

        method, you may still disable it by defining LZW_CLEAN.
        (Unshrinking was used by PKZIP 1.0 and 1.1, and Zip 1.0 and 1.1.
        All newer archives use only the deflation method.)

      COPYRIGHT_CLEAN   (now default)
      USE_SMITH_CODE
        The last chunk of code in UnZip that was blatantly derived from Sam
        Smith's unzip 2.0 (as in, "substantially similar") is in unreduce.c.
        Since reducing was only used by very early PKZIP beta versions (0.9x),
        support for it is now omitted by default (COPYRIGHT_CLEAN).  To in-
        clude unreducing capability, define USE_SMITH_CODE and replace the
        stub unreduce.c source file by the separatly distributed full source
        code module.  Note that this subjects UnZip to any and all restrictions
        in Smith's copyright; see the UnZip COPYING.OLD file for details.

      USE_CRYPT
        Enable decryption support for all binaries.  The default setting
        is to disable decryption support for the SFX stub to keep its size
        as small as possible. For other binaries of the UnZip distribution,
        decryption support is enabled by default.

      NO_CRYPT
        Disable decryption support for all binaries.

      PASSWD_FROM_STDIN   (with full crypt sources only; Unix, VMS only)
        Used to allow the password on encrypted files to be read from stdin
        rather than the default stderr.  This was useful for those who wished
        to automate the testing or decoding of encrypted archives (say, in a
        shell script via ``echo "password" | unzip -tq archive''), but as of
        version 5.3, UnZip has a -P option for passing a password directly to
        the program.  PASSWD_FROM_STDIN will therefore probably be phased out
        in future versions.  Note that the same security warnings given in the
        description of the -P option apply here as well.

      UNICODE_SUPPORT
        Enable restoring from UTF-8 encoded paths.  These paths are stored
        in extra fields in a backward-compatible way so that archives with
        UTF-8 paths still work on zips and unzips that don't support Unicode.
        This support follows the recent additions to the PKWare AppNote for
        Unicode support, except that Unicode comments on systems where UTF-8
        is not the current character set is not implemented in this release.

        Internally, Unicode support can be achieved by three methods:
        a) The charset encoding used by the system is already UTF-8, so
           the program just has to select the UTF-8 versions of the stored
           filenames for file name handling.
           This method is enabled by setting the symbol UTF8_MAYBE_NATIVE;
           this activates code to check for native UTF-8 encoding in the
           locale settings.
        b) The operating system and the compilation environment support
           "wide character" data in Unicode encoding (UCS-2/UTF-16 or UCS-4),
           which are used to translate between UTF-8 and the native
           extended-ASCII character encoding.
           The code for this method is activated by setting the preprocessor
           symbol UNICODE_WCHAR.
           It may be activated together with UTF8_MAYBE_NATIVE to provide
           more versatile Unicode support and additional "debugging" options
           for checking the correct recognition of non-ASCII Unicode
           characters.
        c) The operating system and the compilation environment allow to use
           unicode-encoded "wide character" data for native text strings
           support.
           Complete support for this method requires a throughout revision
           of the UnZip code. All internal string handling and text output
           needs to be ported to use wchar_t character storage.
           This porting is still in an experimental stage and not ready
           for general distribution.

        On some ports UNICODE_SUPPORT is set automatically:
        - WIN32 (and WinCE) use method b) by defining UNICODE_SUPPORT and
          UNICODE_WCHAR.
        - On Unix, the automatic configuration script enables UNICODE_WCHAR
          if ISO-10646 compatible wide characters are supported and
          UTF8_MAYBE_NATIVE if the locale detection call is available.
        For these ports, setting NO_UNICODE_SUPPORT forces deactivation of
        the Unicode support.

      NO_SETLOCALE (for Unix)
        On Unix, it is now assumed that <locale.h> and the setlocale function
        are available, to setup locale-aware filtering of displayed filenames.
        The option NO_SETLOCALE allows to disable the dependency on <locale.h>
        and setlocale() on systems where this assumption is invalid (and the
        auto-configuring make target "generic" cannot be used for capabilities
        detection).

      _MBCS
      NO_MBCS
       Enable multi-byte character set support.  This is the default for the
       Human68k system (originated from Japan) and for Win32 (here only DBCS
       "double-byte character set" support).  The MBCS support should also be
       enabled on systems which are capable of using UTF-8 as native charset.
       For MBCS support, the C runtime library must supply implementations
       for the mblen() function and the MB_CUR_MAX runtime macro/function.
       The NO_MBCS symbol allows to explicitely disable MBCS support for
       testing purpose, or when MBCS support does not work as expected.

      HAVE_WORKING_ISPRINT
      NO_WORKING_ISPRINT
        The symbol HAVE_WORKING_ISPRINT enables enhanced non-printable chars
        filtering for filenames in the fnfilter() function.  On some systems
        (Unix, VMS, some Win32 compilers), this setting is enabled by default.
        In cases where isprint() flags printable extended characters as
        unprintable, defining NO_WORKING_ISPRINT allows to disable the enhanced
        filtering capability in fnfilter().  (The ASCII control codes 0x01 to
        0x1f are always escaped on ASCII systems.)

      DEBUG
        Used for debugging purposes; enables Trace() statements.  Generally
        it's best to compile only one or two modules this way.

      DEBUG_TIME
        Used for debugging the timezone code in fileio.c; enables TTrace()
        statements.  This code is only used for the freshen/update options
        (-f and -u), and non-Unix compilers often get it wrong.


(4) If you regularly compile new versions of UnZip and always want the same
    non-standard option(s), you may wish to add it (them) to the LOCAL_UNZIP
    environment variable (assuming it's supported in your makefile).  Under
    MS-DOS, for example, add this to AUTOEXEC.BAT: