                               ZipDLL v1.2
                               -----------
                             Copyright 2002 
                              by Tim Kosse
                             tim.kosse@gmx.de

What is this?
-------------

  ZipDLL is a extension DLL for NSIS. It can unzip files from
  zip files. It is especially useful in combination with NSISdl so 
  that you don't have to download large files uncompressed.

Usage
-----

  If you're using Modern UI, include "ZipDLL.nsh" after including any language files.
  Then call one of the following macros:
  
   MUI_ZIPDLL_EXTRACTALL SOURCE DESTINATION
    Parameters: Zip file, destination directory
    Description: Extracts all files in the archive to the destination
                 directory.

   MUI_ZIPDLL_EXTRACTFILE SOURCE DESTINATION FILE
    Parameters: Zip file, destination directory, file to extract
    Description: Extracts the specified file in the archive to the destination
                 directory.

  On Success, the string "success" is on top of the stack, else an 
  error message.

  If using the macros, the status messages during extraction uses the current installer 
  language. (Only if ZipDLL supports that language. Default language is English)

  Example:
    !insertmacro MUI_ZIPDLL_EXTRACTALL "c:\test.zip" c:\output"

  If you're not using ModernUI, do the following:
  - Call a function from ZipDLL using ZipDLL::<function-name> 
    (using CallInstDLL is also possible but not recommended)
  - On Success, the string "success" is on top of the stack, else an 
    error message.
  
  Exported Functions:
  - extractall
    Parameters: Zip file, destination directory
    Description: Extracts all files in the archive to the destination
                 directory.

  - extractfile
    Parameters: Zip file, destination directory, file to extract
    Description: Extracts the specified file in the archive to the destination
                 directory.

  Example:
    ZipDLL::extractall "c:\test.zip" "c:\output"

Legal Stuff
-----------

  This NSIS plugin is licensed under the GPL, please read the file ZipArchive\glp.txt
  for details.
  
  ZipDLL uses the ZipArchive library from http://www.artpol-software.com/index_zip.html
  Please read the file ZipArchive\license.txt for details

  Alternative license for use with proprietary software:
  ------------------------------------------------------

  Since ZipArchive is licensed under the GPL, it may only be used with programs with a
  GPL compatible license, the same applies to this DLL.
  You can, however obtain a commercial license (free of charge for freeware and most 
  shareware programs) for ZipArchive. Please read ZipArchive\license.txt for details.
  Permission is granted to use ZipDLL together with prorietary software when you've
  obtained a license for ZipArchive.

Version History
---------------

1.2
---

- Added macros for automatic language selection
- Translation possible, works like /translate switch for NsisDL plugin

1.1
---

- made compatible with latest NSIS (parameters on stack swapped)
- cleaned up code

1.0
---

- initial release
   