home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 090.lha / WCat / README < prev    next >
Text File  |  1986-11-20  |  4KB  |  84 lines
  1.                    Walt Lounsbery's Disk Catalogue System
  2.  
  3.                    Version 1.0                 10-4-87
  4.  
  5. +++  This set of programs is copyrighted and is released for non-profit  +++
  6. +++  distribution only.  The author reserves all commercial rights to    +++
  7. +++  the programs.  DCat, DCare, DCSort, DComp, and DCDiff copyright     +++
  8. +++  1987 by Walter Lounsbery.  This notice and introduction text, plus  +++
  9. +++  the programs and their description files, must be distributed as is +++
  10. +++  without alteration, as a total group.                               +++
  11.  
  12.                               Walt Lounsbery
  13.                               Route 1, Box 115
  14.                               Viola, KS   67149
  15.                               (316) 545-7460
  16.  
  17.      This disk catalogue system was written to provide several unique
  18. features.  First, it produces file listings that can be read into Superbase
  19. databases for sophisticated processing.  Second, an editable "Don't Care"
  20. file allows for excellent filtering of common files from the file listings.
  21. Third, a checksum or file ID is generated on each file, so it can be
  22. identified seperately from its file name.  Fourth, one of the utilities
  23. provided uses the file ID and a file catalogue to determine if duplicate
  24. files are present on an arbitrary disk.  Another utility provides this
  25. capability, comparing two different catalogue lists.
  26.  
  27.      At present the various components of the system are embodied in five
  28. programs that must be invoked from the CLI.  As time allows, these will
  29. be combined into a Workbench compatible utility using Intuition features.
  30. This program will add regular database and report functions, as well as
  31. some new practical features.
  32.  
  33.      The four programs are:
  34.  
  35.           DCat   - Builds a listing of files (in RAM:) of disks inserted
  36.                    in drive DF1.  This uses the file filters and supports
  37.                    a full and an abbreviated listing.
  38.  
  39.           DCare  - Builds a listing of files (in RAM:) of disks inserted in
  40.                    drive DF1.  This is intended to build a listing of files
  41.                    to filter from the index or catalogue.
  42.  
  43.           DCSort - Sorts the "Don't Care" file and eliminates duplicate
  44.                    file entries.
  45.  
  46.           DComp  - Reads a file catalogue and the "Don't Care" filter file
  47.                    and compares disks in DF1: against this database.  Prints
  48.                    out matches and non-matches.
  49.  
  50.           DCDiff - Reads a catalogue file and another catalogue file or file
  51.                    listing and prints out matches between the files.  Option
  52.                    to print the non-matching files.
  53.  
  54.      Usage of the system is straightforward, and fairly quick (considering
  55. the checksum IDs that are generated, the filtering, and the sorting and
  56. indexing DComp does).  Pick out disks that have the majority of common
  57. files that you want included in the "Don't Care" file filter.  Run DCare
  58. to build the DCL.dcat file and edit that for the proper file paths.  Run
  59. DCSort on the resulting file to eliminate duplicates and sort the files.
  60. Don't worry about the disk volume names as they will be ignored (you can
  61. use the search and replace function of your editor to null out the disk
  62. volume names to compress the file).
  63.  
  64.      Run DCat with the final DCL.dcat to generate the index listing of
  65. your library.  Remember, the lists are kept in RAM, so you may not be able
  66. to obtain the full file attributes in the catalogue on small-memory Amigas,
  67. or to catalogue large libraries.  It is possible to catalogue in several
  68. sessions and merely "Join" the listings together.  I have found that each
  69. disk generates about 1k bytes of listing in the abbreviated listing mode,
  70. on average.  This should allow nearly 300 disks to be catalogued on a 512k
  71. byte memory Amiga.
  72.  
  73.      Once your library is indexed, DComp can be used to determine if new
  74. disks contain files already in your library.  This program currently uses
  75. the printer and the screen whether you like it or not.  If you are comparing
  76. your library to another, or to a group of contributed disks, it is easier
  77. to use DCDiff to find matches and non-matches between index files.  This
  78. also uses the printer unconditionally.  These programs run extremely fast,
  79. and have encouraged me to abandon Superbase for comparison of libraries and
  80. disks.
  81.  
  82.      For further details, consult the documents on each program and
  83. examine the sample DCL.dcat file.
  84.