/*       program "DCat"
  by Walt Lounsbery, 4-6-87

Usage: DCat [a] [f]

  Option "a" produces abbreviated format listings.  Option "f" makes
  the program use a "Don't Care" file to filter out unwanted file
  listings.

  This program scans disks in drive DF1 and creates a file RAM:DF1files
  which contains a listing of files on the disk.  This listing is in
  a format suitable for reading by SuperBase.  It has the following fields:

      File name
      Path name
      Disk name
      File ID   (sum of first 900 bytes in the file)
      File size (bytes)
      File comment
      File date
      File access (including archive bit)
      File icon flag

  Ordinary ".info" files for directories are not in the listing.  The file
  listing is alphabetically sorted by path and file name.  If a file has
  an icon in the same directory, the  flag is set to 'Y', otherwise it is
  'N'.  If an icon file does not have an associated file, it is flagged
  with an 'I'.

  The format of the file listing was changed to make an abbreviated format
  fairly compatible.  The abbreviated format is:

     File name
     Path name
     Disk name
     File ID
     File size

  This eliminates the file comment, file date, file access, and icon flag
  to save  space.  This is also the format used for the "don't care" files
  listing input to this routine.

  This program uses a listing of "don't care" file names in order to
  prevent catalogueing of common files or files that are of no importance
  in the catalogueing.  Examples are the "more" program used to scan the
  file documentation in the CUGW library, which appears on every disk.
  Another example would be all the common files on the Workbench disk,
  which appear on some of the distribution disks (contents of the "c"
  directory, fonts, printer devices, libraries, etc).

  The Don't Care List must be altered to indicate whether a file path is
  important.  This is accomplished by hand editing the file this program
  produces.  If a file must appear in the root directory, the path is ":".
  If a file can appear anywhere, the path is null.  If a file must appear in
  a certain directory (the case for Workbench-type files), the path is
  specified appropriately.  The Don't Care List is called "DCL.dcat"
  and is expected in the same directory as dcat itself.  Please note
  that the file ID code and size are also checked to match the DCL.dcat.
  If the "DCL.dcat" cannot be found, no filtering is performed.

WARNING: This program requires more than 4000 bytes in the stack, a good
figure is 10000.

*/