home *** CD-ROM | disk | FTP | other *** search
/ PC Open 7 / pcopen7.iso / MSDOS / Av702 / AV.DOC next >
Encoding:
Text File  |  1997-01-30  |  10.3 KB  |  232 lines
  1. AV.DOC                              1                         Revised: 01-30-97
  2.  
  3. The AV.EXE program shows a directory of one or more archive  files  (ZIP,  ZOO,
  4. etc), including some self-extracting files.  Features of this program:
  5.  
  6.   * The directory information is presented in full-screen mode and you can  use
  7.     PgUp and PgDn to scroll about the screens.
  8.   * Allows you to sort the display of the members in a number of ways.
  9.   * Allows you to reset the file date of the archive to match the date  of  the
  10.     most recent member of the archive.
  11.   * Provides the ability to filter out what members are displayed.
  12.   * Scroll through up to 500 archives.
  13.   * The date format shown is based on your country setting.
  14.   * Quick in-memory display for up to 50  archive  members;  bullet-proof  ISAM
  15.     support if it goes beyond that.
  16.  
  17.  
  18. A typical display might look (in part) like the following:
  19.  
  20. AV602.ZIP         Date      Time  OrigSize Method    NowSize  %reduce
  21. ------------  --------  -------- --------- -------- --------  -------[PgUp]
  22. AV.DOC        96/02/04  18:32:36      8585 Deflated     3395    61   [PgDn]
  23. AV.EXE        96/02/11  11:09:56    166744 Deflated   107879    36   [Home]
  24. BRUCE602.DOC  96/02/05  20:31:56     32493 Deflated    12566    62   [End]
  25. BRUCEINI.DOC  96/01/20  16:09:18      7649 Deflated     2891    63   [Up]
  26. FILE_ID.DIZ   96/01/28  12:26:36       214 Deflated      191    11   [Down]
  27.                                                                      [Sort]
  28.                                                                        [Name]
  29.                                                                        [Ext]
  30.                                                                        [Date]
  31.                                                                        [Size]
  32.                                                                        [CurSize
  33.                                                                        [Ratio]
  34.                                                                        [Path]
  35.                                                                        [Orig]
  36.                                                                        [-Flip]
  37.                                                                      [Filter]
  38.                                                                      [C-PgDn]
  39.                                                                      [C-PgUp]
  40.                                                                      [Quit]
  41.  
  42. ============  ========  ======== ========= ======== ========  =======[Help]
  43.  *5           96/02/11  11:09:56    215685            126922    42%  [Date]
  44. AV602.ZIP     96/02/11  11:10:16    127418                                  /ON
  45.  
  46.  
  47. Note that AV will not do much good for multi-disc ZIP files.
  48.  
  49. Since AV is based on a library of routines that is no longer  supported,  newer
  50. ZIP versions (including those generated by some Windows managers) will  not  be
  51. read properly by this command.
  52.  
  53.  
  54. AV.DOC                              2                         Revised: 01-30-97
  55.  
  56. When viewing a screen's worth of information, you can typically choose among  a
  57. number of options including the following:
  58.  
  59.         PgUp    view the previous screen's worth
  60.         PgDn    view the next screen's worth
  61.         Home    top line
  62.         End     bottom line
  63.         Up      move the screen up one line
  64.         Down    move the screen down one line
  65.         Sort    change the sort order for this and subsequent files;
  66.                 you're prompted for "BY?" and you should enter either
  67.                 "-x" or "x" or press Esc to get out of this: the archive
  68.                 is reread after you ask to re-sort it; x is one of:
  69.                         N = file name
  70.                         E = file extension
  71.                         S = file size of the original (non-compressed) file
  72.                         C = current (compressed) size of the file
  73.                         D = file date and time
  74.                         R = compression ratio
  75.                         P = path and file name order
  76.                         O = original order (no sorting)
  77.                 the "-" says to reverse the sort order (for example, biggest
  78.                 files first instead of last)
  79.         Filter  prompts you for a string; only member names that match that
  80.                 string are allowed through (does not accept wildcards; just say
  81.                 something like "COM" if you want all COM files)
  82.         Ctrl-PgDn go to the next archive file (if any)
  83.         Ctrl-PgUp go to the previous archive file (if any)
  84.         Quit    return to DOS (Ctrl-C also works) (with confirmation)
  85.         Date    update the archive file date to be the creation date of the
  86.                 most recent member in the archive; not offered if it's already
  87.                 the case
  88.         Del     delete the archive (with confirmation)
  89.         F1      help information
  90.  
  91. These options are presented on the right side of the screen and can be selected
  92. with the mouse cursor if one is available.
  93.  
  94.  
  95. Specifying parameters:
  96.  
  97. Parameters for this program can be set in the following ways.  The last setting
  98. encountered always wins:
  99.   - Read from an *.INI file (see BRUCEINI.DOC file),
  100.   - Through the use of an environmental variable (SET AV=whatever), or
  101.   - From the command line (see "Syntax" below)
  102.  
  103.  
  104.  
  105. AV.DOC                              3                         Revised: 01-30-97
  106.  
  107. Syntax:
  108.  
  109.     AV [ filespec ] [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /-MOUSE ]
  110.       [ /Tpath ] [ /Q ] [ /MONO ] [ /Iinitfile | /-I ] [ /? ] [ > filename ]
  111.  
  112. where:
  113.  
  114. "filespec" is the file specification to process.  Can include drive, path,  and
  115. wildcards if desired.  If no input filespec is provided, you'll be prompted for
  116. one.
  117.  
  118. "/P" (or "/PAUSE") says to view the directory in page mode.  This is  typically
  119. the default.  The default is automatically /-P (which can't be  overridden)  if
  120. redirection ("AV ...  > filename") is used.
  121.  
  122. "/-P" (or "/-PAUSE") says to  view  the  directory  not  in  page  mode.   This
  123. prevents you from being offered the fix-date option  as  well.   This  mode  is
  124. automatic if redirection ("AV ...  > filename") is used.
  125.  
  126. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x" can
  127. be one of the following:
  128.  
  129.         N = file name
  130.         E = file extension
  131.         D = file date and time
  132.         S = file size of the original (non-compressed) file
  133.         C = current (compressed) size of the file
  134.         R = compression ratio
  135.         P = path and file name order
  136.         O = original order (no sorting)
  137.  
  138. If you precede the "x" with a dash ("-"), the sort  will  be  done  in  reverse
  139. order.  Initially defaults to /OO.
  140.  
  141. "/DATE" resets the archive file date to be the date of the most recent  member.
  142. Automatically invokes /-P.  The command "AV *.* /DATE /Q" is  a  quick  way  to
  143. reset the file date stamps for all archives in your current subdirectory.
  144.  
  145. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  146.  
  147. "/-MOUSE" says to skip activating the mouse even if present.
  148.  
  149. "/Tpath" specifies where to write the temporary ISAM  files  that  the  routine
  150. needs.  ISAM data bases are used to store and sort the file names.  ISAM  files
  151. cannot be created reliably on certain types of drives.  Examples are "/TC:" and
  152. "/TC:\TEMP".  If  not  specified,  the  routine  writes  to  the  following  in
  153. sequence:
  154.  
  155.   - the value of any TEMP, then TMP, environmental variable
  156.   - C:\TEMP
  157.   - C:\
  158.  
  159. "/Q" skips the display of the member names.  Automatically  invokes  /DATE  and
  160. /-P and is typically used in cases where you want to reset all file dates  (for
  161. example, "AV *.* /Q").
  162.  
  163.  
  164. AV.DOC                              4                         Revised: 01-30-97
  165.  
  166. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  167. defaults to "/COLOR".
  168.  
  169. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  170. initially the default.
  171.  
  172. "/Iinitfile" says to read an initialization file with the file name "initfile".
  173. The file specification *must* contain a period.  Initfiles are described in the
  174. BRUCEINI.DOC file.  Initially defaults to "/IAV.INI".
  175.  
  176. "/-I" (or "/INULL") says to skip loading the initialization file.
  177.  
  178. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  179.  
  180. ">filename" redirects the output to a text file.   This  automatically  invokes
  181. the /-P option.  This is useful for getting a complete listing of the  contents
  182. of your compressed files.  For example:
  183.  
  184.         AV *.* > TEMP.TXT
  185.  
  186.  
  187. Return codes:
  188.  
  189. AV returns the following ERRORLEVEL codes:
  190.  
  191.         0 = no problems
  192.       252 = other problems
  193.       253 = no valid archives were found
  194.       254 = could not find a decent temporary output subdirectory
  195.       255 = syntax problems, file not found, or /? requested
  196.  
  197.  
  198.  
  199. AV.DOC                              5                         Revised: 01-30-97
  200.  
  201. Author:
  202.  
  203. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  204. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  205. program, no changes are made to the program or documentation,  and  it  is  not
  206. bundled with commercial programs or charged for separately.  People who need to
  207. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  208. Software" at the following address.
  209.  
  210. Additional information about this and other  Wayne  Software  programs  can  be
  211. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  212. The recent change history for this and the other programs is  provided  in  the
  213. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  214. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  215. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  216. naming the ZIP file (AVymm.ZIP) that this program was included in.
  217.  
  218. Comments and suggestions can also be sent to:
  219.  
  220.                 Bruce Guthrie
  221.                 Wayne Software
  222.                 113 Sheffield St.
  223.                 Silver Spring, MD 20910
  224.  
  225.                 fax: (301) 588-8986
  226.                 e-mail: bguthrie@nmaa.org
  227.                 http://www.geocities.com/SiliconValley/Lakes/2414
  228.  
  229. Please provide an Internet e-mail address on all correspondence.
  230.  
  231. 
  232.