home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / o / orbits / showdir / Doc < prev    next >
Encoding:
Text File  |  1991-11-24  |  3.7 KB  |  88 lines
  1.          Showdir - A utility for RISC OS computers by Neil Hoggarth.
  2.          -----------------------------------------------------------
  3.  
  4. Introduction.
  5. -------------
  6.         Showdir emulates the actions of the desktop filer when opening a
  7. directory for the first time. It scans a directory looking for applications
  8. and, if it finds any, running the associated "!boot" files. Running showdir
  9. on a directory full of applications therefore sets up filetypes, run actions
  10. icons, etc. without actually having to open the directory viewer. This is
  11. particularly useful for hard disc users who can put their applications into
  12. a directory and then initialise them all from within a !BOOT startup script.
  13. Subsiquently clicking on a document file will load the relevent editor or
  14. application without you having to go and look for it.
  15.  
  16. Installation.
  17. -------------
  18.         Copy the file "showdir" to your normal Library directory. This can
  19. be any directory pointed to by the system variable Run$Path but is often
  20. "$.Library" on your hard disc.
  21.  
  22. Running the program.
  23. --------------------
  24.         Before the program is run the shared C library module must be
  25. loaded. The program is started from the command line or within an obey
  26. script. The syntax of the command is as follows.
  27.  
  28.         showdir <filename>
  29.  
  30. "<filename>" is the filename of the directory to be searched. An error will
  31. be generated if this parameter is missing or the directory does not exist.
  32.  
  33. eg.     showdir SCSI::HardDisc.$.Apps
  34.  
  35.         The program is intended to be used in a startup file, such as
  36. "!Boot" or a Desktop startup file. Run it on your application directories
  37. and all the filetypes, sprites, run actions, etc. for your applications will
  38. be automatically set up. This means that draw files have the right icon even
  39. if you haven't 'seen' the Draw application. If you double click on an
  40. Impression document then Impression loads automatically, rather than giving
  41. an "Impression has not been seen by the filer" error. My Desktop startup
  42. file includes the lines
  43.  
  44.         Run SCSI::4.$.!System
  45.  
  46.         RMensure SharedClibrary 3.50 RMload system:modules.clib
  47.  
  48.         showdir SCSI::4.$.Apps
  49.         showdir SCSI::4.$.Dtp
  50.         showdir SCSI::4.$.DDE
  51.  
  52.         Which sets up all the editors, Impression, file conversion
  53. utilities, Desktop C and so forth, to recognise their files. Remember
  54. that clib must be loaded before running showdir
  55.  
  56. Copying.
  57. --------
  58.         This program has been placed in the public domain by the author
  59. subject to the GNU general public licence (note that this program has
  60. nothing to do with th GNU project as such, I am simply borrowing the FSF's
  61. licence). A copy of the licence should be distributed with the program in a
  62. file called "Copying". You should recieve all the following files
  63.  
  64. Docs               This text file.
  65. Copying            The GNU general public licence.
  66. Makefile           A set of rules for compiling the program with "make"
  67. showdir            The program.
  68. c.showdir          The source code.
  69. ChangeLog          See below.
  70.  
  71. As explaned in the general licence you may modify the program and distribute
  72. your own version. Since different people may take the source and modify it
  73. independently it is imposible to come up with any consistent version
  74. numbering scheme. Instead I use a file which goes with the program called
  75. "ChangeLog". If you modify the code and subsiquently distribute your version
  76. then comment the changes in the code and also append an entry to ChangeLog.
  77. The ChangeLog file should therefore provide a "backtrace" of all the people
  78. who have had a hand in the code.
  79.  
  80.  
  81. All bug reports, new versions, constructive critisism, etc. to the following
  82. address.
  83.  
  84.     Neil Hoggarth
  85.     18 Stanmore Lane,
  86.     Winchester,
  87.     SO22 4AJ.
  88.