home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 090.lha / WCat / DCat.DOC < prev    next >
Encoding:
Text File  |  1986-11-20  |  2.5 KB  |  65 lines
  1. /*       program "DCat"
  2.   by Walt Lounsbery, 4-6-87
  3.  
  4. Usage: DCat [a] [f]
  5.  
  6.   Option "a" produces abbreviated format listings.  Option "f" makes
  7.   the program use a "Don't Care" file to filter out unwanted file
  8.   listings.
  9.  
  10.   This program scans disks in drive DF1 and creates a file RAM:DF1files
  11.   which contains a listing of files on the disk.  This listing is in
  12.   a format suitable for reading by SuperBase.  It has the following fields:
  13.  
  14.       File name
  15.       Path name
  16.       Disk name
  17.       File ID   (sum of first 900 bytes in the file)
  18.       File size (bytes)
  19.       File comment
  20.       File date
  21.       File access (including archive bit)
  22.       File icon flag
  23.  
  24.   Ordinary ".info" files for directories are not in the listing.  The file
  25.   listing is alphabetically sorted by path and file name.  If a file has
  26.   an icon in the same directory, the  flag is set to 'Y', otherwise it is
  27.   'N'.  If an icon file does not have an associated file, it is flagged
  28.   with an 'I'.
  29.  
  30.   The format of the file listing was changed to make an abbreviated format
  31.   fairly compatible.  The abbreviated format is:
  32.  
  33.      File name
  34.      Path name
  35.      Disk name
  36.      File ID
  37.      File size
  38.  
  39.   This eliminates the file comment, file date, file access, and icon flag
  40.   to save  space.  This is also the format used for the "don't care" files
  41.   listing input to this routine.
  42.  
  43.   This program uses a listing of "don't care" file names in order to
  44.   prevent catalogueing of common files or files that are of no importance
  45.   in the catalogueing.  Examples are the "more" program used to scan the
  46.   file documentation in the CUGW library, which appears on every disk.
  47.   Another example would be all the common files on the Workbench disk,
  48.   which appear on some of the distribution disks (contents of the "c"
  49.   directory, fonts, printer devices, libraries, etc).
  50.  
  51.   The Don't Care List must be altered to indicate whether a file path is
  52.   important.  This is accomplished by hand editing the file this program
  53.   produces.  If a file must appear in the root directory, the path is ":".
  54.   If a file can appear anywhere, the path is null.  If a file must appear in
  55.   a certain directory (the case for Workbench-type files), the path is
  56.   specified appropriately.  The Don't Care List is called "DCL.dcat"
  57.   and is expected in the same directory as dcat itself.  Please note
  58.   that the file ID code and size are also checked to match the DCL.dcat.
  59.   If the "DCL.dcat" cannot be found, no filtering is performed.
  60.  
  61. WARNING: This program requires more than 4000 bytes in the stack, a good
  62. figure is 10000.
  63.  
  64. */
  65.