home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / rv249.zip / RV.DOC < prev    next >
Text File  |  1993-03-10  |  8KB  |  206 lines
  1. RV-RView, Version 2.49                                  10-Mar-93
  2.  
  3.  
  4. Customizable archive lister & utility.  Currently supported are ARC, ARJ,
  5. LZH, LZS, PAK, ZIP & ZOO.  Displays ZIP- or LZH-style compression ratios.
  6. Various sort options.  Converts self-extracting archives back to normal.
  7. Misc. other features.
  8.  
  9. Contents:
  10. =========
  11. Disclaimer
  12. Purpose of program
  13. Display
  14. Command-line syntax
  15. Valid switches
  16. Configuration file
  17. Keyboard program-pausing
  18.  
  19. Disclaimer:
  20. ===========
  21. This program and the accompanying documentation are offered as is.  This
  22. program may be used to modify external files.  The user bears the entire
  23. risk of this software not performing as expected.
  24.  
  25. Purpose of program:
  26. ===================
  27. To provide a single, stand-alone program capable of listing directories of
  28. several archive formats.  Since filename extensions are ignored in
  29. determining archive types, this program may be used to determine the type of
  30. archive even if the filename extension is missing, or inappropriate.
  31.  
  32. This utility also contains various features not conveniently provided
  33. elsewhere at the time of their inclusion.
  34.  
  35. RView is a free program.
  36.  
  37. Display:
  38. ========
  39. The type of archive is shown before listing each archive.  For
  40. self-extracting archives, the letters "SFX" follow the name of the base
  41. archive type.  The program further distinguishes between small- and
  42. large-model LZH SFX archives and shows which ZIP SFX's are of the "Mini"
  43. (Junior) type.
  44.  
  45. For ZIP 2.0-type archives, the four different variations for "deflating" are
  46. reported as "Deflate", "DeflateX", "DeflateF" and "DeflateS" for normal,
  47. maXimal, Fast and Super-fast compressions, respectively.
  48.  
  49. The Compression Ratio Percentage ("CR%") displayed by the program is one of
  50. two types:
  51.  
  52.      ZIP-style (default):
  53.      --------------------
  54.      100 - ( PackedSize / OriginalSize * 100 )
  55.  
  56.      LZH-style:
  57.      ----------
  58.      PackedSize / OriginalSize * 100
  59.  
  60. Since ZIP-style is the default, use the /A switch to select LZH-style.
  61.  
  62. The date and time indicated on the "totals" line represent the date and time
  63. of the most recently created or modified member of each archive.  These are
  64. the values used by /R in resetting the archive date and time.
  65.  
  66. RView displays the total number of bytes required to contain the listed
  67. files if extracted to a selected drive.  If no drive is selected, the drive
  68. containing the archive being listed is used.  In making this computation,
  69. RView takes actual disk cluster sizes into account.
  70.  
  71. Command-line syntax:
  72. ====================
  73.  
  74.         Usage:  RV [switches] archive [d:] [file...]
  75.  
  76. Switches may appear in almost any position on the command line.  '-' may be
  77. substituted for '/' wherever DOS allows.
  78.  
  79. An archive name specified without an extension will result in a search for
  80. all extensions.  Thus typing "RV filename" is equivalent to "RV filename.*". 
  81. Also, "RV *" is equivalent to "RV *.*".
  82.  
  83. An optional drive may be included immediately after the archive name to
  84. check for extraction sizes to the indicated drive.
  85.  
  86. Example:        RV backup.lzh a:
  87.  
  88. Result:         Causes RView to compute extraction sizes for drive A:.
  89.  
  90. File specifications following the archive name will limit the listing to
  91. only those files matching any of these specifications.  The /U and /D
  92. switches will be ignored in this case.
  93.  
  94. Example:        RV source.zip *.h *.c
  95.  
  96. Result:         Causes RView to list only C header and source files
  97.                 contained within SOURCE.ZIP.
  98.                 
  99. Valid switches:
  100. ===============
  101. /A        Alternate compression ratio.  ZIP-style compression ratios are
  102.           displayed by default (see above).  Use this switch to display
  103.           LZH-style ratios.  (Tip:  Include this switch in RV.CFG to always
  104.           display LZH-style ratios.)
  105.  
  106. /B        Brief filenames.  Use this switch to suppress the display of full
  107.           pathnames, i.e. only the filename.ext parts of full pathnames will
  108.           be shown.
  109.  
  110. /C[file]  strip/attach zip file Comment.  Strips file comments from ZIP
  111.           files.  If a valid filename immediately follows "/C" (no
  112.           intervening spaces), then comments contained in that file will be
  113.           attached to the specified ZIP file(s).
  114.  
  115. /D        sort lzh and zip files on Disk.  LZH and ZIP files are written
  116.           back to disk in the order implied by the /S family of switches. 
  117.           Nothing is done for already-sorted archives.  Sorting to disk is
  118.           available so that LZH and ZIP files will be displayed in sorted
  119.           order by listers that don't do in-memory sorts.  Also,
  120.           disk-sorting is useful for LZH SFX's when telops ('!' files) are
  121.           used.
  122.  
  123. /E        remove extra spaces before the Extension in filenames.  By
  124.           default, the part of the filename before the extension is padded
  125.           with spaces if less than 8 characters.  Thus "NAME    .EXT"
  126.           becomes "NAME.EXT".
  127.  
  128. /I        Ignore rv.cfg file.  This option was added by user request to
  129.           provide a means of overriding the defaults specified in RV.CFG.
  130.  
  131. /P        Pause display after each screenful.  After pausing, pressing
  132.           almost any key causes another screenful to be displayed.
  133.  
  134. /Q        Quiet (suppress) listing.  Added by user request to speed file
  135.           processing by BBS SysOps.  Primarily intended for use in
  136.           conjunction with other switches which modify archives.
  137.  
  138. /R        Reset date and time of archive.  The date and time used will be
  139.           those of the most recently created or modified file in each
  140.           archive.
  141.  
  142. /Sx[-]    Where 'x' represents N/E/D/O/P/R/U, as follows:
  143.  
  144.           SN - Sort by Name (default)
  145.           SE - Sort by Extension
  146.           SD - Sort by Date/time
  147.           SO - Sort by Original size
  148.           SP - Sort by Packed size
  149.           SR - Sort by compression Ratio
  150.           SU - leave Unsorted
  151.  
  152.           Appending a hyphen '-' to the above switches will reverse the
  153.           sense of the sort from ascending to descending.
  154.  
  155. /U[path]  Un-sfx self-extracting archive.  Converts self-extracting (SFX)
  156.           archives to normal archives.  A new file will be created with the
  157.           same name as the SFX file but with the appropriate extension
  158.           (".ARC", ".LZH", etc.).  The normal archive is written to the
  159.           current directory by default.  "/U" followed immediately by a
  160.           valid path (no intervening spaces) allows writing to the specified
  161.           target drive/directory.
  162.  
  163. /V        enable Verbose mode.  Enables the display of comments and various
  164.           statistics related to the archive as a whole.  
  165.  
  166. /W        Wide display format.  Displays up to five names per line.
  167.  
  168. /X        strip eXtra bytes from end of archive.  XMODEM-type file transfer
  169.           protocols often pad transferred files with added bytes.  This will
  170.           truncate ARJ, LZH, LZS, PAK and ZIP archives to reflect their
  171.           "true" sizes.
  172.  
  173. Configuration file:
  174. ===================
  175. An optional configuration file containing user-selected default switches may
  176. be created or edited with any editor or word processor which can save pure
  177. ASCII text files.  This file should be named "RV.CFG" and placed in the same
  178. directory from which RV.EXE is loaded (DOS 3.0 and above).
  179.  
  180. Switches, including switch options, may either be separated by spaces or
  181. placed on separate lines.
  182.  
  183. Incompatible switches used on the command line will override switches
  184. included in RV.CFG.  Switches are evaluated from left to right on the
  185. command line.
  186.  
  187. A sample RV.CFG file is included in the distribution archive for RView. 
  188. After extracting the contents of the distribution archive, RV.CFG may be
  189. deleted if RView's defaults are satisfactory.
  190.  
  191. Keyboard program-pausing:
  192. =========================
  193. By user request, beginning with Version 2.34, the single-key,
  194. program-pausing feature has been added back.  While RView is displaying an
  195. archive, pressing <Esc> will terminate execution.  Almost any other key will
  196. pause the display.  After pausing, pressing <Esc> will terminate execution. 
  197. Again, almost any other key will resume execution.
  198.  
  199. --
  200.  
  201.                 Raymond T. Kaya
  202.                 P. O. Box 1436
  203.                 Honolulu, HI  96806
  204.  
  205.                 CompuServe:  71230,2500
  206.