4ZIP/4UNZIP USER'S GUIDE VERSION 1.04 JUNE 1990 _______ ____|__ | (tm) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Iram J. Weinstein XD SYSTEMS 1014 SHIPMAN LANE MCLEAN, VA 22101 CONTENTS Limited Warranty 1 Background 2 4ZIP Usage 2 4UNZIP Usage 3 Regarding Registration 4 4ZIP/4UNZIP Version History 5 4EDIT 6 Software Registration Form and Order 7 LIMITED WARRANTY XD Systems warrants the physical diskette enclosed herein to be free of defects in materials and workmanship for a period of 60 days from the date of purchase. In the event of notification within the warranty period of defects in material or workmanship, XD Systems will replace the defective diskette. XD Systems specifically disclaims all other warranties, express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose. In no event shall XD Systems be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages arising out of the use, the result of use, or inability to use this product. This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message via easyplex to ASP Ombudsman 70007,3536 4DOS is a trademark of J.P. Software. PKZip and PKUnzip are trademarks of PKWare. 4ZIP/4UNZIP and all the files and document- ation distributed with it are copyright 1990 by Iram J. Weinstein. All rights reserved. 1 4ZIP/4UNZIP User's Guide Version 1.03 Copyright (C) 1990 I. J. Weinstein A.BACKGROUND 4DOS provides a way of attaching descriptions to files on your disk that is apparently seamless. The descriptions appear on directory displays and automatically are copied when you COPY or MOVE a file to another disk or directory. But this seamless property fails as soon as you use other programs on your files. For example, if you archive the files with the PKware programs PKZIP or PKUNZIP, the descriptions stay behind. 4ZIP and 4UNZIP address this problem, providing an automatic method to store descriptions in ZIPFiles and to restore them when you extract a file. You must have copies of the PKware utilities located on the DOS Path, or in the current directory. These shareware programs are not supplied with 4ZIP/4UNZIP. You can obtain them from many Shareware distributors, BBS's or from PKware directly at: PKware Inc. 7545 North Port Washington Road Glendale, WI 53217 XD Systems is not affiliated with PKware in any way. B. 4ZIP USAGE 4ZIP Usage is: 4ZIP ZIPFILE [/am?] [d:][path][filespec] [+filespec] [+..] A directory display similar to that of SELECT will appear showing all of the files meeting any of the filespecs. This use of include lists is identical to the 4DOS 3.0 DIR and SELECT usage. Note that only the first argument in an include list can have a pathname; subsequent arguments default to the same path. You can mark files to be ZIPped into ZipFile in several ways, similar to the 4DOS SELECT command, as follows: <+> MARK file <-> UNMARK file Toggle MARK <*> MARK all files 2 To move the selection bar around the list of files, use the following keys: Move up one line Move down one line Move up one full screen Move down one full screen Move to top of list Move to end of list When you are finished marking files, then: ZIP marked files into ZIPFILE Quit 4ZIP without doing anything 4ZIP also has two options, which can be used singly or together, e.g., /a /m, or /am. /a ZIP all files matching filespecs without query. 4ZIP Junk /a C:\SOURCE\*.Pas + *MATH*.INC would ZIP into JUNK.ZIP all files from the C:\SOURCE directory that either had the extension PAS or the extension INC and MATH anywhere in the filename. /m Move selected files from source directory to the ZIPFile. This works by deleting the files from the source directory after ZIPping. C. 4UNZIP USAGE 4UNZIP Usage is: 4UNZIP ZIPFILE [/adm?] [outpath] [d:][path][filespec] [+filespec] [+..] The display is identical to the 4ZIP display, showing all the files in the ZipFile that meet any of the filespecs. Marking of the files to be extracted and cursor movement around the screen is identical to 4ZIP. 4UNZIP has three options. The first two are similar to the ones provided for 4ZIP. /a UNZIP all files matching filespecs without query. /m Move selected files from the ZIPFile to the outpath directory (Current directory is default). /d Delete selected files from the ZIPFile without extracting. This provides a convenient tool for ZipFile management, allowing you to select files to be removed using any 3 combination of filespecs with wild cards and the SELECT screen. The combination /ad will delete all the specified files without presenting the SELECT screen. The combination /md is interpreted the same as /m alone. Outpath, if supplied, determines the directory in which the extracted files are to be placed. So for example 4UNZIP C:\SOURCE\JUNK A:\ /am *.doc would extract all of the files with extension doc from the file C:\SOURCE\JUNK.ZIP and place them in the root directory of the A: drive. Then it would delete all of these files from JUNK.ZIP. C. REGARDING REGISTRATION 4ZIP/4UNZIP is ShareWare. The law requires that if you use this program, you must register and obtain a license for it. The registration fee is $15. A registration form is included at the end of this manual. Registered users will be notified of upgrades to 4ZIP/4UNZIP as they are released, and will receive the latest version of the program. Online help is available through CompuServe, by EasyPlex. Help is also available by mail. I will try to answer all letters within 48 hours. Non-registered users must include a SASE for a reply. The degree of help available to non-registered users is purely discretionary. Registrations and inquiries should be sent to: Iram J. Weinstein XD Systems 1014 Shipman Lane McLean, VA 22101 Voice (703) 821-3215 CIS 70741,3711 Commercial use of 4ZIP/4UNZIP without payment of the reg- istration fee is prohibited. Site licenses are available for users with multiple machines. Please contact me for information. The program and its associated documentation are the copyrighted property of the author. Non-commercial users are granted the right to use copy and share 4ZIP/4UNZIP with the following conditions: 4 Shareware distributors and Users Groups may charge a nominal fee for copying and distributing this program and Bulletin Board Systems may likewise carry it. Any distribution of 4ZIP/4UNZIP must include without alteration only the files listed: 4ZIP.EXE, 4UNZIP.EXE and 4ZIP.TXT, unchanged. Permission is also given for electronic distribution of archived versions of these files on electronic bulletin boards. D. 4ZIP/4UNZIP VERSION HISTORY Ver 0.90 (Beta Test) 12/01/89 This is the original release. It used batch files to drive 4ZIP and 4UNZIP and could only run under 4DOS. Ver 0.91 (Beta Test) 12/20/89 4ZIP and 4UNZIP now stand alone, and can be run under DOS. 4UNZIP accesses the ZipFile Directory itself without using PKZIP -v. This is much faster. Ver 0.92 (Beta Test) 1/21/90 Improved exception handling for DOS errors. Added /d and /m options to 4UNZIP Allow specification of destination path for the extracted files in 4UNZIP Ver 0.93 (Beta Test) 2/04/90 1. Changed mark/unmark in 4ZIP and 4UNZIP to be more like the latest SELECT. Space bar toggles mark and * marks all. 2. 4ZIP lost descriptions on some files in big directories. Now fixed. 3. Ver 0.92 of 4ZIP tried to correct command line parser so that C: ==> C:*.* and ABC ==> ABC\*.* if ABC is a directory but ABC.* otherwise. Got it right this time! Version 1.0 3/11/90 First public release Version 1.01 3/21/90 1. Corrected error (shame on me) in 4UNZIP that included  marker in filename. 2. Corrected 4UNZIP error when destination path is not source path. 3. Minor changes in documentation. Version 1.02 3/23/90 1. Corrected error in 4ZIP and 4UNZIP - not properly recognizing include lists. Version 1.03 4/01/90 Changed file access to run on networks reliably. Added name and serial number on registered copies. Version 1.04 6/10/90 Modified to correct for 4DOS 3.0 quirk. Entries in DESCRIPT.ION are sometimes delimited by LF instead of CRLF. Earlier versions of 4ZIP/4UNZIP misread these lines. Corrected 4ZIP/4UNZIP to properly access ZIPfiles smaller than 150 bytes. 5 E. 4EDIT Also take a look at 4EDIT, a full-screen editor for dir- ectory comments (or, in 4DOS terms, Descriptions). I think you will find it very useful. Its good practice to comment your files, and often its handy to see the descriptions attached to other files, while you are writing a new one. The 4EDIT package is shareware, available on Bulletin Boards and from shareware distributors. Registration is $15. See the order form at the end of this manual. 6 SOFTWARE REGISTRATION FORM AND ORDER Check all that apply: [ ] 4ZIP/4UNZIP registration _____ @ $15.00 [ ] 4EDIT registration _____ @ $15.00 TOTAL ENCLOSED: $______ If you already have copies of the programs you are ordering , where were they obtained? [ ]CompuServe [ ]Friend [ ]Employer [ ]BBS ______________________ [ ]ShareWare Distributor ________________________________________ Payment is by check[ ] or money order[ ] (Sorry - no COD or charges) NAME ___________________________________________ COMPANY ___________________________________________ ADDRESS ___________________________________________ CITY ___________________________________________ STATE __________________________ZIP _____________ Send your registration form and payment to: XD Systems 1014 Shipman Lane McLean, VA 22101 7