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