home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / archiver / rv244.arj / RV.DOC < prev    next >
Text File  |  1992-05-07  |  9KB  |  221 lines
  1. RV-RView, Version 2.44                                  07-May-92
  2.  
  3.  
  4. Directory lister & utility for ARC ARJ LZH LZS PAK ZIP ZOO.  Rewritten and
  5. redesigned in a different language from 2.43 (not simply translated).  User-
  6. configurable to display either ZIP- or LZH-style compression ratios.
  7. Listings may be sorted by Name, Extension, Date, Original size, Packed size,
  8. compression Ratio, or left Unsorted.  New option to supress listings
  9. completely.  Also includes a possibly one-time, limited, scrollable version
  10. of RView.
  11.  
  12. Contents:
  13. =========
  14. Disclaimer
  15. Purpose
  16. Displayed data
  17. Syntax
  18. Switches
  19. Keyboard commands
  20. Configuration
  21.  
  22. Disclaimer:
  23. ===========
  24. RView and this documentation are offered as is.  The user bears the entire
  25. risk of this software not performing as expected.
  26.  
  27. Purpose:
  28. ========
  29. To provide a single, stand-alone program capable of listing directories of
  30. several archive formats.  Filename extensions are ignored in determining
  31. archive types.
  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. Displayed data:
  39. ===============
  40. Sample of output redirected to file:
  41.  
  42. --
  43.  
  44. RV-RView, Version 2.44, 07-May-92, rtk
  45.  
  46. LZH SFX (L): LHA213.EXE
  47.  
  48. Name         Original Method     Packed CR%   Date     Time   CRC      Attr Hdr
  49. ------------ -------- -------- -------- --- -------- -------- -------- ---- ---
  50. !                 843 -lh5-         481  57 91-08-02  2:13:04 FAFD     a--w 0
  51. LHA     .EXE    34283 -lh5-       24611  72 91-07-20  2:13:00 C77D     a--w 0
  52. LHA213  .DOC    31840 -lh5-       11550  36 91-08-02  2:13:24 C075     a--w 0
  53. HISTORY .ENG     9060 -lh5-        3144  35 91-08-02  2:13:12 C6D6     a--w 0
  54. LHA     .HLP     6752 -lh5-        2479  37 91-04-04  6:45:34 9B4B     a--w 0
  55. ------------ -------- -------- -------- --- -------- -------- -------- ---- ---
  56.        5        82778 LZH SFX     42265  51 91-08-02  2:13:24
  57.  
  58.    88064 bytes needed to extract to C:, enough disk space
  59.     1945 bytes in SFX header
  60.  
  61.        1 file searched
  62.        1 archive found
  63.  
  64. --
  65.  
  66. The type of archive is displayed before listing each archive.  For
  67. self-extracting archives, the letters "SFX" follow the name of the base
  68. archive type.  The program further distinguishes between small- and
  69. large-model LZH SFX archives and shows which ZIP SFX's are of the "Mini"
  70. (Junior) type.
  71.  
  72. For ZIP 2.0-type archives, the three different variations for "deflating"
  73. are reported as "Deflate", "DeflateX" and "DeflateF" for Normal, maXimal and
  74. Fast compression, respectively.
  75.  
  76. Compression ratios ("CR") computed by RView are of two types:
  77.  
  78.      ZIP-style (default):
  79.      --------------------
  80.      100 - ( PackedSize / OriginalSize * 100 )
  81.  
  82.      LZH style:
  83.      ----------
  84.      PackedSize / OriginalSize * 100
  85.  
  86. The date and time indicated on the "totals" line represent the date and time
  87. of the most recently created or modified member of each archive.  These are
  88. the values used by /R in resetting the archive date and time.
  89.  
  90. RView displays the total number of bytes required to contain the listed
  91. files if extracted to a selected drive.  If no drive is selected, the drive
  92. containing the archive being listed is used.  In making this computation,
  93. RView takes actual disk cluster sizes into account.
  94.  
  95. Syntax:
  96. =======
  97. Usage:  RV [switches] archive [d:] [file...]
  98.  
  99. Switches may appear in almost any position on the command line.  '-' may be
  100. substituted for '/' wherever DOS allows.
  101.  
  102. An archive name specified without an extension will result in a search for
  103. all extensions.  Thus typing "RV filename" is equivalent to "RV filename.*".
  104. Also, "RV *" is equivalent to "RV *.*".
  105.  
  106. An optional drive may be included immediately after the archive name to
  107. check for extraction sizes to the indicated drive.
  108.  
  109. Example:        RV backup.lzh a:
  110.  
  111. Result:         Causes RView to compute extraction sizes for drive A:.
  112.  
  113. File specifications following the archive name will limit the listing to
  114. only those files matching any of these specifications.
  115.  
  116. Example:        RV source.zip *.h *.c
  117.  
  118. Result:         Causes RView to list only C header and source files
  119.                 contained within SOURCE.ZIP.
  120.                 
  121. Switches:
  122. =========
  123. /A        Alternate compression ratio.  ZIP-style compression ratios are
  124.           displayed by default (see above).  Using this switch display
  125.           LZH-style ratios.  (Tip:  Include this switch in RV.CFG to always
  126.           display LZH-style ratios.)
  127.  
  128. /B        Brief filenames.  Use this switch to suppress the display of full
  129.           pathnames, i.e. only the filename.ext parts of full pathnames will
  130.           be shown.
  131.  
  132. /C[file]  strip/attach zip file Comment.  Strips file comments from ZIP
  133.           files.  If a valid filename immediately follows "/C" (no
  134.           intervening spaces), then comments contained in that file will be
  135.           attached to the specified ZIP file(s).
  136.  
  137. /D        sort lzh and zip files on Disk.  LZH and ZIP files are written
  138.           back to disk in the order implied by the /S family of switches.
  139.           Nothing is done for already-sorted archives.  Sorting to disk is
  140.           available so that LZH and ZIP files will be displayed in sorted
  141.           order by listers that don't do in-memory sorts.  Also,
  142.           disk-sorting is useful for LZH files when telops ('!' files) are
  143.           used.
  144.  
  145. /I        Ignore rv.cfg file.  This option was added by user request
  146.           to provide a means of overriding the defaults specified in
  147.           RV.CFG.
  148.  
  149. /P        Pause display after each screenful.  After pausing, pressing
  150.           almost any key causes another screenful to be displayed.
  151.  
  152. /Q        Quiet (suppress) listing.  Added by user request to speed file
  153.           processing by BBS SysOps.
  154.  
  155. /R        Reset date and time of archive.  The date and time used will be
  156.           those of the most recently created or modified file in each
  157.           archive.
  158.  
  159. /Sx[-]    Where 'x' represents N/E/D/O/P/R/U, as follows:
  160.  
  161.           SN - Sort by Name (default)
  162.           SE - Sort by Extension
  163.           SD - Sort by Date/time
  164.           SO - Sort by Original size
  165.           SP - Sort by Packed size
  166.           SR - Sort by compression Ratio
  167.           SU - leave Unsorted
  168.  
  169.           Appending a hyphen '-' to the above switches will reverse the
  170.           sense of the sort from ascending to descending.
  171.  
  172. /U[path]  Un-sfx self-extracting archive.  Converts self-extracting (SFX)
  173.           archives to normal archives.  A new file will be created with the
  174.           same name as the SFX file but with the appropriate extension
  175.           (".ARC", ".LZH", etc.).  The normal archive is written to the
  176.           current directory by default.  "/U" followed immediately by a
  177.           valid path (no intervening spaces) allows writing to the
  178.           specified target drive/directory.
  179.  
  180. /W        Wide display format.  Displays up to five names per line.
  181.  
  182. /X        strip eXtra bytes from end of archive.  XMODEM-type file transfer
  183.           protocols often pad transferred files with added bytes.  This will
  184.           truncate ARJ, LZH, LZS, PAK and ZIP archives to reflect their
  185.           "true" sizes.
  186.  
  187. Keyboard commands:
  188. ==================
  189. By user request, beginning with Version 2.34, the single-key,
  190. program-pausing feature has been added back.  While RView is displaying an
  191. archive, pressing <Esc> will terminate execution.  Almost any other key will
  192. pause the display.  After pausing, pressing <Esc> will terminate execution.
  193. Again, almost any other key will resume execution.
  194.  
  195. Configuration:
  196. ==============
  197. An optional configuration file containing user-selected default switches may
  198. be created or edited with any editor or word processor which can write pure
  199. ASCII text files.  This file should be named "RV.CFG" and placed in the same
  200. directory from which RV.EXE is loaded (DOS 3.0 and above).
  201.  
  202. Switches, including switch options, may either be separated by spaces or
  203. placed on separate lines.
  204.  
  205. Incompatible switches used on the command line will override switches
  206. included in RV.CFG.  Switches are evaluated from left to right on the
  207. command line.
  208.  
  209. A sample RV.CFG file is included in the distribution archive for RView.
  210. After extracting the contents of the distribution archive, RV.CFG may be
  211. deleted if RView's defaults are satisfactory.
  212.  
  213. --
  214.  
  215.                 Raymond T. Kaya
  216.                 P. O. Box 1436
  217.                 Honolulu, HI  96806
  218.  
  219.                 CompuServe:  71230,2500
  220.                 GEnie     :  R.KAYA1
  221.