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