home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / 4dcat10.zip / 4DCAT.DOC < prev    next >
Text File  |  1996-03-06  |  7KB  |  181 lines
  1. -----------
  2. QUICK START
  3. -----------
  4.  
  5. Installation:
  6.   Put all files in some directory.
  7.  
  8. Running the program:
  9.   Do step 1 and 2 a few times . . .
  10.   1- Put a floppy in drive A: and type 4dcat.
  11.   2- Type a(dd) in answer to the question.
  12.   3- Look at the file 'database.txt'
  13.   4- If you like it: go on!
  14.      If you don't like it: delete all files. . . OOPS
  15.      Take a look at FGREP and RPSORT they're NOT mine and you might find them
  16.      still useful.
  17.  
  18. ------------
  19. What it does
  20. ------------
  21.  
  22. 4dcat.btm is a floppy cataloguer which combines simplicity (ease of use) with
  23. flexibility (maintaining a freeform batabase with your editor).
  24. It makes a directory listing of every floppy feeded to it.
  25. All the directory listings are saved in a file (the database) and every
  26. directory listing is given a label. (In fact every line in the directory gets
  27. this label). This label consist of a sequence number and a letter.
  28. The letter is an a or b, depending on the drive used.
  29.  
  30.  
  31. So floppies in drive a: will be labeled 1a, 2a, 3a .. 999a.
  32. So floppies in drive b: will be labeled 1b, 2b, 3b .. 999b.
  33. This label must be written on the floppy disk. (Disklabel)(*)
  34.  
  35. Apart from the database (and a backup file) one other file is created:
  36. the disklabel file. This file consist of just two items:
  37.  The last label ADDED to the database from drive A:
  38.  The last label ADDED to the database from drive B:
  39. (For systems with only one drive (A:) only one label is used.)
  40.  
  41. Most from its simplicity comes from its very limited options(**) :
  42.   1- You can add a volume to the database.
  43.   2- You can refresh (update) a volume.
  44.   And updating is done mostly automatically.
  45.  
  46. By starting the program without parameters:
  47.   it starts to read floppy a:.
  48.   it checks the serial number with the database.
  49.   if found it updates the database.
  50.   if not found it adds the volume and gives you the label(*) and it inceases
  51.     the database number file (database.dnr)
  52.  
  53. - So nothing is written to floppy.
  54. - The database is a textfile in the same format as given by the 'DIR' command.
  55. You can extract data from the database with every available text utility:
  56. FIND, FFIND, SORT, TYPE, LIST and of course SED, GREP and the added FGREP.
  57.  
  58.  -  The format of the database is that of the command DIR.
  59.  -  The disk label is in the first 4 columns of the database.
  60.  -  The volumenumber is used to prevent double entries.
  61.  -  4dbcat.btm can be customized to fit personal needs.
  62.  -  This batch is FREEWARE!
  63.  -  The batch needs one external program FGREP. :(
  64.  
  65. The first time you use it it will complain about files wich do not exist.
  66. Like this:
  67.  ------------------------------------------------------------- start of example
  68.  
  69. d:\4dc\4dcat.btm [17]  File not found "d:\4dc\database.txt"
  70. This disk volume is not found in the database.
  71. Refresh or Add? r/a: a
  72. d:\4dc\4dcat.btm [121]  File not found "@line[%dnrs,0]"
  73. d:\4dc\4dcat.btm [122]  File not found "@line[%dnrs,0]"
  74. 1b added to the database.
  75.      ┌───────────────────────┐
  76.      │ Label this disk as 1b │
  77.      └───────────────────────┘
  78.  
  79.  ---------------------------------------------------------------------
  80. After the first disk it goes like this: (interactive mode)
  81.  --------------------------------------------------------------------- 
  82. This disk volume is not found in the database.
  83. Refresh or Add? r/a: a
  84. 2b added to the database.
  85.      ┌───────────────────────┐
  86.      │ Label this disk as 2b │
  87.      └───────────────────────┘
  88.  
  89.  
  90.  --------------------------------------------------------------- End of example 
  91.  
  92. ------------------------------------
  93. Command line parameters are: a b r ?
  94. ------------------------------------
  95. To ADD a disk in station A: to the database type:      4dcat [a] a
  96. To ADD a disk in station B: to the database type:      4dcat b a
  97. To REFRESH a disk in station A: to the database type:  4dcat [a] r
  98. To REFRESH a disk in station B: to the database type:  4dcat b r
  99. To get HELP type:                                      4dcat ?
  100. (a: is the default station so you can leave it out.)
  101.  
  102. The program always checks the volume serial number of the disk with that of the
  103. database. If it is found the disk can not be added but the database will be
  104. updated. (refreshed). This works fine as long as the disk is not reformatted.
  105. If the disk is reformatted or if it has no serial number (It was formatted long
  106. ago with an old DOS version) this check fails. You have to tell the program what
  107. to do: add or refresh. Either by commandline option or you will be prompted.
  108.  
  109. Deleting a volume in the database is not implemented.
  110. You can do it easily with an editor. But why should you?
  111. If you want to reuse a floppy which got broke you can use the 'refresh' option:
  112. you label it as the old floppy and the program thinks it has been reformatted.
  113.  
  114. ------
  115. FILES:
  116. ------
  117.  
  118. needed:
  119.     4cat.btm      The main program cataloguer.
  120.     fgrep.zip     A text utility.
  121.  
  122. goodies:
  123.     4dcat.doc     This file.
  124.     rpsort.zip    The rpsort program + docs.
  125.     fredisk.btm   Shows empty disks.
  126.     frespace.btm  Shows the free space of all disks.
  127.     sortem.btm    A batch to sort the files in the database (uses rpsort + fgrep).
  128.     sortdb.btm    A batch to sort the database (uses rpsort).
  129.     4menu.btm     A menu like interface for the type-weary.
  130.     4menu.txt     The programs you can select with 4menu.btm.
  131.  
  132. created:
  133.     database.txt  The database.
  134.     databack.txt  A backup of the database.
  135.     database.dnr  A file that keeps track of the last added floppy.
  136.     datasort.txt  The result of sortdb.btm.
  137.  
  138.  
  139.  
  140. Background bla bla
  141.  
  142. The idea of this batch program came from a program by David Connelly.
  143. (4cat.exe). That program does almost just what I want. I like its simplicity
  144. but not its rigidity. (And I don't want to pay $10 (+ about $10 bank charge)
  145. for it.)
  146. I want to handle subdirectories too and I want the format exactly like that of
  147. the DIR command, including all possible switches.
  148. And being such a simple task -just making a bunch of directory listings- I
  149. thought it should be possible with 4dos' batch language. Well, I almost
  150. succeeded. (I needed one external: FGREP.EXE by Chris Dunford).
  151. If someone succeeds in kicking those lines out (without sacrifying too much
  152. speed) please let me know. Also other improvements are welcome of course.
  153.  
  154. E-mail:             tenkink@nfra.nl
  155.  
  156. Snail Mail:         Hans Tenkink
  157.                     Broeklaan 22
  158.                     7991 BX Dwingeloo, The Netherlands
  159.  
  160.  
  161.  
  162. The batch files are freeware, do with them what you want. The added FGREP and
  163. RPSORT are just passed on.
  164.  
  165. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  166. (*)
  167. For the labels I prefer typing correction tape (two lines wide). It sticks
  168. better then (for example Avery) labels. But of course you can write it somewere
  169. on the disk label itself.
  170.  
  171. (**)
  172. For a full blown floppy cataloguer I can recommend WinCat/PRO
  173. A great program with every thinkable option and a label printer/editor added.
  174. It is a shareware Windows program by Mart Heubel who donates the registration
  175. fee (f25) to the Dutch Foster Parents Plan.
  176. Available at Simtel and Garbo.
  177. CompuServe Mail: 72066,2116
  178. Snail Mail: Mart Heubel
  179.             De Heugden 161
  180.             6411 DR Heerlen, The Netherlands
  181.