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 <+>
UnMark <->
Toggle
Toggle All <*>
Begin Block
End Block


To move the selection bar around the list of files, use
the cursor, the mouse, or the following keys:

Up one line
Down one line
Up one full screen
Down one full screen
To top of list
To bottom of list

Additional functions are:

Display Help screens
ZIP marked files into ZIPFILE
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