home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities2 / _suite / !Suite / !Help < prev    next >
Encoding:
Text File  |  1993-09-21  |  10.5 KB  |  221 lines
  1. !Suite
  2. v 1.41 (21st September 93)
  3. This program is Shareware. This means that you can copy this program to
  4.    anyone you like, but if you find the program useful, you should register,
  5.    as explained below. This entitles you to the latest version of this
  6.    program, and of all my other applications.
  7. If you do copy the program it should be in its original format, with ALL of
  8.    the accompanying files. That is : !Boot
  9.                                      !Help
  10.                                      !Run
  11.                                      !RunImage
  12.                                      !Sprites
  13.                                      Code
  14.                                      Defaults
  15.                                      MakeCode
  16.                                      Messages
  17.                                      Sprites
  18.                                      Templates
  19.  
  20.  
  21. Purpose
  22. -------
  23. A suite of utilities.
  24.  
  25.  
  26. To use
  27. ------
  28. Bin - Drag a file or directory (or group of files/directories) onto this
  29. icon, and a window will open asking you if you are sure you wish to delete
  30. that file/directory. If you have got the option set to confirm deletion by
  31. the OK and Cancel icons, click on the OK icon if you are sure, else click on
  32. the Cancel icon. If the confirmation is to be done by mouse then move the
  33. mouse pointer onto the window as before, and the pointer will change. Click
  34. SELECT to delete the file, and ADJUST to leave the file. If more than
  35. one file/directory has been dragged onto the bin icon, the contents of the
  36. icon will change, and you must again select whether or not to delete that
  37. file/directory, unless the option is set not to give individual selection of
  38. deletion, in which case the window will show the pathname plus a "*", e.g.
  39. "adfs::MyDisc.$.Directory.*", and the prompt will ask if you wish to delete
  40. that selection. Therefore, you will only need to click on the OK icon once,
  41. or select 'YES' with the mouse once. This will then delete all files held in
  42. the list. (BE CAREFUL!!) Even if the bin is in the middle of a list of files
  43. and/or directories you can drag further files and/or directories onto the
  44. bin icon. This will add them to the end of the list, and will offer you the
  45. option to delete them when it gets round to that point of the list. Users
  46. of RISC-OS 3.10 and greater will benefit from a multi-tasking delete
  47. operation, as per the normal filer. (N.B. The bin WILL delete locked files
  48. if the option is set, and will also delete a directory if it is the
  49. Currently Selected Directory, by going up a directory. The CSD will ONLY be
  50. changed if the directory to be deleted is the CSD.)
  51.  
  52. Set-Type - Drag a file or group of files onto this icon, and a window will
  53. open showing the filename, and asking you for the new type. Enter the type
  54. in the necessary icon, and press RETURN. This will *SetType the file
  55. accordingly. The filename in the window will then change if there is
  56. another file in the list, and you will be asked to enter the type as before.
  57. When there are no more files to set-type, the window will close.
  58.  
  59. Bas-Edit - Drag a file onto this icon to load it into the BASIC Editor. If
  60. the option is set, then the CSD will be set to that of the file. Just click
  61. on the icon to enter the BASIC Editor with no file loaded and the CSD
  62. unchanged.
  63.  
  64. VDU - Drag a file onto this icon to show it on screen. Press SHIFT to scroll
  65. through the text.
  66.  
  67. Speaker - Click on this icon to toggle the internal speaker status. The
  68. sprite will change to reflect the status of the internal speaker, when
  69. you click on the icon, and will also change if the status is changed by
  70. another program, or by the CLI.
  71.  
  72. CSD - Drag a file onto this icon to set the CSD to the directory containing
  73. that file. Drag a directory or application onto it, and the CSD will be set
  74. inside that directory. If the option is set, then a window will open telling
  75. you what the CSD has been set to.
  76.  
  77. Sprites - Drag an application onto this icon to force the wimp to look at
  78. the !Sprites file inside it (if there is one). Please note : I do not force
  79. the filer window to be updated, so the effects of using this option will not
  80. be immediately obvious.
  81.  
  82. Clock - Click on the icon to show the clock for a few seconds. The ability
  83. to do this is of use to anybody with an ARM2, and maybe an ARM250, where
  84. the constant screen updates of a normal clock can slow the computer down
  85. quite noticably. The length of time for which the clock is shown is set
  86. from the options window, as is the format. At this point in time only two
  87. formats are available : hours and minutes (hh:mm) and hours, minutes and
  88. seconds (hh:mm:ss). There is also the option to specify whether the clock
  89. should be on the left side of the icon bar, the right side of the icon bar,
  90. or in its own window, which can be moved around the screen to wherever you
  91. like.
  92.  
  93. ARM3 Cache - Click on the icon to toggle the state of the cache on/off. The
  94. sprite will change to reflect the state of the cache, when you click on the
  95. icon, and will also change if the state is changed by another program, or
  96. by the CLI. (N.B. This option is only available (I think!) to owners of
  97. ARM3 & RISC OS3 machines.)
  98.  
  99. The application also supports interactive help.
  100.  
  101.  
  102. Customisation
  103. -------------
  104. Edit the line inside the !Run file inside the application to show what icons
  105. you which to appear on load up. i.e. Append to the Run <Suite$Dir>.!RunImage
  106. the suffixes which correspond to the icons - BIN - Bin icon
  107.                                              SET - Set-Type icon
  108.                                              BAS - BASIC Editor icon
  109.                                              VDU - VDU icon
  110.                                              SPE - Internal speaker icon
  111.                                              CSD - Set CSD icon
  112.                                              SPR - Icon Cacher
  113.                                              CLK - Clock icon
  114.                                              ARM - ARM3 Cache icon
  115.  
  116. Also, whilst the program is running, clicking menu on any of the icons will
  117. show a menu containing 'Info', 'Show', 'Options' and 'Quit. Going to the
  118. 'Show' sub-menu allows you to alter which icons are shown.
  119.  
  120. Also on the same menu is the 'Options' selection. Going to this sub-menu
  121. allows you to select whether : you wish to force the deletion of locked
  122.                                   objects when using the bin,
  123.                                you wish to set the CSD when loading a file
  124.                                   into the BASIC Editor,
  125.                                you wish to confirm deletion of a file by the
  126.                                   OK and Cancel icons, or by clicking SELECT
  127.                                   or ADJUST after moving the mouse
  128.                                   onto the bin window,
  129.                                you wish to have individual selection of
  130.                                   deletion, or whether you wish to delete
  131.                                   all files dragged to the bin at once,
  132.                                you wish the program to open the window
  133.                                   showing you what the CSD has been set to,
  134.                                you wish the program to check the speaker
  135.                                   status regularly, to test if it has been
  136.                                   changed by another program.
  137.                                you wish the program to use small icons on
  138.                                   the icon bar. (This uses less space on the
  139.                                   bar, but means you have to be more precise
  140.                                   with the mouse, and makes the icons harder
  141.                                   to see.)
  142.                                you wish the clock (when shown) to be on the
  143.                                   left icon bar, on the right icon bar, or
  144.                                   in its own window,
  145.                                you wish the program to check the ARM3 cache
  146.                                   status regularly, to test if it has been
  147.                                   changed by another program. (This will be
  148.                                   greyed if the computer is not fitted with
  149.                                   RISC OS3 and/or an ARM3)
  150.                     and also : how long you wish the clock to be updated
  151.                                   for (1 - 9 seconds),
  152.                                the desired format of the clock. (hh:mm:ss,
  153.                                   or hh:mm)
  154.  
  155. There is also the possibility to save the current option status as the
  156. default, and will be loaded on start-up. (N.B. This saves only the options
  157. mentioned in this paragraph, and does not reflect the status of the icons
  158. shown on screen.)
  159.  
  160.  
  161. Programmers info
  162. ----------------
  163. This program responds to message type &4C49454E (that's NEIL in ASCII!) to
  164. alter what icons are shown on screen. So, to send the prog a message, use
  165. something like :
  166.    DIM buff% 128
  167.    !buff%=100:buff%!4=0:buff%!8=0:buff%!12=0:buff%!16=&4C49454E
  168.    buff%!20=icon:buff%!24=state
  169.    SYS "Wimp_SendMessage",17,buff%,0
  170.  
  171. where icon is : 0 = Bin
  172.                 1 = Set-Type
  173.                 2 = BASIC Ed
  174.                 3 = VDU
  175.                 4 = Speaker
  176.                 5 = Set CSD
  177.                 6 = Icon cacher
  178.                 7 = Clock
  179.                 8 = ARM3 Cache
  180.  
  181. and state is :  0 = off
  182.                 1 = on
  183.  
  184. I cannot really think why anybody would want to use it, but I put it in on
  185. a whim, and it may be of use to you if you want to change the icons shown
  186. depending on who is using the computer.
  187.  
  188.  
  189. Bugs & Improvements
  190. -------------------
  191. Please report any bugs found and any possible improvements you can think of
  192. at the address shown below.
  193.  
  194.  
  195. Registering
  196. -----------
  197. To register, send £5 to me, at the address shown below, stating what version
  198. of which programs you have. You can enclose your own disk for the programs,
  199. and if you do so you can deduct 50p from the price. Registering entitles you
  200. to upgrade to later versions of the same programs and to get new programs
  201. for the price of £1. Any additional contributions from overseas towards
  202. postage would be greatly appreciated.
  203.  
  204.  
  205. Neil Walker.
  206. 16, Finderne Drive.
  207. Wymondham.
  208. Norfolk.
  209. NR18 0HU.
  210.  
  211.  
  212. Legal Notice
  213. ------------
  214. This program is supplied 'as is'. I therefore cannot be held responsible
  215. for any loss of data, profits or any other loss, either directly or
  216. indirectly, that may be incurred by the use (or misuse) of this software,
  217. even if I am aware of the possibility of such a loss. However, I can assure
  218. you that in its original state, the program contains no deliberate viruses,
  219. or damaging procedures, except where these are necessary for the fulfilment
  220. of the program's function.
  221.