home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities3 / discindex / DiscIndex / !DiscIndex / Help / !Help / HelpText < prev   
Text File  |  1994-08-04  |  9KB  |  183 lines
  1. ________________________________________________________________________________
  2. Disc Index  - a convenient disc manager (1.02 - Rebecca)  (c) 1994 Neil A Carson
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5. Introduction
  6. ~~~~~~~~~~~~
  7. A week ago, a friend called [Adrian Himpson] showed me an application called
  8. !DiskLib by Chris Payne, a user who got fed up of losing his files on hundreds
  9. of different disks. As I am in a similar situation - and so I guess are many
  10. other people, I gave the program a go. While the idea  was an absolutely
  11. brilliant one - it makes a database of disc contents up automatically - the
  12. implementation seemed to lack a few important features (version 2.0), namely:-
  13.  
  14.   • To change the limit of discs the program could handle, you had to edit the
  15.     source code
  16.   • It didn't look nice and 3D
  17.   • It wouldn't handle big filenames properly
  18.   • It only worked with ADFS
  19.   • The program compiled it's index using everything in just the root directory
  20.   • Search facilities were limited
  21.   • It did not save in the standard way
  22.   
  23. With these points in mind, I wrote DiscIndex. Also included in this package is
  24. a help reader, a make utility, and the [source code] for all three programs.
  25.  
  26. Using DiscIndex
  27. ~~~~~ ~~~~~~~~~
  28. Using the program is easy. Double click the application in the usual way to
  29. load it onto the icon bar. Pressing menu over the icon reveals all the usual
  30. options, a dialogue box to save the data, and a help option (this...). If you
  31. select 'Clear all' all discs in memory will be deleted.
  32.  
  33. Clicking adjust on the main icon doesn't do anything, but clicking select brings
  34. up the catalogue window. Pressing menu reveals a different menu.
  35.  
  36. DiscIndex can input the contents of several discs, store them, and search
  37. through them. So to start with, you will want to input some discs. First, a
  38. guided tour:
  39.  
  40. The 'disc catalogue' window can show the contents of one disc at a time. To
  41. change the currently shown disc, you can click the arrows to the left and right
  42. of the 'number' field. Alternatively, on the menu, go to start, go to end will
  43. go to the first (1) and last records respectively, and typing a number into the
  44. dialogue box off 'go to disc' (and pressing OK) will go to a disc with a
  45. specific number, or won't do anything if the disc doesn't exist.
  46.  
  47. Each disc can have a 32-character description, and so can each file. To enter
  48. a description for a disc, type it into the writiable icon at the top, and
  49. press 'Input'. Don't do that yet, though, as you haven't read a disc in.
  50.  
  51. The program always has one disc on record - this is it, disc 1. Now, click on
  52. Re-scan this record. Up pops the 'Scan Disc' dialogue box. From this, you can
  53. specify which drive/directory (e.g. ADFS::0.$) you want as a search root, and
  54. what items you want included. Clicking on 'Root directory only' makes the
  55. program stick to the first directory in a tree. Note the program will otherwise
  56. go through sub-directories. Selecting the 'Dismount' option means that the
  57. program will try to dismount the disc (*DISMOUNT) when it finishes. This stops
  58. the computer hanging due to a bug in FileCore when scanning lots of discs.
  59.  
  60. Scan a floppy (ADFS::0.$) for an example. Notice many of the icons in the
  61. window have been filled in. In the bottom left square is a list of files on
  62. the disc, but maybe not the whole lot. Click on the up / down arrows to see more
  63. than 16. '-=o=-' indicates no file. If you click on a file, the 'selected
  64. file info' section will be filled in, and the file hilited. While selected,
  65. you can type in a 32-character description for this file, in the same way as for
  66. the disc (remember to click on input!).
  67. All of the 'tools' should be quite obvious. Insert inserts a new, blank record
  68. before the current one. It will not work with disc 1.
  69. 'Scan new record' allows a new disc to be scanned without overwriting the
  70. current one. 'Create record' will create a new, blank disc record. You can guess
  71. what 'Delete this record' does.
  72.  
  73. Files can be saved in the usual RISC-OS way, from either the icon or window
  74. menu. When a file has been saved, clicking 'Quick Save' will save it again
  75. without the user having to bother going through the usual dialogue box/menu.
  76. Dragging a DiscIndex file onto the application or double clicking it will
  77. replace the records in memory. To merge the file contents with those already in
  78. memory, drag the file in with SHIFT held down.
  79.  
  80. Choose 'Search' from the window menu. All of the options here are fairly
  81. obvious. The program searches through every file on every disc to try and find
  82. the named string. Try searching for something you know exists, and turn on
  83. all of the options apart from 'case sensitive'. If the argument was found, up
  84. pops a window with the first sixteen matches, the disc the match was on, the
  85. file (if applicable) and the context in which the search argument was found.
  86. Clicking on a disc name will move the catalogue window to the appropriate disc.
  87.  
  88. Source
  89. ~~~~~~
  90. The source code for DiscIndex, HelpMe (the help file viewer) and nmu (a nice
  91. make utility) are included. If you make changes to any of the files, send
  92. me the updates, at my [address].
  93.  
  94. Bugs
  95. ~~~~
  96. If you find any bugs, and you can re-create the circumstances under which they
  97. occur (and I can too!) let me know.
  98.  
  99. More!
  100. ~~~~~
  101. Also among my collection of programs:
  102.     FracScape 2.01 (shareware) - does fractal ground, clouds, trees etc. Script
  103. language, 24-bit colour (Clear), hypertext help, etc. Costs £5.
  104.  
  105. Coming soon: LandWorks. Loads of features, takes advantage of RISC-PC.
  106.  
  107. All programs written on A3000, 20Mb HDD, ARM C vsn. 3.
  108. I NEED A RISC PC. HELP!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  109. Does anyone know why calling OS_GBPB (10) with an incorrect filename causes
  110. a 'FileCore in Use' error?
  111.  
  112. Problems / Future
  113. ~~~~~~~~~~~~~~~~~
  114. This implementation is not perfect, namely:-
  115.  * Load/Save will not work with more than 65536 files on a disc (damn...)
  116.  * Can only handle (roughly) 4 billion discs (what a shame)
  117.  * The Currently Selected Directory changes when a disc is scanned
  118.  * There is no print/save as text option
  119.  * The program slows up with many discs (a change to the Link List code needed)
  120.  * Saved files can get big (how's about some LZW encoding?)
  121.  * Redraw is sssslllloooowww
  122.  
  123. If you want to implement any of these features, or any others, or if you want
  124. them implemented, contact me. I will implement stuff if there is sufficient
  125. demand. No doubt Gordon Taylor will want to get me back for all the complaining
  126. I was doing about ArtWorks... !
  127.  
  128. Me
  129. ~~
  130. I am:  Neil A Carson
  131.         1 Penn Close
  132.          Abingdon
  133.           Oxford OX14 2NX
  134.            Tel (0235) 528443 (after 6PM please)
  135.            
  136. Amateur radio to neil@g7kqy.ampr.org (TCPIP)
  137. or Ben (g7kqy@gb7avm) will forward stuff to me. At last, Ben's a RISC-PC fan!
  138.  
  139. RISC_OSLib
  140. ~~~~~~~~~~
  141. I have had many people moaning at me for using RISC_OSLib rather than DeskLib.
  142. Note: Typing 'wimp_w' instead of 'window_handle' saves a lot of time, and I
  143. bet the source code is smaller when using RISC_OSLib.
  144.  
  145. Adrian Himpson
  146. ~~~~~~ ~~~~~~~
  147. He is a keen video editing / genlocking / full motion video / multimedia freak.
  148. If you have anything you want tested, he will be only too keen to give it a go.
  149. Address: 12 Edward Street, Abingdon, Oxford.
  150.  
  151. Hello's and Thankyou's
  152. ~~~~~~~ ~~~ ~~~~~~~~~~
  153. Dom Symes for Zap 1.10 (again...)
  154. Disk Alstein for !TemplEd (doesn't crash like Glazier, or not work like FormEd)
  155.  
  156. Hi to: Ben Strawson, Jon Turner, Adrian Himpson, Lou, Manar Hussein, Gordon
  157. Taylor, Rob (the big bloke at Imperial), Ray (a fellow UNIX fan - can we
  158. have a RISC-PC UNIX?), Becca Cruise, Phil, Alastair Summers, David Pilling,
  159. Mike Curnow (of !Fractal fame - where are you now, Mike, I can't get through on
  160. the phone... ?) Jo Moxon, abd anyone else who I don't have time to write down...
  161. And of course, thanks to Chris Payne for the idea.
  162.  
  163. Release History
  164. ~~~~~~~ ~~~~~~~
  165. 1.00    It worked, sort of.
  166.  
  167. 1.01    Cured a bug in 1.00 when trying to load a file which contained an empty
  168.         disc. It did try to grab all memory!
  169.         Inserts files properly.
  170.  
  171. 1.02    Implements a few suggestions from all 3 users, including me! Dismount
  172.         option adde