home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / icondir / !IconDir / Documents / ReadMe < prev   
Encoding:
Text File  |  1994-05-15  |  9.7 KB  |  295 lines

  1. IconDir 1.02 (15-May-1994)
  2. ==========================
  3.  
  4. (c) James Ponder (Jp) of DoggySoft, 1994
  5.  
  6.  
  7. This program is Public Domain; this means you can copy it around as much as
  8. you like as long as you include all the files and you don't alter any of
  9. them.
  10.  
  11.  
  12. NB: Sprites on menu structures do not work under development RISC OS 3.22n,
  13. please enable the option for no sprites (unknown if sprites work on
  14. RISC OS 3.5).
  15.  
  16.  
  17.  
  18. Introduction
  19. ============
  20.  
  21. IconDir was written because I was fed up with Menon, IconDir has (in my
  22. opinion) the following main advantages:
  23.  
  24.   a) You do not need to design your menus very much.
  25.   b) When you have new files, you do not have to update it.
  26.   c) You have little sprites on the menu structure (best feature!)
  27.   d) You can drag and drop the icons off the menu.
  28.  
  29. The idea behind IconDir is that it will create a menu structure just like you
  30. have on your disc.   You are able to specify the directory to start in, but
  31. everything else is searched for on the disc.
  32.  
  33.  
  34.  
  35. Setting up your copy
  36. ====================
  37.  
  38. To bring up the configuration window, you must click with select or adjust on
  39. the icon bar.
  40.  
  41. If you do not like the sprites on the menus you have the option to select
  42. "Do not use sprites on menu structure", this will have no effect other than
  43. to tell IconDir that all menus must not have sprites in them.
  44.  
  45. There is also the option to not create submenus past the application stage,
  46. this is quite useful as you may get annoyed at all the submenus that are
  47. around for you to accidentaly move over, also it makes the menu clearer.
  48.  
  49. Then you have to choose how many items to be available on the main menu,
  50. a maximum of 12.   For each item, a name and a pathname must be specified,
  51. the name will appear on the menu and the pathname will be used to find the
  52. files to create the menus.
  53.  
  54. Typical entries are:
  55.  
  56. Utilities         adfs::IDEDisc4.$.Utilities
  57. Applics           adfs::IDEDisc4.$.Applics
  58. Games             CFS#adfs::IDEDisc4.$.Games
  59. Music             CFS#adfs::IDEDisc4.$.Music
  60.  
  61. you can also use 'special' characters:
  62.  
  63. Library           %
  64. Root              $
  65. CSD               @
  66.  
  67. and sometimes it can be useful to use different drives:
  68.  
  69. HardDisc          adfs::4.$ or adfs::IDEDisc4.$
  70. Floppy            adfs::0.$
  71. Resources         Resources:$
  72. RAM               RAM:$
  73.  
  74.  
  75. You may drag a file, directory or application to the writeable icons in order
  76. to quickly insert the pathname (files will have their leafnames stripped
  77. obviously).
  78.  
  79.  
  80. You may also select whether you want a beep to be emitted when you use the
  81. hotkey to change directory (SHIFT-TAB).
  82.  
  83. Kickstarting may also be halted so that the options setup in the 'HotKeys'
  84. file will be ignored.
  85.  
  86.  
  87.  
  88. Mode
  89. ====
  90.  
  91. There are 3 different modes:
  92.  
  93.   a) Select files, open directories.
  94.   b) Delete files, remove entire directories.
  95.   c) SetType files, open directories.
  96.  
  97. In select mode, files are loaded, directories are opened and applications are
  98. loaded unless shift is held down in which they are opened like directories.
  99.  
  100. In delete mode, files, applications and directories are deleted (recursively)
  101. except that you will be given a short warning to make sure you want to
  102. proceed.
  103.  
  104. In settype mode, files are settyped to the specified filetype, and
  105. applications/directories are opened.
  106.  
  107.  
  108.  
  109. Icons
  110. =====
  111.  
  112. Icons on menus are only normally available on RiscOS 3, but thanks to a patch
  113. module included with this program, icons on menus are available to all.
  114.  
  115. Icons are chosen exactly as if they would appear in the normal filer windows.
  116. Firstly the smaller icon is checked for, if that doesn't exist then the large
  117. icon is checked for and if that exists the sprite is displayed at half size. If both sprites are missing then the default sprite is used (a blank sprite
  118. for files, an 'app' symbol for applications).
  119.  
  120.  
  121.  
  122. Dragging off the menu
  123. =====================
  124.  
  125. If you select a menu item with the menu button then IconDir will initiate a
  126. drag.  If you drag the item to a directory display then the file will be
  127. copied, if you drag the item to an application the file will be loaded.
  128.  
  129.  
  130.  
  131. Setting the CSD
  132. ===============
  133.  
  134. To set the current directory, hold down CTRL and TAB together whilst you have
  135. the mouse pointer over the directory you would like to change to.
  136.  
  137. Note: The current owner of the caret might claim this key, and hence IconDir
  138. won't be able to set the directory, eg. StrongEd uses CTRL-TAB to mean change
  139. tab type.
  140.  
  141.  
  142.  
  143. Hotkeys
  144. =======
  145.  
  146. A hotkey is a key or key-combination that activates something, in IconDir you
  147. may setup as many hotkeys as you like and they can be activated by holding
  148. down CTRL and the corresponding letter.  For example I have got StrongEd
  149. to load up when I hold down CTRL and E, I use the letter E for StrongEd as
  150. I have Spark on the letter S and obviously you can't have two applications
  151. loading on the same keypress as it would be very silly.
  152.  
  153. * Now follows how to set out the HotKeys file, you do not need to read this
  154. * as IconDir now has a hotkey management program which can be activated from
  155. * the misc menu on IconDir.
  156.  
  157. Within the IconDir directory is a file called 'HotKeys' and this is the file
  158. that decides which hotkeys you have setup.   The format of the file is very
  159. straight forward, firstly you have the filename or directory name of the file
  160. or directory you would like to load or open.   Secondly you have the hotkey
  161. letter that you would like to designate to doing that action, for example:
  162.  
  163.    adfs::IDEDisc4.$.Applics.!StrongED2                E
  164.  
  165. This means that when you hold down CTRL and E it will startup StrongEd.   You
  166. are allowed as many spaces before the filename, before the hotkey and after
  167. the hotkey as you like.
  168.  
  169. You may also have comments in your 'HotKeys' file, these start with the '|'
  170. character.  For example:
  171.  
  172. |  This is my HotKeys file, anybody who alters it will die...
  173.  
  174. A 'HotKeys' file MUST be terminated with the 'END' line:
  175.  
  176. |  Comment
  177.    <filename> [<hotkey>] [<*>]
  178.    <filename> [<hotkey>] [<*>]
  179.    <filename> [<hotkey>] [<*>]
  180.    ....
  181. END
  182.  
  183. Anything after the END statement is ignored, if the END is missing then it
  184. will probably crash.  (The END must be on it's own seperate line)
  185.  
  186. For details on the "[<*>]" then please see 'Kickstarting applications'.
  187.  
  188. Hotkeys will appear on the menus to remind you that there is a shortcut
  189. defined (they will appear as ^<letter>), remember that if you don't have a
  190. menu containing the file you have specified for a shortcut then it will still
  191. work (assuming the file exists) although you will never see the reminder.
  192.  
  193. Hotkey reminders (eg. ^E) will not appear on the main menu, but you may have
  194. hotkeys activated on the main menu items.
  195.  
  196.  
  197.  
  198. The Hotkeys application
  199. =======================
  200.  
  201. The Hotkeys application was written by Graham Crow to support IconDir.  It
  202. greatly simplifies the job of assigning hotkeys so that IconDir files may
  203. be created without having to edit the raw textfile.  This application also
  204. allows you to determine whether objects should be kickstarted or not.
  205.  
  206. After you have saved your hotkey file, you must reload IconDir.
  207.  
  208.  
  209.  
  210. Kickstarting applications
  211. =========================
  212.  
  213. After each entry in the hotkeys file you may also specify whether the program
  214. is to be automatically loaded when IconDir is first loaded.
  215.  
  216. This is very useful as an alternative to a boot file, just !IconDir has to be
  217. loaded.
  218.  
  219. To make an application run automatically (or indeed, open a a directory or
  220. run a file) then you do not need to make the application have a hotkey.
  221.  
  222. For example, you could have the following line in your 'HotKeys' file:
  223.  
  224.    adfs::IDEDisc4.$.Applics.!StrongED2                E  *
  225.  
  226. but you may not want StrongEd2 to have a hotkey, so you would have the line:
  227.  
  228.    adfs::IDEDisc4.$.Applics.!StrongED2                   *
  229.  
  230. As you can see, either option is optional.
  231.  
  232.  
  233.  
  234. Recall
  235. ======
  236.  
  237. Recall is a small utility which offers a quick way of reopening recently
  238. opened directories.
  239.  
  240. From when IconDir is loaded, whenever you open a directory, its name is
  241. added to the 'Recall' menu.   Selecting the name of a directory from the
  242. recall menu will open that directory.
  243.  
  244. If you open more than 8 directories then the directories that opened the
  245. longest time ago are removed from the menu.   The menu is always in order
  246. of when they were opened, the first at the top, the last at the bottom.
  247.  
  248. Selecting 'Recall' itself will have the effect of clearing the menu.
  249.  
  250.  
  251.  
  252. Impressed?
  253. ==========
  254.  
  255. If this was a shareware program this is where I would ask you to send some
  256. money to me, but since it isn't - if you are pleased and don't know how you
  257. could have survived without IconDir then why not write to me and tell me,
  258. including any suggestions for new features or just to say 'Hi'!
  259.  
  260.  
  261.  
  262. Other programs by me
  263. ====================
  264.  
  265. Cookies is a cookie randomiser for your desktop boot files, stick it in and
  266. it will give you a humourous quote or saying everytime you turn your computer
  267. on!
  268.  
  269. Palette is a replacement PaletteUtil, Palette provides a user-editable mode
  270. menu, as well as hotkeys to change modes and many many many more features.
  271.  
  272. NodeList is a BBS nodelist viewer so that you can search for boards in your
  273. area or compile a BB list.
  274.  
  275.  
  276. I hope you have copies of our commercial programs... (and I hope you paid!)
  277.  
  278.  
  279.  
  280. Contacts
  281. ========
  282.  
  283. If you have any suggestions, or you have found a bug, or even if you just
  284. want to tell me how great you think this program is, ring or write to the
  285. address in the textfile 'DoggySftCt'.
  286.  
  287. If you are a PD Company or a magazine then DoggySoft would be happy to
  288. supply copies of all our latest PD programs.
  289.  
  290. *****************************************************************************
  291. Do not forget to call the DoggySoft support BBS 'Furzefield Hq', 24hrs on
  292. (0494) 681711 for the latest versions of all our Public Domain and Commercial
  293. programs.  The FidoNet address is 2:252/166 if you wish to NetMail us.
  294. *****************************************************************************
  295.