home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / database / disctrack / !DiscTrack / !Help < prev    next >
Encoding:
Text File  |  1994-10-31  |  10.8 KB  |  192 lines

  1.  
  2.                                      DiscTrack
  3.                                     -=========-
  4.  
  5. === Requires RISC OS 3.10 or later
  6.  
  7. v1.00 (27th July 1994)
  8. Copyright © 1994 A. M. Pereira
  9.  
  10. Copyright notice:
  11. -----------------
  12. The program is a DEMO VERSION of DiscTrack. It is a fully functional, working copy, with just two differences from the full version. a) It has a notice window at startup, to remind you to register, in case you forget, and b) it is limitted to just 5 discs.
  13.  
  14. To get yourself a full version, you must send £10 (Cheques payable to Ainsley Pereira), to:
  15.  
  16. Ainsley Pereira
  17. DiscTrack Registration
  18. 'Al Sirat'
  19. Chapel Road
  20. Swanmore
  21. Southampton SO32 2QA
  22.  
  23. The 'DiscTrack Registration' line *is* important, because it means my parents will register it for you if I'm at University. If you don't include this line, then you may have to wait until the next holiday...
  24.  
  25. Don't forget to include your own name and address! You can also make any suggestions for modifications to DiscTrack, or ideas for completely new programs.
  26.  
  27. What is DiscTrack for?
  28. ----------------------
  29. DiscTrack enables you to keep track of all the files on your discs. If, like me, you have lots of discs, and you find that you have to search through several discs every time you want to use a program, then this is for you, so read on...
  30.  
  31. Loading DiscTrack
  32. -----------------
  33. DiscTrack can be loaded by double clicking on the !DiscTrack icon, by dragging the !DiscTrack icon to the iconbar or double clicking on a DiscTrack file.
  34.  
  35. Using DiscTrack
  36. ---------------
  37. Until you have at least one disc catalogued, most of the options are greyed out, so to catalogue a disc, place a disc in drive 0, and click on the DiscTrack icon. (If you want to catalogue a disc in a different drive, bring up the iconbar menu, go to 'Drive' and choose which drive you want).
  38.  
  39. (Alternatively, you could load the example catalogue provided)
  40.  
  41. You can now do lots of things, so I'll explain the iconbar menu, option by option, so that I don't forget anything...
  42.  
  43. The Iconbar Menu
  44. ----------------
  45.  
  46. Info      : Leads to a standard program information box, with the current
  47.             version number, etc in.
  48. File      : Info  - leads to an info dialogue box, with the leafname of the
  49.                     current file, the size, the number of discs, and whether or
  50.                     not you've saved it since the last change.
  51.             Save  - Leads to another submenu, from which you can save the file
  52.                     as either DiscTrack's own file type (which DiscTrack can
  53.                     load back in later), or as a Text catalogue.
  54.             Clear - Delete all the records, as if you've just loaded DiscTrack.
  55. Drive     : 0, 1, 2, 3 - Allows you to choose which drive to catalogue. Any
  56.                     drives which you don't have are greyed out. (I hope this
  57.                     works, 'cos I've only got one floppy drive!)
  58. Find      : File  - Allows you to search for a file. Type the (wildcarded)
  59.                     filename into the "Filename" box, and click on OK.
  60.                     If the "Inside applications" option is off, then files
  61.                     inside application directories will not be found, even if
  62.                     they match the filename.
  63.                     If you type something into the "On discs" box, then the
  64.                     search is restricted to discs whose names match the
  65.                     template, for example, you could search on "Utils_*" (""s
  66.                     not included), which would look for the file on any discs
  67.                     with names beginning "Utils_".
  68.                     The wildcards available are:
  69.                     # - any one character
  70.                     * - any number of any character
  71.                     You can have as many of any sort of wildcard as you like,
  72.                     (unlike inferior programs which only allow one *), so for
  73.                     example, d*t*k is fine, (and would match "disctrack",
  74.                     "dtk", or, in fact, any string starting with d, ending with
  75.                     k and with a t in it somewhere)
  76.             Space - Allows you to find somewhere to put the new program you
  77.                     just downloaded/were given/wrote/created by manipulating
  78.                     electrons with mere thought power/etc.
  79.                     Find the desired size, and type it into the "Size" box, and
  80.                     ensure that you have selected "bytes" or "kilobytes" as
  81.                     appropriate, and click on OK.
  82.                     The "On discs" box works just like in Find File.
  83.  
  84.                     The search results window is the same for either Find file
  85.                     or Find space, and has 3 display fields, showing you the
  86.                     name of the disc that the file/space was found on, the path
  87.                     (always just $ for Find space), and the name of the file
  88.                     (left blank for Find space). There are also 3 action icons:
  89.                     Abort - Stops search.
  90.                     View  - Opens a directory display containing the found
  91.                             item, useful if it's buried deep in directories.
  92.                     Next  - Find the next match.
  93. Disc      : Add   - Adds a disc to the catalogue. (Equivalent to clicking with
  94.                     select on the iconbar icon)
  95.             Update- Similar to Add, but with a subtle difference: The disc will
  96.                     never be renamed (See Options)
  97.             Remove- Removes a disc. You can either remove the current disc (ie
  98.                     the one currently in the chosen drive), or you can type the
  99.                     name of the disc to remove, in the writeable field.
  100.             Browse- Opens a window showing the contents of the first disc. A
  101.                     small pane is shown below the main display, the pane shows
  102.                     the disc name, size and amount of free space. You can also
  103.                     move forward/backward by one disc by clicking on the
  104.                     Prev/Next icons.
  105.                     Double clicking on a file will open a "File info" box,
  106.                     showing the leafname, filetype, size, and file sprite if
  107.                     available.
  108.             List  - Opens a list of the names of the currently catalogued discs.
  109.                     Double clicking on a discname will open the browser on that
  110.                     disc, and you can remove a disc by bringing up a menu over
  111.                     the required discname, and choosing "Remove". (Or double
  112.                     clicking Adjust whilst holding down Shift, if you're really
  113.                     lazy)
  114. Choices... : This opens the Options window, from which you can set these
  115.              options:
  116.             Text Output: Just discnames - If selected, then when you save the
  117.                                           catalogue as text, a list of discs is
  118.                                           saved, with no contents.
  119.                          Don't print !Application contents - Doesn't include
  120.                                           anything inside application
  121.                                           directories, such as !Run, !Sprites,
  122.                                           etc (This also affects the browser
  123.                                           display)
  124.                          Dashed line between discs - If selected, then a line
  125.                                           of ----s will appear between each
  126.                                           disc, when the catalogue is saved as
  127.                                           text. (Unless "Just discnames" is
  128.                                           selected)
  129.             Colours    : Allows you to choose the foreground colours for the
  130.                          disc list/browser.
  131.             Scanning   : Allows you to rename the discs as you scan. All these
  132.                          options only have any effect if "Rename discs" is
  133.                          selected.
  134.                          The prefix can be typed into the first writeable icon,
  135.                          eg. to name the discs Utils_01, Utils_02, Utils_03 etc
  136.                          as they're catalogued, you type "Utils_" into the
  137.                          prefix box, and 2 into the "Number width" box (this is
  138.                          the number of digits to use).
  139.                          You can also set where to start numbering from, for
  140.                          example you might already have upto Utils_07, so you'd
  141.                          want to start from Utils_08.
  142.                          If you choose "Update" instead of "Add" from the disc
  143.                          menu, then the disc isn't renamed, but any disc which
  144.                          currently had the name is replaced with this, so you
  145.                          can Update a disc which was already catalogued, but
  146.                          was changed without altering it's number and name.
  147.                          This field is automatically updated after each disc is
  148.                          scanned and renamed, so if "Save options when quit" is
  149.                          selected, then the numbering position will be saved.
  150.             The other icons in the Options window are:
  151.                          Default: Reset to the default options.
  152.                          Save   : Save these options for use in future sessions
  153.                                   (and use them now)
  154.                          Cancel : Ignore changes made since the Options window
  155.                                   was opened.
  156.                          OK     : Accept the options you've set, and use them
  157.                                   now.
  158. Quit      : Quits DiscTrack. If "Save options when quit" was selected, then the
  159.             options will be saved for use next time.
  160.  
  161. Credits:
  162. --------
  163. DiscTrack was written by Ainsley M. Pereira, (aka Amp(y)), of Maelstrom.
  164.  
  165. Thanks go to:
  166. Guttorm Vik for writing the best editor program (StrongEd)
  167. The DeskLib team for DeskLib (!)
  168. Dick Alstein for TemplEd, and for pointing out the obvious to me :-)
  169. Rebecca Moon and Hannah Corbett for the end of term pressies, which were very much appreciated :-)
  170. Roxette, G&R, Mozart, Elgar, Bach, and Pachelbel for the music I listened to whilst writing this.
  171. Keith Hall for redesigning my templates, rewriting my code, setting up Binkley and NListMgr for me and generally not doing anything :-)
  172.            /\/\
  173. The other <    >aelstrom members (Gareth Boden and Andrew Pepperell) for sending me their programs.
  174.  
  175. Plugs:
  176. ------              /\/\
  177. Look out for other <    >aelstrom products:
  178. APTracker 2 - by Andrew Pepperell. The Ultimate PD tracker program.
  179. TrueANSI    - by Gareth Boden. The Best ANSI editor.
  180.  
  181. Contacting the author:
  182. ----------------------
  183. I can be reached at:
  184.    'Al Sirat'
  185.    Chapel Road
  186.    Swanmore
  187.    Southampton SO32 2QA
  188.  
  189. Internet: ampy@digibank.demon.co.uk             \ Not during termtime
  190. Fidonet : 2:251/25.5, 2:250/219.5, 2:257/501.3  /
  191.  
  192. Internet: a.pereira@cs.ucl.ac.uk                  Termtime