home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
WA
/
WA815.ZIP
/
PMZIP.ZIP
/
PMZIP.TXT
< prev
next >
Wrap
Text File
|
1991-01-14
|
33KB
|
1,403 lines
INTRODUCTION
PMZIP(TM) Manual
Version 1.0
Copyright (c) 1991 Nico Mak
All Rights Reserved
PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It
features:
o An SAA/CUA compatible interface for quickly adding, deleting,
extracting, and viewing files in a ZIP file
o Extensive online hypertext help (press F1 at any time)
o A sortable scrollable multi-selection list box with the names,
sizes, and date/time stamps of files in a ZIP file
o Push buttons for most commonly used actions
o A file search facility to locate selected ZIP files anywhere on a
disk
o Easy installation
o Support for the File Manager's drag and drop interface in OS/2
version 1.20 and later.
o All options (including screen size and position) can be saved and
restored
PMZIP is distributed as Shareware. This means that users are
encouraged, subject to restrictions described in the License Agreement,
to share copies of this program with friends, associates and bulletin
boards. Please remember that if you use this software you are required
to pay the registration fee of $29 as described in the License
Agreement.
The documentation in this file is available as context sensitive help
while running PMZIP. Just press F1 at any time. Hypertext links make
it easy to navigate the online information, so give it a try!
CONTENTS
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
PMZIP Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Copyright/License/Warranty . . . . . . . . . . . . . . . . . . . . . 5
Support and questions . . . . . . . . . . . . . . . . . . . . . . . 7
Quick start information . . . . . . . . . . . . . . . . . . . . . . 8
Drag and Drop interface . . . . . . . . . . . . . . . . . . . . . . 9
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Program locations . . . . . . . . . . . . . . . . . . . . . . . . 12
Opening ZIP files . . . . . . . . . . . . . . . . . . . . . . . . 13
Adding files to a ZIP file . . . . . . . . . . . . . . . . . . . . 14
Deleting files from a ZIP file . . . . . . . . . . . . . . . . . . 15
Extracting files from a ZIP file . . . . . . . . . . . . . . . . . 16
Viewing files in a ZIP file . . . . . . . . . . . . . . . . . . . 17
File Search Facility . . . . . . . . . . . . . . . . . . . . . . . 18
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . 20
File Manager hints . . . . . . . . . . . . . . . . . . . . . . . . 21
Keyboard usage . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Future Enhancements . . . . . . . . . . . . . . . . . . . . . . . 23
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . INDEX-1
page 3
PMZIP OVERVIEW
ZIP files contain other files. Typically the files in a ZIP file are
compressed. ZIP files make it easy to group files and makes
transporting and copying these files faster.
PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It
provides an easy-to-use SAA/CUA compatible interface for quickly adding,
deleting, extracting, and viewing members of a ZIP file. The program is
easy to install, and extensive online help is always available.
The main PMZIP window includes a list of files in the open ZIP file.
This list can be scrolled and sorted by name, extension, date, or size.
Files can be added, deleted, extracted, or viewed using pull-down menu
entries and push buttons.
Other features include a built-in file search facility that makes it
easy to locate ZIP files anywhere on your disk, support for the File
Manager's drag and drop interface to conveniently add files to a ZIP
file, and the ability to save and restore all options, including screen
size and position.
PMZIP supports the CUA "object-action process sequence" philosophy. This
allows you to select objects (files you want to add to a ZIP or files
already in a ZIP) and then specify the action you want to perform.
Alternately, you can use PMZIP in a more traditional "action-object"
style of interaction.
The most common ways to start the program are:
o To open an existing ZIP file from the File Manager, double click on
the ZIP file.
o To add files to an existing ZIP file, use the technique described in
the section titled Drag and Drop Interface. Briefly, select one or
more files in the File Manager, hold down mouse button two, drag the
file(s) over a PMZIP window or icon, and release the mouse button.
NOTE: you should drop files over a copy of PMZIP that is running,
not over an icon in a Desktop Manager Program Group window.
o To add files to a new ZIP file, use the procedure for adding files
to an existing ZIP file, but be sure to specify the name of a ZIP
file in the dialog box displayed when you "drop" files onto a
running copy of PMZIP.
page 4
You can also start PMZIP by double clicking on the PMZIP icon in the
"Group - Main" window. To start PMZIP from the OS/2 command line type
PMZIP, optionally specifying the name of a ZIP file as the first and
only parameter.
page 5
COPYRIGHT/LICENSE/WARRANTY
PMZIP(TM) Copyright (c) 1991 by Nico Mak - All rights reserved.
License Agreement and Warranty Disclaimer
You should carefully read the following terms and conditions before
using this software. Use of this software indicates your acceptance of
these terms and conditions. If you do not agree with them, do not use
the software.
Shareware Version
You are hereby licensed to: use the Shareware Version of the software
for a 21 day evaluation period; make as many copies of the Shareware
version of this software and documentation as you wish; give exact
copies of the original Shareware version to anyone; and distribute the
Shareware version of the software and documentation in its unmodified
form via electronic means. There is no charge for any of the above.
You are specifically prohibited from charging, or requesting donations,
for any such copies, however made; and from distributing the software
and/or documentation with other products (commercial or otherwise)
without prior written permission.
Unregistered use of PMZIP after the 21-day evaluation period is in
violation of federal copyright laws.
Evaluation and Registration
This is not free software. This license allows you to use this software
for evaluation purposes without charge for a period of 21 days. If you
use this software after the 21 day evaluation period a registration fee
of $29 (plus shipping and handling for orders outside USA) is required.
Payments must be in US dollars drawn on a US bank, and should be sent to
Nico Mak, P.O. Box 919, Bristol, CT 06010. Credit card ordering and
quantity discounts are available, as described in the file ORDER.DOC.
One registered copy of PMZIP may be dedicated to a single person who
uses the software on one or more computers or to a single workstation
used by multiple people.
You may access the registered version of PMZIP through a network,
provided that you have obtained individual license for the software
covering all workstations that will access the software through the
network.
page 6
Governing Law
This agreement shall be governed by the laws of the State of
Connecticut.
Disclaimer of Warrantee
This software and the accompanying files are sold "as is" and without
warranties as to performance of merchantability or any other warranties
whether expressed or implied. Because of the various hardware and
software environments into which this program may be put, no warranty of
fitness for a particular purpose is offered.
Good data processing procedure dictates that any program be thoroughly
tested with non-critical data before relying on it. The user must
assume the entire risk of using the program. Any liability of the
seller will be limited exclusively to product replacement or refund of
purchase price.
page 7
SUPPORT AND QUESTIONS
Technical support is available at no charge by sending electronic mail
to 70056,241 on CompuServe, to Nico Mak on BIX, or by sending US Mail to
Nico Mak, P.O. Box 919, Bristol, CT 06010. Registered users have
priority but I will try to answer all questions.
page 8
QUICK START INFORMATION
Many people that have used other Presentation Manager or Windows
applications will be able to use PMZIP without reading all the
documentation. However, the following sections should be reviewed before
running the program:
o Copyright/License Agreement/Warranty
o Installation
o Drag and Drop Interface
I also suggest you read the section titled Notes for miscellaneous
information about the interface philosophy and background, as well as
technical notes.
For more information about using the help facility, select Help for
help on the Help pull-down.
page 9
DRAG AND DROP INTERFACE
PMZIP supports the File Manager's "Drag and Drop" interface in OS/2
version 1.20 and later. This interface provides a convenient way to add,
freshen, or update files in a ZIP file with selected files listed by the
File Manager. To use the interface
1. select one or more files in the File Manager
2. hold down mouse button two
3. drag the file(s) over PMZIP window or icon
4. release mouse button two to drop the file(s)
NOTE: you should drop files over a copy of PMZIP that is running, not
over an icon in a Desktop Manager Program Group window.
When you drop one or more files on a PMZIP window, the "Drop" dialog box
is displayed. The dialog box lets you change the name of ZIP file
affected by the drop operation, either by typing the name of a ZIP file,
or by clicking on the Open or New buttons, which activate the standard
Open and New dialog boxes, respectively. This is a quick way to open a
different ZIP file without going through the File pull-down menu.
The Drop dialog box provides the following options:
o The Add, Freshen, and Update radio buttons correspond to the PKZIP
-a, -f, and -u options
o The "delete original after adding" check box corresponds to the
PKZIP -m option
o The Size and Speed radio buttons correspond to the PKZIP -ex and -es
options
o The "Recurse subdirectories" check box corresponds to the PKZIP -r
option
o The "Store recursed pathnames" check box corresponds to the PKZIP -p
option
o The "Store specified pathnames" check box corresponds to the PKZIP
-P option
page 10
INSTALLATION
System Requirements:
o OS/2 version 1.2 or later.
o The OS/2 versions of the PKWARE, Inc. PKZIP(TM) and PKUNZIP(TM)
programs. These can be obtained from most bulletin board systems or
ordered directly from PKWARE (phone 414-352-3670).
PMZIP-related files are:
o README.1ST this file
o ORDER.DOC order form
o PMZIP.EXE executable
o PMZIP.HLP documentation in online hypertext help format
o PMZIP.TXT documentation formatted printing
o PMZIP.DLL required dynamic link library
Installation:
There are two parts to the installation process. The first is performed
manually before running PMZIP. The second part is run from the Install
dialog. This dialog box is displayed the first time PMZIP is run, and
can be rerun from the Options pull-down menu.
One time installation procedure:
1) If you already have installed a previous version of PMZIP, delete all
files in your PMZIP directory. Otherwise create a directory to hold the
PMZIP related files. For example, "C:\PMZIP".
2) Copy all PMZIP-related files to this directory. At a minimum you
need the following files: PMZIP.EXE, PMZIP.HLP, and PMZIP.DLL. Note:
there is no need to include the directory containing PMZIP related files
in your LIBPATH= or HELP= paths.
3) Run PMZIP.EXE, either by double clicking on PMZIP.EXE in the File
Manager or by entering PMZIP at the the OS/2 system prompt. The first
time you run PMZIP it will bring up the Install dialog box to complete
the installation. If PMZIP cannot find PKZIP or PKUNZIP in your path,
it will prompt you for the program locations with the Program locations
dialog box.
Optional steps:
a) Add the directory created in step one to your PATH. If you don't add
page 11
the directory to your path, you'll need to type the directory name when
you start PMZIP from the command line (for example, you'll have to type
"C:\PMZIP\PMZIP" rather than just "PMZIP").
b) Add the statement PMZIP /ICON to your STARTUP.CMD file. This will
automatically start PMZIP as an icon whenever you boot OS/2, and
facilitates use of the File Manager's Drag and Drop Interface.
Install dialog box:
The Install dialog box will add a PMZIP entry to the first Program Group
in the Desktop Manager (usually "Group - Main"). It will also set a File
Manager association for *.ZIP files. This association lets you
double-click on any ZIP file listed in the File Manager to automatically
open the ZIP file with PMZIP.
page 12
PROGRAM LOCATIONS
The Program Locations dialog box is displayed during PMZIP
initialization if it can't find the OS/2 versions of the PKZIP or
PKUNZIP commands. If this dialog box is displayed, type the name of the
programs in the appropriate entry fields and click on the OK button.
Specify either a fully qualified pathname (e.g. C:\PKWARE\PKZIP.EXE),
or, if you want PMZIP to search your path, just the filename and
extension (e.g. PKZIP2.EXE).
Note: PKWARE distributes the OS/2 versions of their products with a "2"
or "F" file name suffix (e.g. PKZIP2). Since many users rename the
files to remove these suffixes, PMZIP automatically searches for all
three file name formats when it is first installed.
page 13
OPENING ZIP FILES
You can open ZIP files with the standard "New" or "Open" entries on the
File pull-down menu. These functions work like those of most other PM
applications, except that the Open dialog box features a File Search
Facility that will list all or selected ZIP files in your directory
tree.
Alternately, you can open a ZIP file while using the File Manager's
"Drag and Drop" interface to add files to a new or existing ZIP file, as
described in the section titled Drag and Drop Interface. If you change
the name of the ZIP file in the Drag and Drop dialog box, then PMZIP
will continue to work with the specified ZIP file until you again change
the name.
To save mouse clicks, PMZIP automatically brings up the Open dialog box
if no ZIP file is specified when the program is started. To disable this
behavior, click on the "Auto open dialog box" radio button in the
Configuration dialog box and save the default settings via the Defaults
dialog box.
You can close the current ZIP file with the "Close" entry on the File
pull-down menu. However, this menu entry is included primarily for
completeness, since the New, Open, and Drag and Drop dialog boxes all
automatically perform this action.
page 14
ADDING FILES TO A ZIP FILE
There are two ways to add files to a ZIP:
1) Object-action interface: use the File Managers "Drag and Drop"
interface, as described in the section titled Drag and Drop Interface.
2) Action-object interface: click on the "Add" push button or select
the "Add" entry from the "Action" pull-down menu to bring up the Add
dialog box. Then specify the file names you want to add (standard OS/2
wildcards are accepted).
The Add dialog box provides the following options:
o The Add, Freshen, and Update radio buttons correspond to the PKZIP
-a, -f, and -u options
o The "delete original after adding" check box corresponds to the
PKZIP -m option
o The Size and Speed radio buttons correspond to the PKZIP -ex and -es
options
o The "Recurse subdirectories" check box corresponds to the PKZIP -r
option
o The "Store recursed pathnames" check box
corresponds to the PKZIP -p option
o The "Store specified pathnames" check box corresponds to the PKZIP
-P option
page 15
DELETING FILES FROM A ZIP FILE
There are two ways to delete files from a ZIP:
1) Object-action interface: first select entries in the list box, then
click on the "Delete" push button or select the "Delete" entry from the
"Action" pull-down menu.
2) Action-object interface: click on the "Delete" push button or select
the "Delete" entry from the "Action" pull-down to bring up the "Delete"
dialog box. You can then specify the file names you want to delete
(standard OS/2 wildcards are accepted).
page 16
EXTRACTING FILES FROM A ZIP FILE
There are two ways to extract files from a ZIP:
1) Object-action interface: first select entries in the list box, then
click on the "Extract" push button or select the "Extract" entry from
the "Action" pull-down menu to bring up the Extract dialog box.
2) Action-object interface: click on the "Extract" push button or
select the "Extract" entry from the "Action" pull-down to bring up the
Extract dialog box. You can then specify the file names you want to
extract (standard OS/2 wildcards are accepted) or extract all files in
the ZIP.
The Extract dialog box lets you specify the directory to contain the
extracted files (note: the default directory for this prompt can be
changed by selecting "Extract Directory..." in the "Options" pull-down
menu).
The Extract dialog box provides the following options:
o The "Overlay newer files only" check box corresponds to the PKUNZIP
-n option
o The "Use pathnames" check box corresponds to the PKUNZIP -d option
Note: the PKUNZIP -o option is always specified.
page 17
VIEWING FILES IN A ZIP FILE
The View dialog box is used to view files in a ZIP file or view the
results of the last PKZIP or PKUNZIP command issued by PMZIP. Unlike
most dialog boxes, the View dialog box is sizeable and can be maximized.
There are three ways to view files in a ZIP file:
1) Double click on a file name in the list box listing files in the ZIP
file.
2) Object-action interface: first select entries in the list box, then
click on the View push button or select the "View" entry from the
"Action" pull-down menu.
3) Action-object interface: click on the "View" push button or select
the "View" entry from the "Action" pull-down to bring up the View dialog
box. You can then specify the file name you want to view.
Click on the Clipboard Copy push button to copy selected text to the
system clipboard. Note: this button is disabled when no text is
selected.
page 18
FILE SEARCH FACILITY
The File Search Facility is invoked by clicking on the Search button in
the Open dialog box. Type a file name (standard OS/2 wildcards are
accepted) in the Pattern entry field of the Search dialog box and click
on the Search button to search an entire disk for the specified file(s).
You can then select any file found by this procedure and click on the
Open button to open the ZIP file.
page 19
OPTIONS
The PMZIP option system consists of the following components:
The Option pull-down menu lets you specify whether the list of files in
the ZIP file is sorted by date, extension, size, name, or whether the
original ZIP file order should be used. It also lets you bring up the
following dialog boxes described below.
The Configuration dialog box lets you specify
o Whether the default directory in the Extract dialog box is the
current directory or a directory of your choice.
o Whether the Open dialog box is automatically displayed when no ZIP
file is specified when PMZIP is started.
o Whether files in the ZIP file are listed in lowercase for the
possibility of improved legibility.
o Whether PMZIP should maintain a log of all error messages and all
PKZIP and PKUNZIP commands it issues. The log is written to the file
C:\PMZIP.LOG.
o Whether PMZIP automatically changes the current directory when files
are dropped to the directory containing the files being dropped.
The Defaults dialog box lets you save the current defaults for use next
time PMZIP is started, or restore the original distribution defaults.
Options that are saved and restored by this procedure include all the
options in the "Options" pull-down menu, all options in the Add,
Configuration, Extract, and Program Locations dialog boxes, and the
current screen size. Note that this information is also saved if PMZIP
is running when you select "Save" from the "Desktop" pull-down in the
"Desktop Manager" window.
The Install dialog box will add a PMZIP entry to the first Program Group
in the Desktop Manager (usually "Group - Main"). It will also set a
File Manager association for *.ZIP files. This association lets you
double-click on any ZIP file listed in the File Manager to automatically
open the ZIP file with PMZIP.
The Program Locations dialog box lets you specify the file names used by
PMZIP instead of the default PKZIP.EXE and PKUNZIP.EXE.
The View last output entry in the Options pull-down displays the results
of the last PKZIP or PKUNZIP command issued by PMZIP.
page 20
ERROR HANDLING
When a PKZIP or PKUNZIP command issued by PMZIP returns a non-zero error
level, a dialog box is displayed listing the error level and error level
description. You can click on the "View command output" button to view
all messages issued by the command that caused the error.
PMZIP will optionally maintain a log of all error messages and all PKZIP
and PKUNZIP commands it issues. The log is written to the file
C:\PMZIP.LOG.
Note: When a critical error (e.g. an open drive door) occurs while the
PKZIP or PKUNZIP commands are running, you will get the standard OS/2
error screen. This is because the PKZIP and PKUNZIP commands were not
coded to handle these errors. PMZIP cannot control this behavior.
page 21
FILE MANAGER HINTS
The OS/2 File Manager isn't the most versatile file management program,
but it is the only one available for OS/2 with a Presentation Manager
interface. The best way to learn to use it is to experiment and read the
online help. Pull-down all the menus, and if you don't know what an
entry does, select it and press the F1 key for context sensitive help
(note: if you're using the mouse, be sure to press F1 while holding down
the mouse button).
Here are two hints for using the File Manager. Your suggestions for
additional hints are welcome.
1) By default the file manager does not list file sizes and modification
dates. You can change this by selecting "File details" from the "View"
pull-down menu. To automatically list files by date select "Sort by"
from the "View" menu and click on "Last modification date" in the "Sort
by" dialog box and check the "Set system default" button before closing
the dialog box.
2) To open directories in the File Manager's tree display, double click
on the name, not the icon. Clicking on the icon can expand or collapse
a branch of the tree, depending on whether there is a plus or minus sign
in the directory icon.
page 22
KEYBOARD USAGE
PMZIP is easier to use with a mouse, but you can also use the standard
PM keyboard interface. The Drag and Drop interface to the File Manager
is not available from the keyboard. Keyboard accelerators defined for
PMZIP include:
Ctrl+N Open new Zip file.
Ctrl+O Open existing ZIP file.
Ctrl+A Add files to a ZIP file.
Ctrl+D Delete files from a ZIP file.
Ctrl+E Extract files from a ZIP file.
Ctrl+V View files in a ZIP file.
page 23
FUTURE ENHANCEMENTS
Ideas for future enhancements include:
o Support for all ZIP options, including passwords and comments
o Ability to run programs in a ZIP file
o Support for other file formats (e.g. ARC)
o Optional hex dump mode when viewing files in a ZIP File
Additional suggestions are welcome!
page 24
NOTES
o This version of PMZIP was tested under OS/2 versions 1.20 and 1.30
with PKZIP and PKUNZIP versions 1.01.
o PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc.
o PMZIP does not manipulate ZIP files directly. Instead it runs PKZIP
and PKUNZIP for all operations.
o PMZIP displays an hour-glass pointer to indicate that it is busy
while the PKZIP and PKUNZIP commands are running. You can, of
course, switch to another OS/2 session during this time.
o PMZIP supports most commonly used PKZIP and PKUNZIP options but the
current version does not include special support for comments,
passwords, and file attribute masks.
o PMZIP will try to use the "System Monospaced" font (the file
SYSMONO.FON) first introduced in the November, 1989 update to OS/2
1.2. If this font is not found it will use the standard Courier
font. The Courier font is always used for the text in the View
dialog box because of a bug in some versions of OS/2 1.20.
o PMZIP sometimes passes a temporary "list file" to the PKWARE, Inc.
programs. PMZIP uses a unique filename for this file, and
automatically erases it when it is no longer needed. If you have a
TMP= environment variable, temporary files are created in the
specified directory. Otherwise they are created in the root
directory of your C: drive.
o Ideally PMZIP should use the same selection techniques as the File
Manager for manipulating files in a ZIP file. However, that
facility is not currently provided by the Presentation Manager, and
is quite time consuming to program from scratch. Since Windows 3.0
provides this facility as a "Extended Selection List Box", we can
hope it will be provided in the Presentation Manager in the near
future, in which case I expect to use it in PMZIP. Meanwhile, the
program uses the standard "Multiple Selection List Box", which,
while not the ideal solution, should be familiar and easy to use.
page 25
o PMZIP was written because I wanted a PM interface to ZIP files, and
no other programs provided this facility. The first version was
written in Digitalk's Smalltalk V/PM. The result, like all V/PM
programs, required over a megabyte of code to execute, and was
rather slow. Favorable response to the first version convinced me to
rewrite the program in C and release it as Shareware.
o Special thanks to Steve Queen for his feedback on the PMZIP user
interface.
INDEX
A L
Adding files to a ZIP file 14 License 5
C
Copyright 5
O
D Opening ZIP files 13
Options 19
Deleting files from a ZIP file Overview 3
15
Drag and Drop Interface 9
P
E PKZIP, PKUNZIP, PKWARE 24
Program locations 12
Error Handling 20
Extracting files from a ZIP
file 16 Q
Quick start information. 8
F
File Manager hints 21 S
File Search Facility 18
Future Enhancements 23 Search Facility 18
Support and questions 7
I
V
Installation 10
Introduction 1 Viewing files in a ZIP file
17
K
W
Keyboard usage 22
Warranty 5
WhereIs 18
Index-1