September 9, 1989


ZV - ZIP View 1.12 - ZIP file directory lister for viewing contents of ZIP
files, including self-extracting files. Multiple filespecs and wildcards
may be specified on the command line. DOS-compatible switches available
for Wide, Technical and Brief (filename without path) displays. Converts
ZIP SFX files to normal ZIP files. NEW OPTIONS: 1) strip ZIP file comments
and 2) strip extra bytes from end of ZIP files caused by file transfer
protocols.

Contents:
=========
Purpose
Commands
Other programs
Closing remarks

Purpose:
========
To provide a simple means of displaying the directory of a ZIP file. The
program attempts to determine if a specified file is in ZIP format and
displays an error message if the format is not recognized.

This is a free program. You may use it or give it away as you like.
Please include this DOC file if you do pass it along.

Commands:
=========
Usage: zv zipfile [zipfile...] [switches]

Switches: /W Wide display, up to five filenames per line
/T Technical information
/B Brief filenames, without path
/P Pause display when screen fills
/U Un-SFX self-extracting files
/C Strip ZIP file comment
/X Strip extra bytes from end of file
/A Strip all - SFX, ZIP comment and extra bytes

Switches may appear in any position on the command line.

Examples: zv /t backup.exe /p *.zip
zv/w bigfile.zip
zv /b/t/p recurse.dir
zv *.* /w/p
zv /w/u self.exe

In the command format above, 'zipfile' may optionally include a drive
and/or path designation. A 'zipfile' specified without an extension will
result in a search for all extensions.

Use the /W switch to list the names only of files included in a ZIP file.
Names are displayed up to five per line.

Use the /T switch to get detailed technical information about each file
contained in the ZIP file. This option will also display the number of
extra bytes appended to the end of a ZIP file.

Use the /B switch if the ZIP file being listed include pathnames and you
wish to just focus on the filenames. This option has no effect when used
with the /W switch, as the Wide option does not include pathnames by
default.

Use the /P switch to pause the display after each screenful of information.
After pausing, the program will prompt for a key press. Pressing at
this point will advance the display by one line. will terminate the
program. Any other key will display another screenful of output, with an
overlap of one line, provided there is enough output to fill another
screen.

As an alternative to the /P switch, pressing any key, except , while
the programming is displaying, will temporarily pause the display.
Pressing any key after pausing, except , will resume the display.
will terminate the program.

Use the /U switch to convert a self-extracting (SFX) ZIP file to a normal
ZIP file. This option has been added as a faster alternative to extracting
the contents from an SFX file and re-zipping them to form a regular ZIP
file. In some cases, it may not even be possible to reconstruct a ZIP file
as it was before it was converted to SFX form, without the proper tools. A
new file will be created with the same name as the SFX file but with the
.ZIP extension, provided a file with the same name doesn't already exist.
The reconstructed ZIP file will have the same date and time as the SFX
file.

Use the /C switch to strip ZIP file comments from a ZIP file. If there are
no comments, this switch has no effect. If a comment is found, this option
will also strip any extra bytes found at the end of the file.

Use the /X switch to strip 'eXtra' bytes from the end of a ZIP file, often
caused by XMODEM-type file transfer protocols. This will truncate the file
to reflect its "true" size.

Whereas the /U switch creates a new file by copying, both the /C and /X
switches actually modify the original ZIP file itself. As a security
measure, you may want to retain a backup copy of any file on which you wish
to use these switches, until you're sure that the resulting changes are
what you want.

Using the /A switch is equivalent to /U, /C and /X. It first strips any
extra bytes, then strips ZIP file comments. It then creates a new .ZIP
file that is stripped of all extra trappings.

At any time the program is displaying data, will end program
execution.

Typing just the program name by itself will display a simple help screen.

Other programs:
===============
Other programs which I have written and contributed to the public domain
include:

CAL100
------
CAL - Calendar V1.00 - 06/03/89 - A simple, pop-up calendar display program
that can be used as a sort of perpetual calendar. Valid years range from
0001 to 9999 (arbitrary). This program is NOT memory-resident. Scroll
through the different months and years. Although the executable file is
stand-alone, I don't consider this to be a complete program. I've
contemplated using the included routines as the starting point for a
scheduling program, for example. Source code included.

CRC-M2
------
CRC-M2 - Cyclic Redundancy Checker V1.00 - 07/12/89 - This tiny CRC program
accepts wildcards and multiple filespecs from the command line. Displays
same CRC values as PKPAK and LHarc. This type of program is usually
written in assembly language. In fact, I've adapted the algorithms from
some publicly available assembly language routines. Source code included.

DDEL124
-------
DIRDEL - Directory Delete, V1.24 - 07/15/89 - This program will delete
entire subdirectory trees - even those containing read-only, hidden and
system files and directories. It will even delete the current directory.
The executable file for this version is significantly smaller than before.
Source code included.

FIX301
------
FIX - File Fix, V3.01 - 09/03/89 - A binary editor which allows easy
editing of any file regardless of attributes. Searches available from
within a file: 1) text search, with wildcard support and 2) byte search,
which can find arbitrary sequences of bytes specified by the user,
including nulls, machine code and binary data. Also includes a scroll bar
indicating relative file position, file header support and 256-byte default
records.

FND106
------
FFIND - File Finder, V1.06 - 07/31/89 - This program will find any file or
subdirectory on your hard disk, including hidden and system files.
Wildcards are accepted. Improvements for this version include an overall
increase in speed and a smaller executable filesize. Source code included.

All the above programs were written entirely in JPI TopSpeed Modula-2.

Closing remarks:
================
You may send your suggestions and comments to me at the addresses below:


By conventional mail:
---------------------
Raymond T. Kaya
P. O. Box 1436
Honolulu, HI 96806


By electronic mail:
-------------------
CompuServe: 71230,2500
GEnie: R.KAYA1