home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / demo / tomcat06.lzh / TOMCAT06.DOC next >
Text File  |  1988-07-16  |  8KB  |  257 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                            TOMCAT
  9.                       Demo Version 0.6
  10.  
  11.                 Copyright  Roger Clare  1986
  12.  
  13.   Permission is hereby granted to copy and distribute this
  14.   Demo Version provided that no modifications are made and
  15.   that no charge is made, and that this documentation is
  16.   distributed with the program.
  17.  
  18.  
  19. INTRODUCTION
  20.  
  21.      TOMCAT is a disk cataloging program.  It has several
  22. good features, some of which are unusual and perhaps unique.
  23.  
  24.      Fast screens.
  25.  
  26.      Fast searches.
  27.  
  28.      Finds and catalogs files contained within ARC files.
  29.  
  30.      Catalog may be sorted by Volume or by File Name, and
  31.      all features work without re-sorting.
  32.  
  33.      Index of Volumes shows empty space on each disk, and
  34.      also the date when it was cataloged.
  35.  
  36.      This Demo Version is limited to a catalog of 120 volumes
  37. or 700 file entries, which may be sufficient for many users.
  38. The full version (Version 1.5) will handle as many entries
  39. as available memory will allow.
  40.  
  41.  
  42. |Version .4 changes
  43. |     Reading the catalog from disk into memory is now more
  44. |than twice as fast as previous versions.
  45.  
  46. |Version .5 changes
  47. |     When scanning file names of descriptions for a string, the scan
  48. |results may be scrolled up or down, the same as when browsing the
  49. |catalog.
  50. |     The list of volumes may be printed.
  51.  
  52. |Version .6 changes
  53. |     Bug fix for file delete on directory display not working unless
  54. |a full screen of files was being displayed.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. STARTING THE PROGRAM
  73.  
  74.      When you run TOMCAT.COM, it will look for a
  75. configuration file (TOMCAT.CFG) in the same directory.  If a
  76. configuration file is not found, TOMCAT will create one, and
  77. also an empty catalog file (TOMCAT.CAT).  If TOMCAT.CFG is
  78. present, TOMCAT will read it to determine the path and name
  79. of the catalog file.  TOMCAT will then read in the catalog
  80. file and display the main menu.
  81.  
  82.  
  83. MAIN MENU
  84.  
  85. The main menu shows TOMCAT's single-letter commands, grouped
  86. by related functions.
  87.  
  88. R) Read Catalog -
  89.      This command reads the catalog file indicated by the
  90. configuration table in memory.  If a catalog exists in
  91. memory, it will be overwritten and lost.
  92.  
  93. S) Save Catalog -
  94.      This command saves the catalog residing in memory by
  95. writing it to the catalog file indicated in the
  96. configuration table.  An existing catalog file of the same
  97. path/name will be overwritten.
  98.  
  99. I) Display Directory -
  100.      Displays the directory of the disk on the Input drive.
  101. The user can delete a file from the disk directory being
  102. displayed by hitting the 'D' key and then giving the name
  103. of the file.
  104. While displaying the directory, you can delete a file by
  105. using the 'D' option on this sub-menu.  TOMCAT will ask
  106. for the name of the file to delete, and will ask for
  107. confirmation before deleting.
  108.  
  109. L) Label Disk -
  110.      Writes a volume label on the disk on the Input drive.
  111.  
  112. U) Update Catalog -
  113.      Reads the directory of the disk on the Input drive, and
  114. adds or changes catalog entries.  If the disk is already in
  115. the catalog, existing entries will be updated for size and
  116. date, new entries will be added, and entries in the catalog
  117. no longer on the disk will be deleted from the catalog.  The
  118. description of the file may be changed or entered at this
  119. time.
  120.  
  121. W) Show Volumes in Catalog -
  122.      Displays disk volumes contained in catalog.  Shows the
  123. date each disk was cataloged, and the free space remaining
  124. on each disk at that time.
  125.     This display may be sorted into volume label sequence,
  126. or in order of remaining space on the volume, by using the
  127. L or S options on this sub-menu.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. T) Print List of Volumes -
  138.      Sets printer to condensed print mode and 88 lines per page.
  139. Prints volume list in same format as display above.
  140.  
  141. E) Erase Volume from Catalog -
  142.      Removes a volume and all its file entries from the
  143. catalog.  The sub-menu permits you to display volumes as
  144. above before entering the label of the volume to be deleted.
  145.  
  146. N) Sort by File Name -
  147. V) Sort by Volume -
  148.      The catalog may be sorted either by File Name or by
  149. Volume Label.  The catalog may be saved (written to disk) in
  150. either sequence, and the Search and Browse commands will
  151. function with either sequence.
  152.  
  153. F) Search for string in File Names -
  154. D) Search for string in Descriptions -
  155.      Searches for the given string within File Names or
  156. Descriptions and displays all entries in which the string is
  157. found. (See note)
  158.  
  159. P) Print Catalog -
  160.      Sets the printer to condensed print mode and 88 lines per
  161. page; prints the entire catalog in same format as displayed
  162. on the screen, except that both the ARC file (if any) and the
  163. description will be shown.
  164.  
  165. B) Browse Catalog -
  166.      Moves forward and backward through the catalog using
  167. the Up- and Down-Arrow keys to scroll,  the PageUp or
  168. PageDown keys to move by pages, or Home and End keys to go
  169. to the beginning or end of the catalog. (See note)
  170.  
  171. NOTE: In the catalog displays, files which are contained
  172. within ARC files are indicated by a letter "a" following the
  173. size column.  By hitting the "A" key, the ARC file in which
  174. the file is contained will be shown in the description area.
  175.  
  176. C) Change Configuration -
  177.      The Input Drive parameter determines from which drive
  178. TOMCAT will read the directory to add to the catalog, to
  179. display the directory, or to change or add the volume label.
  180.  
  181.      The Catalog Path/Name parameter allows you to keep the
  182. catalog in the directory of your choice, and use a file name
  183. of your choice.
  184.  
  185.      These configuration changes affect the current session
  186. only, unless you save the changes to the configuration file
  187. by answering "Y" to the prompt "Save to Configuration
  188. File?".  If you save the changes, they will be loaded the
  189. next time you run TOMCAT.  Note that if you move TOMCAT to
  190. another disk or sub-directory, you should move TOMCAT.CFG
  191. also, unless you wish to set up a new configuration.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. (Note: The following paragraph applies to Version 1.6 only.)
  204.      The Number of Volumes parameter allows you to reserve
  205. space in the catalog for up to 2500 volume entries.  The
  206. remainder of available memeory will be allocated for file
  207. entries.  This enables you to make the catalog storage
  208. allocation a little more efficient.  For example, if you
  209. have many volumes with only one or two large files on each,
  210. you may increase this parameter.  This parameter defaults
  211. to 120 volumes.  Note that changing this parameter has no
  212. immediate effect on the catalog, as space is allocated at
  213. the start of the program.  The changed Configuration File
  214. must be saved, and the new parameter takes effect when the
  215. program is next run.
  216.  
  217.  
  218. X) Exit -
  219.      Exit from TOMCAT.  If the catalog has been changed in
  220. memory, a warning message will be displayed, asking if you
  221. wish to write the updated catalog to the catalog file on
  222. disk.
  223.  
  224.  
  225. FOR BIGGER CATALOGS
  226.  
  227.      If you like the features of TOMCAT, but have more disks
  228. or files than this Demo Version can handle, you can purchase
  229. Version 1.6 for only $20.  Order from:
  230.  
  231.                     Roger Clare
  232.                     Box 1961
  233.                     Hato Rey, PR  00919
  234.  
  235.  
  236. E-MAIL:     Source AAJ169      GEnie ROGER.CLARE
  237.  
  238.  
  239. TECHNICAL NOTES AND ACKNOWLEDGMENTS
  240.  
  241. TOMCAT requires DOS 2 (or greater).  Has been tested with
  242. DOS 2.1 and 3.1 on PCjr and Wang PC IBM Emulation, and with
  243. DOS 3.2 on an AT-clone.
  244.  
  245. Quick screen and string manipulation was accomplished with
  246. BOOSTERS - Tool for Turbo Pascal Programmers, available from
  247. George F. Smith, 609 Candlewick Lane, Lilburn, GA 30247 for
  248. $35 plus $5 shipping.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.