Unzip v1.1 (Archive: Funzip.zip) ================================ This is a freeware user-friendly front end for the unzip.img image file from David Palmer. The umzip.img file can be found on CompuServe in the Palmtop forum library 18 in different versions (see the Installation section below) I wrote this application as I could never remember the command line options I needed to unzip files. As David had kindly added full OPL launch support in version 1.41 of his unzip.img, I managed to knock up Unzip.opa in OPL in a couple of hours. Unzip can be used as a replacement for, or a supplement to David Palmer's run.app. Unzip is also a bit smaller than run.app. Compare the file sizes... File Size Time Date unzip.opa 2023 01:10 07-May-96 run.app 2208 01:10 25-Nov-95 What's New in This Version ========================== In Unzip v1.1 I have added support for the older versions (v1.0, v1.2 and v1.3) of the unzip.img files, as a lot of people still use these older versions because v1.41 removed support for archives zipped with PKZIP v1.1. Archive Contents ================ When you unzipped this file you should have found: File Size Time Date unzip.opa 2023 01:10 07-May-96 (application) unzip.txt 8131 01:10 07-May-96 (this text file) Installation ============ 1. Make sure you have the unzip.img file. Unzip.img is part of the complete unzip package from David Palmer, which is available as... Archive Version Size Time Date s3uzip14.zip v1.41 32960 01:41 25-Nov-95 s3uzip2.zip v1.3 33760 11:35 18-Apr-94 unzip.img v1.2 43376 ??:?? 21-Jun-94 s3uzip.zip v1.0 44144 23:24 03-Apr-93 ...in the Palmtop forum's library 18 on CompuServe. (Version/Size/Date/Time are for the unzip.img image file) You can also get unzip.img by anonymous ftp from ftp://sunsite.doc.ic.ac.uk/computing/systems/handhelds /psion/icdoc/utils/s3uzip14.zip 2. Copy unzip.opa into the *same* directory as unzip.img This is important: Unzip.opa will not work unless it is in the same directory and same drive as unzip.img. 3. Install the Unzip.opa application from the system screen by using Psion-I, pressing Tab, and navigating to the directory where Unzip is located. Note: all you need to unzip is unzip.img and unzip.opa. All other files in David Palmer's archive can be deleted from the Psion if you need to save precious memory space. Operation ========= Unzip contains a simple dialog for selecting the most useful unzip options. Not all options are included, as I believe not all are needed. If anyone needs any more, please contact me and I'll build them in. When you start Unzip (the same way as you would start any other application) you will see a dialog that will look like this... Unzip v1.1 using Unzip.img vX.XX [Esc] to exit Unzip from: Name <- file to unzip Disk Internal Unzip to dir: Name UNZIP\ <- it will unzip to this dir Disk Internal Options: Extract archives <- choose an option... Modifiers: None <- ...and a modifier... Overwrite existing files: Prompt <- ...and confirm overwrite The X.XX will show the version number of the unzip.img file that is present on your Psion 3a. Note that if you have a unzip.img version less than v1.40, then the "Unzip to dir:" option cannot be selected and all files will be unzipped to the root directory on your default disk. Press [Esc] from the dialog to exit Unzip. Unzip's Dialog ============== Unzip from ---------- Unzip looks for files with a .ZIP extension in the \CIS\LIBRARY directory on the internal disk. I chose this as I normally want to unzip files I download from CIS. If the \CIS\LIBRARY directory does not exist, then Unzip will try and show \CIS or otherwise just the root directory. You can press [Tab] to bring up the file selector to select any file you wish. Unzip to dir ------------ For unzip.img files of v1.40 or greater, Unzip will unzip to \UNZIP on the internal disk as default. If you have no \UNZIP, then it will unzip to the root directory. Press [Tab] for the file selector. For unzip.img files earlier than v1.40, Unzip will unzip to the root directory on your default disk. Options ------- Extract archives (default) This will extract all the files in the zipped archive. List archives (short form) This lists all the files in the zipped archive showing size and date. List archives (long form) This does the same as the short form list but displays a bit more information about each file. Display archive comment Does just that. Test archive integrity Test to see if the archived files are not corrupted and if they can be unzipped OK by Unzip. Freshen existing & create none This will unzip files only if the zipped files have a timestamp which is newer than the existing files. The existing file is overwritten. No new files are created. This is the best choice if you wish to update an existing program but you do *not* want to unzip files you have previously deleted. A good choice when unzipping directly to a flash SSD. NOTE: Unzip.img complains if you choose "Freshen existing & create none" with the overwrite option "Never" at the same time. Update existing & create new This will unzip files only if the zipped files have a timestamp which is newer than the existing files, and it will also create any new files if they do not exist. This is a good choice if you want to unzip all archive files (including new files) direct to a flash SSD - existing files that have *not* changed will *not* be replaced, thus saving precious flash SSD space. Modifiers --------- None No modifiers. Throw away paths If the archive contains paths, normally they are extracted and created when unzipping. Choosing this option will *prevent* the paths from being created, and all files will be unzipped to the same directory. Quiet operation Prevents most text from being displayed on the screen. Very quiet operation Even quieter than quiet operation. Overwrite existing files ------------------------ Prompt Unzip will ask you what to do if it finds an existing file. Never Unzip will *never* overwrite any existing files. NOTE: Unzip.img complains if you choose "Never" and "Freshen existing & create none" at the same time. Always Unzip will *always* overwrite existing files. Illegal Combinations ==================== Unzip.img will complain if you select a combination of "Options: Freshen existing & create none" AND "Overwrite existing files: Never" Unzip.img Compatibility ======================= I have tested Unzip.opa with versions 1.0, 1.2, 1.3 and 1.41 of Unzip.img, and these all work happily. Unzip.opa will automatically detect which version of unzip.img you have and allow/disallow options accordingly. If Unzip.opa fails to detect the version of unzip.img, then it will display version 0.00 in the dialog and disallow selection of the "Unzip to dir:" option. The unzipping should however still work OK, and the files will be unzipped to the root directory of the default drive. Acknowledgements ================ Full acknowledgements go to David Palmer of Edinburgh, Scotland, for his wonderful unzip.img and his excellent documentation. Change History ============== 7-May-96 v1.1 Added support for unzip.img v1.0/1.2/1.3. Renamed a couple of options and fixed a spelling mistake. Optimized code to make the .opa as small as possible. 1-May-96 v1.0 Original version (only for unzip.img v1.41) ------------------- Jochen Siegenthaler Zurich, Switzerland 07 May, 1996 100127.3167@compuserve.com