home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
-
-
-
-
- 4ZIP/4UNZIP USER'S GUIDE
-
- DECEMBER 1991
-
-
-
-
-
-
-
-
-
-
- _______
- ____|__ | (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 5
-
- Extended Descriptions 5
-
- Regarding Registration 6
-
- 4ZIP/4UNZIP Version History 7
-
- 4EDIT 8
-
- Software Registration Form and Order 9
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 545 Grover Road, Muskegon, MI 49442-9427 or send a
- Compuserve message via easyplex to ASP Ombudsman, 70007,3536. The
- ombudsman may also be contacted by FAX by sending to the ASP FAX
- number: (616) 788-2765. In communication with the Ombudsman, please
- include a telephone number and/or FAX if possible.
-
- 4DOS is a trademark of J.P. Software. PKZip and PKUnzip are
- trademarks of PKWare. 4ZIP, 4UNZIP and all the files and documentation
- distributed with them are copyright 1990,1991 by Iram J. Weinstein. All
- rights reserved.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -1-
-
-
-
-
- 4ZIP/4UNZIP User's Guide
-
- Copyright (C) 1990, 1991
- 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 should know that the DESCRIPT.ION file is a hidden file.
- You will not see it in the DOS directory unless you change the
- file attribute or use the 4DOS DIR /h option.
-
- 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 [Options] [d:][path][filespec] [filespec] [..]
-
- ***OPTIONS***
- /a ZIP all files matching filespecs without query
- /m Move selected files from source directory to the ZIPFILE
- /odeinsu Order by Date created Ext descrIption Name Size Unsorted
- {-bekoqs!3$} Pass these commands on to PKZIP
-
-
- 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 like the 4DOS DIR and SELECT usage. Filespecs can
- freely use the wildcard characters '*' and '?'. For example the
- filespecs c:\wp\*smith*.*; *. xyz would display all the files in the
- c:\wp directory that either have the letters smith in the name part
- or have xyz as the extension. Note that only the first argument in an
- include list can have a pathname; subsequent arguments default to the
-
- 2
-
-
- same path. Filespecs in an include list can be separated by ';',
- as in 4DOS, or, for convenience, '+' or ' '.
-
- You can mark files to be ZIPped into ZipFile in several
- ways, using the keyboard or mouse, similar to the 4DOS SELECT
- command, as follows:
-
- Mark <+> <INS>
- UnMark <-> <DEL>
- Toggle <SPACE> <Left Click>
- Toggle All <*> <CTRL ENTER>
- Begin Block <F7> <CTRL K B>
- End Block <F8> <CTRL K K>
-
-
- To move the selection bar around the list of files, use
- the cursor, the mouse, or the following keys:
-
- <UP> Up one line
- <DOWN> Down one line
- <PGUP> Up one full screen
- <PGDN> Down one full screen
- <HOME> To top of list
- <END> To bottom of list
-
- Additional functions are:
-
- <F1> Display Help screens
- <ENTER> ZIP marked files into ZIPFILE
- <ESC> <Right Click> Quit 4ZIP without doing anything
-
-
- 1.Options
-
- a. Sorting
- 4ZIP will allow you to control the order in which files are
- displayed and zipped. The syntax is:
-
- /o[deinsu] Order by Date created Ext descrIption Name Size Unsorted
-
-
- b.International Date and Time
- 4ZIP/4UNZIP now is consistent with your country=xxx
- command in config.sys. Commandline overrides for the time format
- are provided. They are:
-
- /24 Use 24 hour time
- /12 Use 12 hour time (e.g., 10:35p)
-
-
- 4ZIP has two options which can be used singly or
- together, e.g., /a /m, or /am.
-
-
-
-
-
- 3
-
-
- /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. PKZIP Command Options
- 4ZIP will accept the following subset of the PKZIP
- commands and will pass them on to PKZIP: 'b', 'e', 'k', 'o', 'q',
- 's','!','3','$'. You'll have to read the PKZIP documentation to
- learn the meaning of these options.
-
- To pass commands to PKZIP, just enclose them in curly
- brackets anywhere on the 4ZIP command line.
-
- For example:
-
- 4ZIP myfiles {-o -es -!} *.txt
- or
- 4ZIP myfiles {-o} *.txt { -es -!}
-
- would both pass the commands -o -es -! to PKZIP.
-
- Some of the other PKZIP commands (e.g., '@', or 'f') are
- not compatible with 4ZIP and would mess up the tracking between files
- and their descriptions. 4ZIP will ignore these options if you try to
- use them.
-
- IF you use a PKZIP configuration file, make sure that
- you do not try to pass commands that would not be acceptable
- on the 4ZIP command line, as unpredictable results will occur,
- mainly mismatching descriptions with the files.
-
-
- d. Help Key F1
-
- The help screens are displayed anytime F1 is pressed.
- Running 4ZIP with an error on the command line automatically
- invokes the help display.
-
-
-
-
-
-
-
-
-
-
-
- 4
-
-
- C. 4UNZIP USAGE
-
- 4UNZIP Usage is:
-
- 4UNZIP ZIPFILE [Options] [outpath] [d:][path][filespec] [..]
-
- The display is similar 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 several 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
- 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.
-
- 4UNZIP also accepts a subset of the PKUNZIP commands,
- using the same syntax as 4ZIP. The commands that 4UNZIP will
- recognize are: 'c', 'p', 'q', 's'.
-
-
- D. EXTENDED DESCRIPTIONS
-
- 4DOS 4.0 has capacity for descriptions up to 80 characters
- in length, and has a system for developers to extend the des-
- criptions to even greater lengths or to store other file-
- related information. However, the PKZIP comment format
- has room for only 59 characters. 4ZIP and 4UNZIP are designed to
- save and restore file descriptions up to the full length of 80
- characters, and will also capture and restore any extended
- description fields if present. This all happens automatically.
-
- How it's done -- The PKZIP directory structure allows for file
- descriptions of only 59 characters. If all the Zipped files have
- descriptions that will fit and there are no extended fields in their
-
- 5
-
- descript.ion entries, then the descriptions are stored in the PKZIP
- file directory, as in previous versions of 4ZIP. Otherwise, truncated
- descriptions are stored in the PKZIP directory, so they can be seen
- without 4UNZIP, and a special file with name 4ZIP_xxx.xxx (where the
- x'es are random letters) is added to the ZipFile, containing the full
- descript.ion entries. If the ZipFile is added to, more than one of
- these files may be present.
-
- You will see these files listed on the screen by PKZIP, but otherwise
- you should ignore them.
-
-
- E. 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:
-
- 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.
-
-
-
-
-
-
- 6
-
-
- F. 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
- 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.
-
- Version 1.05 7/15/90
- Corrected error that caused -a option of 4UNZIP to lose
- descriptions.
-
-
-
-
-
- 7
-
- Version 1.06 8/03/90
- Added Error Messages for Drive unready and Disk write-protected.
- 4ZIP JUNK a: is now equivalent to 4ZIP JUNK a:*.*
-
- Version 1.07 9/16/90
- 4UNZIP choked on the long ZipFile comments now being added by some
- BBS operators. Modified to correct this.
-
-
- Version 1.08 10/18/90
- 4UNZIP occasionally dropped file descriptions if the file had an 8 character
- name and a 3 character extension. This is corrected. A problem with include
- lists that caused the same file to be selected more than once has been
- corrected for both programs. For example, 4ZIP test *.txt+4*.txt would show
- the file 4zip.txt twice.
-
- Version 1.09 6/22/91
- 4ZIP would prevent PKZIP from updating an existing ZIPFile if the DOS SHARE
- program was loaded. This is corrected.
-
- Version 2.0 10/13/91
- This is an extensive revision, including Help key, mouse compatibility,
- Passthrough of PKZIP and PKUNZIP options, sorting of the display in
- 4ZIP, and International dates and time.
-
- Version 2.01 12/14/91
-
- Both 4ZIP and 4UNZIP set the display blinking attribute off and did not
- restore it. This is now fixed.
-
- 4UNZIP occasionally lost descriptions existing in a directory. Also fixed.
-
-
-
-
- G. 4EDIT
-
- In 1988, I wrote and distributed a shareware program, XDIR,
- which was one of the first DOS directory programs to attach a comment
- to each file. When I first saw 4DOS, I loved it, but I wanted to
- have the same sort of full-screen editor for directory comments (or,
- in 4DOS terms, Descriptions) that I had in XDIR.
-
- 4EDIT provides this feature. I think you will find it very
- useful. Its good practice to comment your files, and often it is
- 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, CompuServe, and from shareware distributors.
- Registration is $15. See the order form at the end of this manual.
-
-
-
-
-
-
- 8
-
-
- SOFTWARE REGISTRATION FORM AND ORDER
-
-
-
- Check all that apply:
-
- [ ] 4ZIP/4UNZIP registration _____ @ $15.00
-
- [ ] 4EDIT registration _____ @ $15.00
-
-
- Postage and Handling $3.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)
-
- Foreign Customers - Use $US check drawn on US Bank or Postal Money
- Order.
-
-
- NAME ___________________________________________
-
- COMPANY ___________________________________________
-
- ADDRESS ___________________________________________
-
- CITY ___________________________________________
-
- STATE __________________________ZIP _____________
-
-
- Send your registration form and payment to:
-
- XD Systems
- 1014 Shipman Lane
- McLean, VA 22101
-
-
-