home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / filer / !Filer- / !Help next >
Text File  |  1994-09-08  |  16KB  |  433 lines
  1.  
  2. !Filer- version 2.0
  3. ___________________
  4.  
  5.  
  6. 1.1 -> 2.0 changes
  7. ==================
  8.  
  9. pinboard menu items changed from text to 'pointer sensitive' sprites.
  10. looks nicer, but the sprites must go into the Wimp sprite pool and
  11. if you add new devices to the pinboard menu you'll have to find
  12. appropriate sprites for them
  13.  
  14. the pinboard menu configuration stuff has been moved out of !RunImage.
  15. a dedicated program is used to create needed data from a list of
  16. device/sprite pairs. see !Filer-.PinBrdMenu.!Help
  17.  
  18. if a 'normal' menu item is a directory, the icon won't invert when
  19. the pointer's over it, but RiscPC's small_diro (o=open) sprite will
  20. be displayed instead. (low res small_diro is 'used'. if you mostly work
  21. in a high resolution mode, replace !Filer-.PinBrdMenu.Sprites.small_diro
  22. with Stuff.small_diro.high res (don't forget to rename it). Still better
  23. put both into ResoIcons/IconSwitch, whatever your low/high res icon
  24. switcher's name is. if you are a RiscPC, you can do even better: delete
  25. small_diro from !Filer-.PinBrdMenu.Sprites)
  26.  
  27. the 'missing hand' feature (see below) has been added
  28. (it's about opening directories, something a filer does ?)
  29.  
  30. --
  31.  
  32. 2.0 !RunImage is 14071-13420 bytes longer than 1.1 and it adds 3640 bytes to
  33. your Wimp sprite pool. so, it comes with the 1.1 !RunImage in Stuff.Greyish
  34.  
  35.  
  36. bug fixes
  37. =========
  38.  
  39. when you got the 'Too menu menus' error (RISC OS' 8 menus limit) and
  40. clicked on 'OK' in the error box, Filer- fell into the infinite
  41. 'Not a heap block' error loop, which you could leave only by quitting
  42. Filer- (clicking 'Cancel'). this has been corrected in both 1.1 and 2.0 .
  43. you still get the error box, but can safely click upon 'OK' to ignore
  44. the error.
  45.  
  46.  
  47. the modified 1.1 !Help follows
  48. { stuff in {} brackets applies to 2.0 only }
  49.  
  50. --
  51.  
  52. Who's that girl ?
  53. =================
  54.  
  55. 'Filer' in its name tells us that it's a kind of a filer
  56. '-'     in its name tells us that it's less than a filer
  57.  
  58. Like the Filer it allows you to 'walk' through the directory tree
  59. of a filing system and manipulate objects.
  60.  
  61. Unlike the Filer it does the first very quickly because it's 'menu driven',
  62. but is not very good at the latter - it only Filer_Run's objects which means
  63. that files can be run and loaded and directories opened; you still need the
  64. 'right' Filer to change file types, stamp files etc.
  65.  
  66.  
  67. How to use it...
  68. ================
  69.  
  70. There are three ways of getting a Filer- menu.
  71.  
  72. 1) If there's an opened directory viewer on your desktop,
  73.    position the pointer over it and click MENU while holding down
  74.    the Alt key (either the left or the right one). The menu that
  75.    appears shows the contents of the directory (the viewer is already
  76.    displaying...) and looks like
  77.  
  78.    +------------+
  79.    |  dir name  |  the title holds the name of the directory
  80.    +------------+
  81.    |    Up    ⇨ |  leads to the parent dir
  82.    | some dir ⇨ |  go right to get further down the tree or click to open
  83.    | some file  |  click to run/load somewhere
  84.    |   etc...   |
  85.  
  86.    If you're in the root directory ('dir name' = $ ), there's no parent and
  87.    so 'Up' leads to a 1-item submenu named 'FS::Disc' holding the name
  88.    of the Filing System and the name/number of the Disc the dir is 'on'.
  89.  
  90.    To get into an application directory, click SELECT/ADJUST over its menu
  91.    entry while holding down Shift. Clicks with ADJUST keep the menu alive
  92.    (of course)
  93.  
  94.    { in 2.0, you can use a 'long SELECT click': click on an 'application
  95.      item' with SELECT and hold the button down for a while. you MUST NOT
  96.      'long ADJUST click' upon a Filer- menu item; see 'Problems' below }
  97.  
  98. 2) Click ADJUST over any of the FS Filers (eg ADFS floppy, RAMFS).
  99.    You get a menu similar to the above for the root directory of the device.
  100.    The ResourceFS is an exception: here you get the $.Apps menu, just like
  101.    when you click SELECT over the Apps icon.
  102.  
  103. 3) To get the 3rd method to work 100% you most probably will need to do
  104.    some reconfiguration, as !Filer- as you've got it is configured to
  105.    run on my machine which is very likely to be different to yours.
  106.    Some things will work though so let's try it...
  107.  
  108.    Click MENU over the Pinboard. You'll get:
  109.  
  110.    +----------+
  111.    |  Filer-  |  menu title
  112.    +----------+
  113.    | Floppy ⇨ |  leads to ADFS::0.$
  114.    | HDrive ⇨ |           IDEFS::4.$
  115.    | RAM    ⇨ |           RAM:$
  116.    | ROM    ⇨ |           ResourceFS:$
  117.    | Memfis ⇨ |           MemFS:$
  118.    +----------+
  119.  
  120.    { in 2.0, you have sprites instead of text. the sprites are in Sprites
  121.      in the directory !Filer-.PinBrdMenu . see !Help in the same place }
  122.  
  123.    Now you see why it could fail to work properly on your system.
  124.  
  125.    If you haven't got a filing system from the above list and follow
  126.    the ⇨ in 'its' menu entry, the 'Filing system not present' error
  127.    will be generated which Filer- will trap and open a submenu with
  128.    a greyed out 'Not present' entry.
  129.  
  130.    This is curable by
  131.  
  132. Customising the pinboard menu
  133. =============================
  134.  
  135. !Filer- comes with 2 variants of the same module: Alt_No and Alt_Yes
  136. (in the !Filer-.PinBrdMenu directory. the module is titled
  137.  FiPiFi: FIler PInboard FIlter)
  138.  
  139. If Alt_No is being used you get Filer-'s 'pinboard (alias desktop) menu'
  140. when you click MENU over the Pinboard window.
  141.  
  142. If Alt_Yes is being used you get the menu when you click MENU over the
  143. Pinboard window AND are holding down the Alt key (either left or right).
  144.  
  145. You tell Filer- which one to use in !Filer-.!Run (see there, it's easy...)
  146.  
  147. To adapt the pinboard menu to your system involves hacking the source code
  148. a bit, but because of various important reasons i've already forgotten i
  149. decided to do it this way...
  150.  
  151. { no hacking needed in 2.0, read !Filer-.PinBrdMenu.!Help }
  152.  
  153. --
  154.  
  155. (1.1 only, but read it anyway)
  156.  
  157. The menu layout and the physical devices associated with the menu
  158. items are specified in two ¹ DATA lines at the start of !Filer-.!RunImage:
  159.  
  160. DATA pmi 1, pmi 2, ... , pmi N,
  161. DATA dev 1, dev 2, ... , dev N,
  162.  
  163. Remember that spaces BEFORE a , are prepended to a DATA string but spaces
  164. BEHIND a , are not : reading 'DATA a , b' yeilds the strings "a " and "b".
  165. This is important when specifying device names.
  166.  
  167. Both lists (must) end in the invisible (of course) empty string
  168. If you don't like invisible things put a "" after the final ,
  169.  
  170. • a pinboard menu item (1st DATA line) can be any string you like, except:
  171.   - it must not contain the full stop (.) character
  172.   - only the first 12 characters are 'significant'
  173.     ('' for it's a stupid word; but not all ''-words are)
  174.  
  175. • a device specification (2nd DATA line) is of the form
  176.  
  177.                 FilingSystemName:[:DriveNumber] or
  178.                 FilingSystemName:[:DriveName]
  179.  
  180.   (stuff in square brackets [] is optional)
  181.  
  182.   These are prepended to the $.etc part of an object's path name and
  183.   thus must follow the given format
  184.  
  185. Note: the code that builds the pinboard menu assumes it has at least one
  186. item in it. To get the exotic '< 1 item' case do not doubleclick over the
  187. !Filer- icon when you see it in a directory viewer window
  188.  
  189.  
  190. Examples
  191. --------
  192.  
  193. 1) You have one ADFS floppy (yeah) and one IDE hard drive called IDEDisc4
  194.    So you say:
  195.  
  196.    DATA Advanced FS, I Do Easy,
  197.    DATA ADFS:,       IDEFS::IDEDisc4,
  198.  
  199.    On a(n) (Alt)MENU Filer- pops up:
  200.  
  201.    +---------------+
  202.    |    Filer-     |
  203.    +---------------+  when you go right and click over, for instance
  204.    | Advanced FS ⇨ |  $.dir.file -> (a)
  205.    | I Do Easy   ⇨ |  $.dir      -> (b)
  206.    | ...         ⇨ |
  207.  
  208.    then Filer_Run ADFS:$.dir.file       (a)
  209.                   IDEFS::IDEDisc4.$.dir (b)
  210.  
  211.    will be executed.
  212.  
  213.    In (a), the filer looks for the object on the *Configure'd ADFS drive,
  214.    which is drive 0 on a 1 FD machine (at least on mine)
  215.  
  216.    Now imagine this scenario:
  217.    - you get a job (hey! congrats!)
  218.    - you add the second floppy to your system
  219.    - you *Configure drive 1
  220.    - but you still want: Advanced FS = ADFS::0
  221.  
  222.    See it? You must change ADFS: into ADFS::0 .
  223.    So, why not do it right right from the start? Specifying the drive number
  224.    (name when applicable) makes the existing menu 'constant' and any changes
  225.    are due to new items only - just add a new menu entry for drive 1:
  226.  
  227.    DATA old stuff, Rockefeller, old stuff,
  228.