home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware 1 2 the Maxx
/
sw_1.zip
/
sw_1
/
UTILS
/
RV244.ZIP
/
RV.DOC
< prev
next >
Wrap
Text File
|
1992-05-07
|
9KB
|
221 lines
RV-RView, Version 2.44 07-May-92
Directory lister & utility for ARC ARJ LZH LZS PAK ZIP ZOO. Rewritten and
redesigned in a different language from 2.43 (not simply translated). User-
configurable to display either ZIP- or LZH-style compression ratios.
Listings may be sorted by Name, Extension, Date, Original size, Packed size,
compression Ratio, or left Unsorted. New option to supress listings
completely. Also includes a possibly one-time, limited, scrollable version
of RView.
Contents:
=========
Disclaimer
Purpose
Displayed data
Syntax
Switches
Keyboard commands
Configuration
Disclaimer:
===========
RView and this documentation are offered as is. The user bears the entire
risk of this software not performing as expected.
Purpose:
========
To provide a single, stand-alone program capable of listing directories of
several archive formats. Filename extensions are ignored in determining
archive types.
This utility also contains various features not conveniently provided
elsewhere at the time of their inclusion.
RView is a free program.
Displayed data:
===============
Sample of output redirected to file:
--
RV-RView, Version 2.44, 07-May-92, rtk
LZH SFX (L): LHA213.EXE
Name Original Method Packed CR% Date Time CRC Attr Hdr
------------ -------- -------- -------- --- -------- -------- -------- ---- ---
! 843 -lh5- 481 57 91-08-02 2:13:04 FAFD a--w 0
LHA .EXE 34283 -lh5- 24611 72 91-07-20 2:13:00 C77D a--w 0
LHA213 .DOC 31840 -lh5- 11550 36 91-08-02 2:13:24 C075 a--w 0
HISTORY .ENG 9060 -lh5- 3144 35 91-08-02 2:13:12 C6D6 a--w 0
LHA .HLP 6752 -lh5- 2479 37 91-04-04 6:45:34 9B4B a--w 0
------------ -------- -------- -------- --- -------- -------- -------- ---- ---
5 82778 LZH SFX 42265 51 91-08-02 2:13:24
88064 bytes needed to extract to C:, enough disk space
1945 bytes in SFX header
1 file searched
1 archive found
--
The type of archive is displayed before listing each archive. For
self-extracting archives, the letters "SFX" follow the name of the base
archive type. The program further distinguishes between small- and
large-model LZH SFX archives and shows which ZIP SFX's are of the "Mini"
(Junior) type.
For ZIP 2.0-type archives, the three different variations for "deflating"
are reported as "Deflate", "DeflateX" and "DeflateF" for Normal, maXimal and
Fast compression, respectively.
Compression ratios ("CR") computed by RView are of two types:
ZIP-style (default):
--------------------
100 - ( PackedSize / OriginalSize * 100 )
LZH style:
----------
PackedSize / OriginalSize * 100
The date and time indicated on the "totals" line represent the date and time
of the most recently created or modified member of each archive. These are
the values used by /R in resetting the archive date and time.
RView displays the total number of bytes required to contain the listed
files if extracted to a selected drive. If no drive is selected, the drive
containing the archive being listed is used. In making this computation,
RView takes actual disk cluster sizes into account.
Syntax:
=======
Usage: RV [switches] archive [d:] [file...]
Switches may appear in almost any position on the command line. '-' may be
substituted for '/' wherever DOS allows.
An archive name specified without an extension will result in a search for
all extensions. Thus typing "RV filename" is equivalent to "RV filename.*".
Also, "RV *" is equivalent to "RV *.*".
An optional drive may be included immediately after the archive name to
check for extraction sizes to the indicated drive.
Example: RV backup.lzh a:
Result: Causes RView to compute extraction sizes for drive A:.
File specifications following the archive name will limit the listing to
only those files matching any of these specifications.
Example: RV source.zip *.h *.c
Result: Causes RView to list only C header and source files
contained within SOURCE.ZIP.
Switches:
=========
/A Alternate compression ratio. ZIP-style compression ratios are
displayed by default (see above). Using this switch display
LZH-style ratios. (Tip: Include this switch in RV.CFG to always
display LZH-style ratios.)
/B Brief filenames. Use this switch to suppress the display of full
pathnames, i.e. only the filename.ext parts of full pathnames will
be shown.
/C[file] strip/attach zip file Comment. Strips file comments from ZIP
files. If a valid filename immediately follows "/C" (no
intervening spaces), then comments contained in that file will be
attached to the specified ZIP file(s).
/D sort lzh and zip files on Disk. LZH and ZIP files are written
back to disk in the order implied by the /S family of switches.
Nothing is done for already-sorted archives. Sorting to disk is
available so that LZH and ZIP files will be displayed in sorted
order by listers that don't do in-memory sorts. Also,
disk-sorting is useful for LZH files when telops ('!' files) are
used.
/I Ignore rv.cfg file. This option was added by user request
to provide a means of overriding the defaults specified in
RV.CFG.
/P Pause display after each screenful. After pausing, pressing
almost any key causes another screenful to be displayed.
/Q Quiet (suppress) listing. Added by user request to speed file
processing by BBS SysOps.
/R Reset date and time of archive. The date and time used will be
those of the most recently created or modified file in each
archive.
/Sx[-] Where 'x' represents N/E/D/O/P/R/U, as follows:
SN - Sort by Name (default)
SE - Sort by Extension
SD - Sort by Date/time
SO - Sort by Original size
SP - Sort by Packed size
SR - Sort by compression Ratio
SU - leave Unsorted
Appending a hyphen '-' to the above switches will reverse the
sense of the sort from ascending to descending.
/U[path] Un-sfx self-extracting archive. Converts self-extracting (SFX)
archives to normal archives. A new file will be created with the
same name as the SFX file but with the appropriate extension
(".ARC", ".LZH", etc.). The normal archive is written to the
current directory by default. "/U" followed immediately by a
valid path (no intervening spaces) allows writing to the
specified target drive/directory.
/W Wide display format. Displays up to five names per line.
/X strip eXtra bytes from end of archive. XMODEM-type file transfer
protocols often pad transferred files with added bytes. This will
truncate ARJ, LZH, LZS, PAK and ZIP archives to reflect their
"true" sizes.
Keyboard commands:
==================
By user request, beginning with Version 2.34, the single-key,
program-pausing feature has been added back. While RView is displaying an
archive, pressing <Esc> will terminate execution. Almost any other key will
pause the display. After pausing, pressing <Esc> will terminate execution.
Again, almost any other key will resume execution.
Configuration:
==============
An optional configuration file containing user-selected default switches may
be created or edited with any editor or word processor which can write pure
ASCII text files. This file should be named "RV.CFG" and placed in the same
directory from which RV.EXE is loaded (DOS 3.0 and above).
Switches, including switch options, may either be separated by spaces or
placed on separate lines.
Incompatible switches used on the command line will override switches
included in RV.CFG. Switches are evaluated from left to right on the
command line.
A sample RV.CFG file is included in the distribution archive for RView.
After extracting the contents of the distribution archive, RV.CFG may be
deleted if RView's defaults are satisfactory.
--
Raymond T. Kaya
P. O. Box 1436
Honolulu, HI 96806
CompuServe: 71230,2500
GEnie : R.KAYA1