home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / discutils / _m_z / quickdir / !QuickDir / !Help next >
Encoding:
Text File  |  1993-01-13  |  4.4 KB  |  102 lines
  1. !QuickDir - © 1992, 6am Digital Playground
  2. =========
  3.  
  4. 1) Instructions
  5. ---------------
  6.  
  7. This is a simple and compact utility to aid navigation of file structures,
  8. especially complex directory trees on large hard discs. It only works under
  9. RiscOS 3.
  10.  
  11. Load the software by double-clicking the application icon in the usual way.
  12. There will be no visible effect, but the software will be installed.
  13.  
  14. To activate QuickDir, click Menu over a filer window while holding down the
  15. Alt key. Instead of the normal Filer menu, you will be presented with a menu
  16. of the form:
  17.   +-------------+
  18.   | Quick Dirs  |
  19.   +-------------+
  20.   | Set CSD     |
  21.   | Set Lib     |
  22.   | ----------- |
  23.   | adfs::4.$ ⇨ |
  24.   | Library   ⇨ |
  25.   | Utils     ⇨ |
  26.   +-------------+
  27.  
  28. The 'Set CSD' and 'Set Lib' options set your CSD and Library respectively to
  29. be the directory for which the menu was invoked.
  30.  
  31. Below the line are a series of directories. The lowest one is the directory
  32. for which the menu was invoked. Above that is its parent, and so on, until the
  33. root of the filesystem is reached. In the example above, Alt-Menu was clicked
  34. over directory "adfs::4.$.Library.Utils", so there are three layers of
  35. directory shown.
  36.  
  37. If you wander rightwards into the submenu off one of these directories, you
  38. will be given a list of files in that directory. Any subdirectories off that
  39. directory have submenus for their contents, etc. The tree is built up as you
  40. explore it from the disc, so there may be slight pauses on slow devices.
  41.  
  42. Choosing an object off the menus will run it, or open a directory viewer
  43. onto it, as appropriate. The action is essentially identical to that
  44. achieved by double-clicking the file in a filer window. Holding down shift
  45. while choosing an object modifies this behavior:
  46.   For an application or directory, the directory viewer is opened.
  47.   For a file, it is loaded as a text file.
  48. This is equivalent to a shift-double-click in the filer.
  49.  
  50. Naturally, choosing an object with the Adjust button instead of Select will
  51. keep the menu open.
  52.  
  53. Using Alt-Shift-Menu over an iconised filer window works as expected,
  54. however QuickDir has no effect on icon-bar or pinboard icons.
  55.  
  56. To quit QuickDir, you must use the task manager.
  57.  
  58. 2) Technical Details
  59. --------------------
  60.  
  61. QuickDir uses a module called "FilerAltKey", which attaches as a postfilter
  62. on the filer task, and intercepts button events which indicate alt-menu
  63. clicks. When such events are found, Wimp_SendMessage is used to send them to
  64. the QuickDir task, and the original event to the filer is replaced by a null
  65. event. The filer is found by using the TaskManager_EnumerateTasks SWI,
  66. looking for a task with the right name. A single SWI, FilerAltMenu_Task
  67. (&C1300) is used by the main program to communicate with the module.
  68.  
  69. The main program is written in Acorn Desktop C, but uses little of RiscOSLib
  70. because it needs to do things with menus that Acorn clearly didn't
  71. anticipate! It keeps open only the parts of the menu structure that are on
  72. screen, creating new bits and disposing of now-vanished sections as it
  73. receives Message_MenuWarning messages from the Wimp. It relies on the
  74. property of RiscOS3 Wimp whereby sprites not found in the window's sprite
  75. pool are sought in the wimp sprite pool - otherwise there would be no way to
  76. specify a text-with-sprite icon in a menu. The name of the directory
  77. represented by the filer window is extracted from the window title bar using
  78. Wimp_GetWindowInfo, and is assumed to be an indirected string that can be
  79. read directly - since the Filer task has no WimpSlot, this is safe.
  80.  
  81. Splitting of pathnames into chunks for the top level menu is performed by
  82. splitting at full stops, until a component containing a dollar or colon is
  83. found. This covers all known cases at the moment.
  84.  
  85. Icons are picked on the basis of the object type and filetype returned by
  86. new RiscOS3 OS_File and OS_GBPB calls. These calls unfortunately treat
  87. image filing system files as directories, so they show up as such under
  88. QuickDir. I regard this as a bug, but I would have to revert to using
  89. clunkier RiscOS2 facilities to circumvent it.
  90.  
  91. 3) Distribution Permissions
  92. ---------------------------
  93.  
  94. This program is public domain, but may NOT be distributed by, or in
  95. conjunction with any profit-making means. This notice must be left intact in
  96. any copies made. Permission may be given to distribute this software in
  97. other ways - please contact the author.
  98.  
  99. --
  100. Clive Jones <crj10@phx.cam.ac.uk>
  101. Christ's College, Cambridge, CB2 3BU, UK.
  102.