home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / arc_lbr / av20.arc / AV.DOC next >
Text File  |  1989-03-18  |  8KB  |  230 lines
  1. @CB
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                            Archive Directory Viewer v2.00
  18.                         Copyright (c) 1988-9 by Derron Simon
  19.  
  20.                                     Derron Simon
  21.                                    14 Valley Road
  22.                                 Glen Mills, PA 19342
  23.  
  24.                                CompuServe: 72571,1524
  25.                                    GEnie: D.SIMON
  26.  
  27.  
  28.  
  29.  
  30.  
  31.             DESCRIPTION
  32.  
  33.             AV shows the contents of archives generated with most
  34.             popular archive/library programs.  AV supports archives
  35.             created by ZOO (by Rahul Dhesi), PKPAK (by Phil Katz), ARC
  36.             (SEA), PAK (NoGate Consulting), LU (by Thom Henderson), SQ
  37.             (by a variety of authors), DWC (by Dean W. Cooper), and
  38.             PKZIP (another by Phil Katz).
  39.  
  40.             FEATURES
  41.  
  42.             AV has the following secondary features:
  43.                  - Ability to determine archive type by the file's
  44.                    extension.
  45.                  - Archive type can be specified on the command line for
  46.                    archives with non-default extensions.
  47.                  - AV supports wildcards and command line stringing.
  48.  
  49.             SYNOPSIS
  50.  
  51.             AV is used as follows:
  52.  
  53.                  av [-alqzdp] filename[.ext] ...
  54.  
  55.                  "[-alqzdp]" specifies the archive type if it cannot be
  56.                  determined by the archives extension.  All files on the
  57.                  command line are treated as the type specified.  The
  58.                  letters correspond to ARC/PAK/PKA, LBR, ?Q?, ZOO, DWC,
  59.                  and ZIP files respectively.
  60.  
  61.                  "filename[.ext]" is the filename of the archive to
  62.                  view.  If no extension and no archive type identifier
  63.                  are supplied, AV defaults to ".ARC", if no extension is
  64.                  given and a type is specified, AV uses the default
  65.                  extension for that archiver.  Filenames may contain
  66.                  wildcards and may be strung.  Note: there is no default
  67.                  extension for squeezed files.
  68.  
  69.             OUTPUT
  70.  
  71.             AV's standard output is in the form:
  72.  
  73.                  AV copyright notice
  74.  
  75.                  file1.ext
  76.                    contents
  77.  
  78.                  file2.ext
  79.                    contents
  80.  
  81.                  .
  82.                  .
  83.                  .
  84.             
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                  filen.ext
  91.                    contents
  92.  
  93.             The listing format is the same for DWC, ZOO, ARC, and ZIP
  94.             files.
  95.  
  96.  
  97.             AV uses the following terms when displaying files:
  98.  
  99.                  Filename - The name of the file in the archive.
  100.  
  101.                  Length - The length of the file before storing.
  102.  
  103.                  Method - The method used to store the file.  Different
  104.                       archive programs have different names for the same
  105.                       compression methods.  AV tries to use the name
  106.                       used by the archive program which created each
  107.                       archive.
  108.  
  109.                  SF - The storage factor achieved by the compression.
  110.  
  111.                  Size - The size of the compressed file.
  112.  
  113.                  Date - The date of the file before storing.
  114.  
  115.                  Time - The time of the file before storing.
  116.  
  117.                  CRC - Cyclic Redundancy Check on the file, taken before
  118.                       storing with squeezed (?q?) files and after with
  119.                       all others.  CRC-16 is used by all the programs
  120.                       except ZIP which uses CRC-32.
  121.  
  122.             COMPILATION INFORMATION
  123.  
  124.             AV was compiled with Microsoft C v5.1 and linked with
  125.             Microsoft LINK v3.65.  The editor used when writing AV was
  126.             EC by C Source and the debugger was CodeView by Microsoft.
  127.  
  128.             ACKNOWLEDGEMENTS
  129.  
  130.             The following references were used in the creation and later
  131.             versions of AV.
  132.  
  133.                  ARC.DOC by System Enhancements Associates (description
  134.                  of what the archive bits mean, from 5.32 docs).
  135.  
  136.                  TM0401.TXT by System Enhancements Associates
  137.                  (information on what's new in version 6.0 of ARC).
  138.  
  139.                  LUDEF5.DOC by Gary P. Novosielski (LBR header
  140.                  information).
  141.  
  142.                  LU.ARC by Thom Henderson (implementation of LBR header
  143.                  viewer and more widely used header format than
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                  LUDEF5.DOC).
  150.  
  151.                  ARCVIEW.ARC by Doug Boone (another similar utility with
  152.                  C source which shows ARC/PAK/DWC/ZOO files).
  153.  
  154.                  SQ.C86 by Richard Greenlaw (?Q? file header
  155.                  information).
  156.  
  157.                  DWC Prototype A2 by Dean W. Cooper (another archive
  158.                  utility which I found on GEnie with C source).
  159.  
  160.                  APPNOTE.TXT by Phil Katz (ZIP file header information).
  161.  
  162.                  ZIPVINC.ARC by Ken Brown (ZIP file viewer).
  163.  
  164.             TRADEMARKS
  165.  
  166.             ARC is a trademark of System Enhancements Associates.
  167.             Microsoft C, LINK, and CodeView are trademarks of Microsoft
  168.             Corporation.
  169.  
  170.             DISCLAIMER
  171.  
  172.             The author makes no claims to any responsibility whatsoever
  173.             for any damage this program causes or is involved in.  I
  174.             don't expect it will cause damage, but I can't guarantee it.
  175.  
  176.             VERSION INFORMATION
  177.  
  178.             Vers    Date    Description
  179.             ----  --------  --------------------------------------------
  180.             1.00  12/22/88  Read only single ARC files
  181.             1.01  12/22/88  Showed multiple files with wildcards
  182.             1.10  12/23/88  Added LBR support
  183.             1.11  12/27/88  Added SQ support
  184.             1.20* 12/27/88  Added support for ZOO files
  185.             1.21  12/29/88  Fixed ZOO CRC error
  186.             1.22  12/29/88  Fixed ZOO length<->size error
  187.             1.23  12/29/88  Made ARC CRC in caps and added 0-filling
  188.             1.24  12/29/88  Fixed options error-checking
  189.             1.30* 12/29/88  Added SF output
  190.             1.31  02/14/89  Fixed bug in extension checking
  191.             1.32  02/16/89  Fixed divide by zero bug on zero length
  192.                             files
  193.             1.40  02/16/89  Added DWC support
  194.             1.41  02/18/89  Fixed bugs created by versions 1.30 to 1.40
  195.             1.42* 02/19/89  Added size for SQ files
  196.             1.50  03/04/89  Added ZIP support
  197.             1.90  03/17/89  Cleaned up main code (smaller EXE)
  198.             1.91  03/18/89  Added subdir support for ARC v6.00 files
  199.             1.92  03/18/89  Fixed ..\filename.ext problem
  200.             2.00* 03/18/89  New Documentation and other small stuff
  201.  
  202.             * publicly released versions
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.             I am attempting to keep the number of versions of AV down to
  210.             a minimum, if you need something please get in touch with me
  211.             and I may be able to give a private version (my most recent,
  212.             which isn't necessarily the publics most recent.
  213.  
  214.             FUTURE DIRECTIONS
  215.  
  216.             The following are on my agenda:
  217.  
  218.                  - Change the user interface to something more intuitive
  219.                  - Add all new archive formats
  220.                  - Create a library of routines to get info from
  221.                    archives that is linkable to C (for BBS and utility
  222.                    writers).
  223.  
  224.             COPYRIGHT
  225.  
  226.             AV is copyrighted by Derron Simon.  It is not in the public
  227.             domain, but may be copied freely and distributed freely.  I
  228.             retain exclusive rights to the program except the right to
  229.             distribute and copy, which I retain but also extend to
  230.             everyone.