home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsd / filer / !Filer- / !Help next >
Text File  |  1995-02-07  |  11KB  |  264 lines
  1.  
  2.  
  3. !Filer- , version 2.2
  4. ---------------------
  5.  
  6.  
  7. What is it
  8. ==========
  9.  
  10. 'Filer' in its name tells you that it's a kind of a filer
  11. '-'     in its name tells you that it's less than a filer
  12.  
  13. Like the Filer it allows you to 'walk' through the directory tree
  14. of a filing system and manipulate objects.
  15.  
  16. Unlike the Filer it does the first very quickly because it's 'menu driven',
  17. but is not very good at the latter - it only Filer_Run's objects which means
  18. that files can be run and loaded and directories opened; you still need the
  19. 'right' Filer to change file types, stamp files etc.
  20.  
  21.  
  22. How to use it
  23. =============
  24.  
  25. There are four ways of getting a Filer- menu:
  26.  
  27. • If a Filer window is displaying the contents of some directory,
  28.   - position the pointer over the window and click MENU while holding
  29.     down the Alt key (either the left or the right one)
  30.   - position the pointer over the window's the title bar and click MENU
  31.     (users of MouseAxess, please read 'Problems')
  32.  
  33.   The menu that appears shows the contents of the displayed directory
  34.   and looks like
  35.  
  36.   +============+
  37.   |  dir name  |  the menu title is the name of the displayed directory
  38.   +============+
  39.   |    Up    ⇨ |  leads to its parent dir or to the 'FS::Disc' submenu
  40.   +------------+
  41.   | some dir ⇨ |  go right to get further down the tree or click to open
  42.   | some file  |  click to run/load somewhere
  43.   |   etc...   |
  44.  
  45.   If you're in the root directory ('dir name' = $ ), there's no parent and
  46.   so 'Up' leads to a 1-item submenu named 'FS::Disc' holding the name
  47.   of the Filing System and the name/number of the Disc the dir is 'on'.
  48.  
  49. • Click ADJUST over any of the FS Filers (eg ADFS floppy, RAMFS).
  50.   You get a menu similar to the above for the root directory of the device.
  51.   The ResourceFS is an exception: here you get the menu for Resources:$.Apps,
  52.   just like when you click SELECT over the Apps icon.
  53.  
  54. • Click MENU over the Pinboard.
  55.   Filer-'s 'PinBoard menu' appears:
  56.  
  57.   +==========+
  58.   |  Filer-  |  menu title
  59.   +==========+
  60.   | Floppy ⇨ |  leads to ADFS::0.$
  61.   | HDrive ⇨ |           IDEFS::4.$
  62.   | RAMFS  ⇨ |           RAM:$
  63.   | Apps   ⇨ |           Resources:$
  64.   | MemFS  ⇨ |           MemFS:$
  65.   +----------+
  66.  
  67.   This is customisable and is described in !Filer-.PinBrdMenu.!Help,
  68.   but in short: you must provide a list of devices you want Filer-
  69.   to 'support' and a sprite for each device. If you supply two sprites,
  70.   "device" and "device'", the latter will be used by the Wimp to show
  71.   the device is 'selected'. 2click on !Make to make the PinBoard menu.
  72.  
  73.   If a filing system from Filer-'s PinBoard menu isn't present and you
  74.   follow the ⇨ in 'its' menu entry, Filer- will open a submenu with
  75.   a greyed out 'Not present' entry.
  76.  
  77.   The behaviour of Filer- on a MENU click over the Pinboard is determined
  78.   by a module titled 'FiPiFi' (FIler PInboard FIlter) and located in
  79.   !Filer-.PinBrdMenu under the names Alt_No and Alt_Yes:
  80.  
  81.   If Alt_No is being used you get Filer-'s PinBoard menu when you
  82.   click MENU over the Pinboard window. The click won't be intercepted
  83.   if you hold down Alt or Shift.
  84.   
  85.   If Alt_Yes is being used you get the menu when you click MENU over the
  86.   Pinboard window AND are holding down the Alt key (either left or right).
  87.  
  88.   You tell Filer- which one to use in its !Run file (see there; it's easy)
  89.  
  90.  
  91. What can it do besides?
  92. =======================
  93.  
  94. • To get into an application directory
  95.   - click SELECT/ADJUST over its menu entry while holding down Shift.
  96.     (Clicks with ADJUST keep the menu alive, of course)
  97.   - use the 'missing hand' (a 'long SELECT click'):
  98.     click on an 'application item' with SELECT and hold the button down
  99.     for a while. A 'long ADJUST click' over an application-item in a
  100.     Filer- menu works not quite as expected (see 'Problems' below)
  101.  
  102. • If a 'normal' menu item is a directory, the icon won't invert when
  103.   the pointer's over it, but RiscPC's small_diro (o=open) sprite will
  104.   be displayed instead. (Low res small_diro is used. If you mostly work
  105.   in a high resolution mode, replace !Filer-.PinBrdMenu.Sprites.small_diro
  106.   with !Filer-.small_diro.high res, but don't forget to rename it. If you
  107.   are a RiscPC, you can delete small_diro from !Filer-.PinBrdMenu.Sprites)
  108.  
  109. • When the Filer- menu gets deeper than 8 (submenus) and RISC OS complains
  110.   about 'Too menu menus', the first 8 subs are discarded and a new tree is
  111.   started with the 9th submenu as the root.
  112.  
  113. • If a submenu has the 'Up ⇨' item and you click over it with
  114.   - SELECT : the parent directory will be opened and the Filer- menu gone
  115.   - MENU   : only the menu of the parent directory will be created
  116.   - ADJUST : the parent directory will be opened and its menu built
  117.  
  118. • If you click MENU over the vertical/horizontal scroll bar of a window,
  119.   the slider will jump so that its upper/left-hand end will be (roughly)
  120.   aligned with the pointer and the window's contents scrolled appropriately.
  121.   This is very usefull with large documents that are slow to redraw and will
  122.   work with any application that has its work area origin in the upper left
  123.   corner. Many 'object based drawing programs' a la !Draw haven't so this
  124.   feature won't work with them, but !Draw is 'important' enough to get a
  125.   special treatment. Also it won't work with !Edit, cause !Edit does real
  126.   wild things to its work area (to implement its weird sliders).
  127.  
  128. • If the system variable Filer-$Options is defined and contains the
  129.   string '+center' then submenus will be positioned vertically centered
  130.   about the pointer:
  131.                                    | title
  132.                                    +---------+
  133.                                    | item x0 |
  134.                                    | ...     |
  135.                         | ...      | item xA |
  136.                         | item x ⇨ | item xB |
  137.                                  ^ | item xC |
  138.     pointer over the 'right' arrow | ...     |
  139.  
  140.   If you want the submenu to be built as usual ('item x0' at the same level
  141.   as 'item x'), ensure that '+center' doesn't occur in Filer-$Options
  142.  
  143. • If the system variable Filer-$Options is defined and contains the
  144.   string '+move' then, if a submenu is going to overlap the menu tree,
  145.   the whole of the Filer- menu will be moved left by an appropriate amount.
  146.   This feature is currently broken: after the menu has been moved, you can't
  147.   access objects from the new submenu or any other apart from the root. As
  148.   this isn't very useful, Filer-$Options shouldn't contain the string '+move'
  149.  
  150. • Quit from Task Manager
  151.  
  152. • Runs on a RiscPC (but isn't mentioned in !Products)
  153.  
  154.  
  155. Warning
  156. =======
  157.  
  158. If you RMKill FiPiFi and RMRun it again, the 'MENU over a Filer window's
  159. title bar' option may stop to work, when FiPiFi has changed it's position
  160. in the RMA. This is because FiPiFi holds a poll word for Filer-, whose
  161. address is calculated only once, when Filer- starts to run
  162.  
  163.  
  164. Problems
  165. ========
  166.  
  167. • When your Archi is very busy it can happen that the Filer- doesn't
  168.   'get' an ADJUST over a FS Filer icon (this often happens when you're
  169.   reading a DOS floppy). Just hold the button down for a while
  170.  
  171. • Some 'editor-applications' (even some by Acorn) conform to Acorn's guide
  172.   lines (or whatever it's called) and open the parent directory of a file
  173.   being edited when you close editor's window displaying the file by clicking
  174.   on the close icon with ADJUST (uff!). If you hold the button a tiny bit
  175.   longer than 'normal', Filer- catches the 'event' and doesn't let it through
  176.   to the Filer, ie. you don't get a display of the document's parent dir but
  177.   a Filer- menu of it instead. So if you want the directory displayed,
  178.   don't stick to ADJUST
  179.  
  180. • If the Filer/Pinboard died and you revived it
  181.   (*RMReinit Filer/Pinboard, *Desktop) but don't get the FS/pinboard menu,
  182.   issue a *RMReinit FiPiFi. Filer- listens for the TaskInitialise message
  183.   and does itselt the reinit when the Filer or the Pinboard restart, but
  184.   sometimes it doesn't work...
  185.  
  186. • A 'a long ADJUST click' over a Filer-'s menu application-item is expected to
  187.   - open the app's dir
  188.   - keep Filer-'s menu
  189.   Due to the way Filer- works, the 'open dir' message from a click with ADJUST
  190.   over a menu (application-)item is seen