home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / dirmenu / !DirMenu / !Help < prev    next >
Text File  |  1993-07-27  |  7KB  |  171 lines
  1.  
  2.      DirMenu (Directory Menu)  2.22 (27 Jul 93)
  3.      ------------------------------------------
  4.  
  5. This utility provides an easy way to access directories/files of your disc 
  6. and resource filing systems without thrashing through endless filer windows.
  7.  
  8. It provides hierachical menus containing the tree structure of any of your 
  9. filing systems. These menus can be opened either by clicking with <Select> on 
  10. one of DirMenu's icon-bar icons, clicking Alt-<Menu> in a Filer window, or 
  11. just <Menu> on the title-bar of a Filer window.
  12.  
  13. Choosing an item in a menu will do exactly the same thing as double-clicking 
  14. it in a normal Filer window - i.e. open directories, load files, or run apps. 
  15. !DirMenu just does a '*Filer_Run ...' on whatever you clicked on, so hold down 
  16. <shift> to open app dir's / load files into your text editor, or <ctrl> to 
  17. open a dir without booting apps. Selecting a menu item with <Adjust> will keep 
  18. the menu open.
  19.  
  20. Clicking Alt-<Menu> inside a filer window, or <Menu> on the title-bar of a 
  21. filer window, will bring up a menu containing all the parent directories of 
  22. the directory, and also the contents of the directory. 
  23. This allows you to access the directory, its sub-directories, or any of its 
  24. parents very easily, and also branch out into any part of the directory's 
  25. filing system. 
  26.  
  27. DirMenu comes set up to have one icon-bar icon. Clicking <Select> on it will 
  28. bring up a menu containing the contents of ADFS::4 (your hard drive, if you 
  29. have one), as well items leading to your Resource filing system, your scrap
  30. directory, the Currently Selected Directory (CSD) and whatever is in your 
  31. floppy disc drive.
  32.  
  33. The text file 'Configs' in DirMenu's application directory contains 
  34. configuration info which is read by DirMenu when it starts up. Amongst other 
  35. things, the number of icon-bar icons and their menu contents can be changed 
  36. by editing the file using !Edit or similar. See next section.
  37.  
  38.  
  39. Clicking <Menu> on any DirMenu bar-icon will bring up a conventional Info/Quit 
  40. menu, with these other items:
  41.  
  42.    Help          - loads this file into your text-editor.
  43.    Edit Configs  - loads 'Configs' into your text-editor for editing.
  44.    Update        - re-scan 'Configs'. Do this if you change 'Configs' while 
  45.                    DirMenu is running.
  46.  
  47.  
  48.  
  49. Specifying Icon-bar menus, and other options.
  50. ---------------------------------------------
  51.  
  52. All options are set in the file 'Configs' in the directory !DirMenu. To change 
  53. the options, you should edit the file using a text editor such as !Edit. If 
  54. DirMenu is running, you will need to choose 'Update' from the normal bar-icon 
  55. menu after saving the new version of configs.
  56.  
  57. The file contains comments on how to specify the various parameters; it should 
  58. be fairly clear how to change things, so this is just a brief guide:
  59.  
  60. Things that you can change:
  61.  
  62.    Number of bar-icons
  63.    Menu colours
  64.    Where to open iconbar menus on the screen
  65.    The contents of each bar-icon
  66.  
  67. The contents of each bar-icon menu are a series of file paths, e.g. 'ADFS::4.$' 
  68. or 'Resources:'. DirMenu will create a menu containing each of these paths 
  69. separated by gaps. In addition, you can append a '*' to a path, which will 
  70. make DirMenu add the first-level contents underneath the path. i.e. 'ADFS::4.$*' 
  71. will add the contents of the root directory of your hard disc to the menu, 
  72. which saves you moving to a submenu, at the expense of making the root menu 
  73. bigger. 
  74.  
  75. You should change 'ADFS::4.$*' to contain whatever your hard disc is called, 
  76. i.e. 'ADFS::<discname>.$*'.
  77.  
  78. General note: Don't append a '.' to any item
  79.  
  80. Making a separate bar-icon point to a very frequently used directory can be very
  81. convenient. This is made easier if the directory is an application which 
  82. sets a system variable to its location. You can then use <...$Dir> in DirMenu's 
  83. 'Configs' file.
  84.  
  85. You can create a menu of *commands by creating an application dir that contains 
  86. various Obey files, and then make a DirMenu icon wich displays this directory.
  87.  
  88. Any system variables can be items in a DirMenu menu, by specifying them in 
  89. 'Configs', e.g. '@' to get at the CSD, or '<Wimp$ScrapDir>'
  90.     
  91. Note that if an item that you specified looks like a floppy disc, the Wimp will 
  92. ask you to insert it each time you go to that item in the menu tree.
  93.  
  94.  
  95.  
  96. Random nice features:
  97. ---------------------
  98.  
  99.  • Configurable colours! Big white menus are a bit of an eye-sore. If you don't 
  100.    like the colour scheme, just alter the 'Configs' file.
  101.  
  102.  • Compatible with Jens Ovesen's FilerPatch. i.e. directories which have been set 
  103.    to look like applications in Filer windows (bit 6 of Access set) are detected, 
  104.    and displayed correctly by DirMenu.
  105.  
  106.  • Text in the menus is padded with spaces so that the highlighting is clear. I
  107.    did this because the Wimp doesn't highlight text+sprite menu-icons very well.
  108.    
  109.  • Being able to bring up a menu for a Filer windor by clicking <Menu> on the 
  110.    title bar saves you from having to go to the keyboard. You can have fewer 
  111.    Filer windows open to save desktop clutter, but still have easy access to all 
  112.    your files.
  113.    
  114.  • You can set the number of icon-bar icons to be zero. This will save space on 
  115.    the icon bar, but clicking on Filer windows will still work. You will have to
  116.    quit DirMenu from the Task Manager window if you do this.
  117.  
  118.  • DirMenu is set to expand pathnames prior to Filer_Run-ing them, i.e. system
  119.    variables and '@' (representing the CSD) in the path name are expanded. This 
  120.    uses the SWI "OS_FSControl". You can turn this option off by altering 
  121.    'Configs'.
  122.  
  123.  
  124. ------------------------------------------------------------------------------
  125.  
  126.  
  127. Other Stuff
  128. -----------
  129.  
  130. Many thanks to Dominic Symes, for his superb text editor, !Zap, and Jason 
  131. Williams et al for the equally superb Wimp C library, DeskLib.
  132.  
  133. This program is freeware. It may NOT me used in connection with any profit-
  134. making activities. Please contact me if you want to distribute DirMenu in a 
  135. PD library.
  136.  
  137. DirMenu is copyright Julian Smith 1993.
  138.  
  139. Feel free to distribute this program, but you may only distribute the ORIGINAL 
  140. version, with all files present.
  141.  
  142. If you find this program useful, you might like to make a donation to Amnesty 
  143. International, say £5, by sending me a cheque made out to them.
  144.  
  145. Can anybody tell me why DirMenu needs more than a 32k wimpslot to run, despite
  146. having a 21K !RunImage ????
  147.  
  148. Also, please let me know if you have any comments, problems, suggestions or 
  149. praise, (or have found a bug!).
  150.  
  151.  
  152.  
  153. - Julian Smith
  154.  
  155.  
  156.  ------------------------
  157.  julians@cogsci.ed.ac.uk
  158.  ------------------------
  159.  
  160.  or:
  161.  
  162.  ------------------------
  163.  Department of Psychology
  164.  University of Edinburgh
  165.  7 George Square
  166.  Edinburgh
  167.  EH8 9JZ
  168.  UK
  169.  ------------------------
  170.  
  171.