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