_______________________________________________________________________________   This is the Windows CE Info-ZIP port README, last updated 10 February 2001._______________________________________________________________________________   Copyright and Disclaimer_______________________________________________________________________________Copyright     All the source files for Pocket UnZip are copyrighted by Info-ZIP.     For details on terms and conditions look into the LICENSE file     that should be part of the source distribution.     The original author Steve P. Miller has gracefully allowed to     put his own source contributions for "Pocket UnZip" under the     Info-ZIP license.Disclaimer     All project files are provided "as is" with no guarantee of     their correctness.  The authors are not liable for any outcome     that is the result of using this source.  The source for Pocket     UnZip has been placed in the public domain to help provide an     understanding of its implementation.  You are hereby granted     full permission to use this source in any way you wish, except     to alter Pocket UnZip itself.  For comments, suggestions, and     bug reports, please write to stevemil@pobox.com or to the     generic Info-ZIP e-mail address Zip-Bugs@lists.wku.edu._______________________________________________________________________________   About the Windows CE Port (known as "Pocket UnZip")_______________________________________________________________________________The Windows CE port, known as Pocket UnZip, is designed to run on Microsoft'sWindows CE operating system.  The port is completely contained in the fileslisted above.  There were very few minor modifications made to the Info-ZIPcode in order for this port to work.  This was possible because the Info-ZIPcode is fairly generic and also because several hooks have already been placedin the code from past Windows ports.  The Windows CE port leverages off ofthese efforts for two reasons.  Mainly, I wanted to avoid modifying theInfo-ZIP core code since people don't like it when your changes break otherports.  Second, this makes the Windows CE port easy to upgrade when fixes andfeatures are released by the Info-ZIP group.The port is made up of the project file (punzip.dsp), one global header(punzip.h), three main source modules (winmain.cpp/h, intrface.cpp/h,and wince.cpp/h), the resource script files (punzip.rc, punzip.rcv, andresource.h), several resources (punzip.ic2, zipfile.ic2, imglist.2bp,ilmask.bmp, toolbar.2bp, punzip.ico, zipfile.ico, imglist.bmp, andtoolbar.bmp), and the help file (punzip.htp).The application's entry point is WinMain(), which is located in winmain.cpp(what a surprise).  winmain.cpp basically contains all the Windows code andthe user interface.  It knows nothing about the Info-ZIP code or things likethe Globals struct.  That stuff is the job of the intrface module.intrface.cpp implements an easy (or at least easier) to understand interfaceto the Info-ZIP routines.  It also handles all the callbacks from Info-ZIPand relays the appropriate information back to the code in winmain.cpp.The final module is wince.cpp.  This module implements all the Win32 APIsand C runtime functions that are called by the rest of the code, but arenot natively implemented on Windows CE.  Most all of this module is excludedfor NT native builds.Two preprocessor defines are used in conjunction with several defines fromthe Info-ZIP code and from other ports.  The two that are specific to theWindows CE port are:     POCKET_UNZIP   Always set for the Windows CE port (CE and NT).     _WIN32_WCE     Set for Windows CE native; not set for Windows NT native.These three defines are the minimum defines that must be addressed by theproject file in order to build this port.  This port's main header, punzip.h,gets included by all the Info-ZIP source files when POCKET_UNZIP is defined.punzip.h in turn ensures that all the other relevant Info-ZIP defines are setto correctly build the port.  If you wish to alter the Info-ZIP defines usedto build this port, you can do so by altering punzip.h.There are quite a few _WIN32_WCE checks throughout the source files for thisport.  These checks allow the application to build natively for Windows NT fordebugging purposes, and just because it can with little effort due to thesimilarities between the Windows CE API and the Windows NT API. Any non-WindowsCE code is assumed to be for Windows NT only.  This project currently will notwork on Windows 95 because Windows CE is mostly UNICODE, and this port assumesthat all Win32 calls to the operating system take UNICODE parameters.  I couldscatter a few dozen "#ifdef UNICODE" checks around and make it work on Windows95, but I see no reason to complicate this port's code for that reason sincethere is already a Windows 95 port of the Info-ZIP code._______________________________________________________________________________   Building the Windows CE Port (known as "Pocket UnZip")_______________________________________________________________________________At the time this README was written, Microsoft just released Visual C++ forWindows CE version 1.0.  This development kit uses the the standard MicrosoftVisual C++ version 5.0 or 6.0 development environment and project files(DSP files). To build Windows CE binaries of Pocket UnZip, you will needversion 1.0 or later of Visual C++ for Windows CE.This port's project file, punzip.dsp, contains the information for building allthe various binaries.  These include Windows NT native, Windows CE native forHitachi SH-3 processors, and Windows CE native for MIPS processors.  Allprojects have Debug and Retail flavors as well.  The following table lists theWindows CE devices and which binary they run:     Manufacturer             CPU             Binary     ---------------------    ------------    ------     Philips Electronics      MIPS R3910      MIPS     NEC Corp.                NEC VR4101      MIPS     Casio Computer Co.       Hitachi SH-3    SH-3     Compaq Computer Corp.    Hitachi SH-3    SH-3     Hewlett-Packard Co.      Hitachi SH-3    SH-3     Hitachi Ltd.             Hitachi SH-3    SH-3     LG Electronics Inc.      Hitachi SH-3    SH-3Pocket UnZip should build out of the box.  If you have just unzipped theInfo-ZIP's UnZip sources, you should have a root directory with the coreInfo-ZIP files in it and several subdirectories under it for the variousports, one of which is the WinCE directory.  The project files punzip.dspare located in the subdirectory vc5 resp. vc6 below the wince directory.Open the punzip.dsp file from the subdirectory matching your Visual C++base version.  The project file uses all the files in the WinCEsubdirectory as well as the following files in the Info-ZIP root:     api.c        crypt.h      globals.c    process.c    unzip.h     consts.h     ebcdic.h     globals.h    ttyio.c      unzpriv.h     crc32.c      explode.c    inflate.c    ttyio.h      unzvers.h     crctab.c     extract.c    inflate.h    unreduce.c   zip.h     crypt.c      fileio.c     list.c       unshrink.c_______________________________________________________________________________   Contacting the Authors_______________________________________________________________________________The Info-ZIP group is made up of dozens of people, past and present, whohave devoted countless hours to providing the public with free and portablecompression software.  The author of the Windows CE port, Pocket UnZip, isSteve P. Miller.If you have questions, comments, suggestions, or bug reports concerning PocketUnZip itself, you can write Steve Miller at:     stevemil@pobox.comIf you find a bug that appears to be more Info-ZIP related (i.e. the actualdecompression part of Pocket UnZip), you can send mail to:     Zip-Bugs@lists.wku.eduFor all other general discussion type questions or comments, you can send mailto (as well as join) the following mailing list:     Info-Zip@lists.wku.eduSee the main UnZip README file for info on how to join the latter list.