home *** CD-ROM | disk | FTP | other *** search
- AV.DOC 1 Revised: 07-19-96
-
- The AV.EXE program shows a directory of one or more archive files (ZIP, ZOO,
- etc), including some self-extracting files. Features of this program:
-
- * The directory information is presented in full-screen mode and you can
- use PgUp and PgDn to scroll about the screens.
- * Allows you to sort the display of the members in a number of ways.
- * Allows you to reset the file date of the archive to match the date of
- the most recent member of the archive.
- * Provides the ability to filter out what members are displayed.
- * Scroll through up to 500 archives.
- * The date format shown is based on your country setting.
-
-
- A typical display might look (in part) like the following:
-
- AV602.ZIP Date Time OrigSize Method NowSize %reduce
- ------------ -------- -------- --------- -------- -------- -------[PgUp]
- AV.DOC 96/02/04 18:32:36 8585 Deflated 3395 61 [PgDn]
- AV.EXE 96/02/11 11:09:56 166744 Deflated 107879 36 [Home]
- BRUCE602.DOC 96/02/05 20:31:56 32493 Deflated 12566 62 [End]
- BRUCEINI.DOC 96/01/20 16:09:18 7649 Deflated 2891 63 [Up]
- FILE_ID.DIZ 96/01/28 12:26:36 214 Deflated 191 11 [Down]
- [Sort]
- [Name]
- [Ext]
- [Date]
- [Size]
- [CurSize]
- [Ratio]
- [Path]
- [Orig]
- [-Flip]
- [Filter]
- [C-PgDn]
- [C-PgUp]
- [Quit]
-
- ============ ======== ======== ========= ======== ======== =======[Help]
- *5 96/02/11 11:09:56 215685 126922 42% [Date]
- AV602.ZIP 96/02/11 11:10:16 127418 /ON
-
-
-
- AV.DOC 2 Revised: 07-19-96
-
- When viewing a screen's worth of information, you can typically choose among a
- number of options including the following:
-
- PgUp view the previous screen's worth
- PgDn view the next screen's worth
- Home top line
- End bottom line
- Up move the screen up one line
- Down move the screen down one line
- Sort change the sort order for this and subsequent files;
- you're prompted for "BY?" and you should enter either
- "-x" or "x" or press Esc to get out of this: the archive
- is reread after you ask to re-sort it; x is one of:
- N = file name
- E = file extension
- S = file size of the original (non-compressed) file
- C = current (compressed) size of the file
- D = file date and time
- R = compression ratio
- P = path and file name order
- O = original order (no sorting)
- the "-" says to reverse the sort order (e.g. biggest files
- first instead of last)
- Filter prompts you for a string; only member names that match that
- string are allowed through (does not accept wildcards; just say
- something like "COM" if you want all COM files)
- Ctrl-PgDn go to the next archive file (if any)
- Ctrl-PgUp go to the previous archive file (if any)
- Quit return to DOS (Ctrl-C also works) (with confirmation)
- Date update the archive file date to be the creation date of the
- most recent member in the archive; not offered if it's already
- the case
- Del delete the archive (with confirmation)
- F1 help information
-
- These options are presented on the right side of the screen and can be selected
- with the mouse cursor if one is available.
-
-
- Specifying parameters:
-
- Parameters for this program can be set in the following ways. The last setting
- encountered always wins:
- - Read from an *.INI file (see BRUCEINI.DOC file),
- - Through the use of an environmental variable (SET AV=whatever), or
- - From the command line (see "Syntax" below)
-
-
-
- AV.DOC 3 Revised: 07-19-96
-
- Syntax:
-
- AV [ filespec ] [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /-MOUSE ]
- [ /Tpath ] [ /Q ] [ /MONO ] [ /Iinitfile | /-I ] [ /? ] [ > filename ]
-
- where:
-
- "filespec" is the file specification to process. Can include drive, path, and
- wildcards if desired. If no input filespec is provided, you'll be prompted for
- one.
-
- "/P" says to view the directory in page mode. This is typically the default.
- The default is automatically /-P (which can't be overridden) if redirection ("AV
- ... > filename") is used.
-
- "/-P" says to view the directory not in page mode. This prevents you from being
- offered the fix-date option as well. This mode is automatic if redirection ("AV
- ... > filename") is used.
-
- "/Ox" and "/O-x" allow you to specify the display order for the files. "x" can
- be one of the following:
-
- N = file name
- E = file extension
- D = file date and time
- S = file size of the original (non-compressed) file
- C = current (compressed) size of the file
- R = compression ratio
- P = path and file name order
- O = original order (no sorting)
-
- If you precede the "x" with a dash ("-"), the sort will be done in reverse
- order. Initially defaults to /OO.
-
- "/DATE" resets the archive file date to be the date of the most recent member.
- Automatically invokes /-P. The command "AV *.* /DATE /Q" is a quick way to
- reset the file date stamps for all archives in your current subdirectory.
-
- "/MOUSE" says to activate the mouse if present. This is initially the default.
-
- "/-MOUSE" says to skip activating the mouse even if present.
-
- "/Tpath" specifies where to write the temporary ISAM files that the routine
- needs. ISAM data bases are used to store and sort the file names. ISAM files
- cannot be created reliably on certain types of drives. Examples are "/TC:" and
- "/TC:\TEMP". If not specified, the routine writes to the following in sequence:
-
- - the value of any TEMP, then TMP, environmental variable
- - C:\TEMP
- - C:\
-
- "/Q" skips the display of the member names. Automatically invokes /DATE and /-P
- and is typically used in cases where you want to reset all file dates (e.g. "AV
- *.* /Q").
-
-
- AV.DOC 4 Revised: 07-19-96
-
- "/MONO" (or "/-COLOR") does not try to override screen colors. Initially
- defaults to "/COLOR".
-
- "/COLOR" (or "/-MONO") allows screen colors to be overridden. This is initially
- the default.
-
- "/Iinitfile" says to read an initialization file with the file name "initfile".
- The file specification *must* contain a period. Initfiles are described in the
- BRUCEINI.DOC file. Initially defaults to "/IAV.INI".
-
- "/-I" (or "/INULL") says to skip loading the initialization file.
-
- "/?" or "/HELP" or "HELP" shows you the syntax for the command.
-
- ">filename" redirects the output to a text file. This automatically invokes the
- /-P option. This is useful for getting a complete listing of the contents of
- your compressed files. For example:
-
- AV *.* > TEMP.TXT
-
-
- Return codes:
-
- AV returns the following ERRORLEVEL codes:
-
- 0 = no problems
- 252 = other problems
- 253 = no valid archives were found
- 254 = could not find a decent temporary output subdirectory
- 255 = syntax problems, file not found, or /? requested
-
-
-
- AV.DOC 5 Revised: 07-19-96
-
- Author:
-
- This program was written by Bruce Guthrie of Wayne Software. It is free for use
- and redistribution provided relevant documentation is kept with the program, no
- changes are made to the program or documentation, and it is not bundled with
- commercial programs or charged for separately. People who need to bundle it in
- for-sale packages must pay a $50 registration fee to "Wayne Software" at the
- following address.
-
- Additional information about this and other Wayne Software programs can be found
- in the file BRUCEymm.DOC which should be included in the original ZIP file.
- ("ymm" is replaced by the last digit of the year and the two digit month of the
- release. BRUCE512.DOC came out in December 1995. This same naming convention
- is used in naming the ZIP file that this program was included in.) Comments and
- suggestions can also be sent to:
-
- Bruce Guthrie
- Wayne Software
- 113 Sheffield St.
- Silver Spring, MD 20910
-
- fax: (301) 588-8986
- e-mail: bguthrie@nmaa.org
- http://hjs.geol.uib.no/guthrie/
-
- See BRUCEymm.DOC file for revision history.
-
- Please provide an Internet e-mail address on all correspondence.
-
-