The Datafile PD-CD 5

home *** CD-ROM | disk | FTP | other *** search

/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / s / suite / !Suite / !Help < prev next >

Wrap

Text File | 1995-02-07 | 14.1 KB | 293 lines

!Suite v 2.12 (06-Feb-1995) This program require RISC-OS 3.10 or greater to run. This program is Shareware. This means that you can copy this program to anyone you like, but if you find the program useful, you should register, as explained below. This entitles you to the latest version of this program, and of all my other applications. If you do copy the program it should be in its original format, with ALL of the accompanying files. That is : !Boot !Help !Run !RunImage !Sprites Code Defaults MakeCode Messages Sprites Templates and the following libraries : ARM3, AutoWarn, BasicEd, Bin, CacheSpr, Clock, LoseCaret, SetCSD, SetType, Speaker, VDU, and Volume. Purpose ------- A suite of utilities. To use ------ Firstly, you will need some icons on the icon bar. These are accessible from the icon bar menu. Click menu (the middle mouse button) on the !Suite icon, or on one of !Suite's icons that may already be created, and go across to the 'Show' sub-menu. Here, you can select which of Suite's icons you wish to have on the icon bar. Bin - Drag a file or directory (or group of files/directories) onto this icon. The file(s)/directory(ies) will then be deleted according to the options set in the options window. Options : Force deletion of locked objects Keep backup Only if same disc Confirm OK/Cancel icons or Mouse pointer Individual selection of deletion If the force option is set, all files will be deleted, including locked ones. If the 'keep backup' option is set, deleted files will be moved to a temporary directory inside !Suite. If there are files in this directory, the bin icon will change to a larger bin. To delete the files from this directory, click on the 'Empty bin' icon in the bin options window. The 'only if same disc' option means that only files deleted from the same disc as !Suite was run from will be stored. This allows files deleted from a hard disc to be retained temporarily, whilst files from floppies are deleted instantly, rather than having to move the data between discs. If the confirm option is set, when a file/directory is dragged onto the bin icon, a window will open, asking you to confirm that the file should be deleted. This can be done in two ways. Either, there will be an OK and a Cancel icon, which should be clicked to confirm or cancel the file deletion, or moving the mouse pointer into this new window will change the pointer to a confirmation pointer. Then click SELECT to confirm deletion, and MENU or ADJUST to cancel deletion. If confirmation is not set, it is impossible to change the state of the method of confirmation and individual selection. The individual selection of deletion will alter how more than one file is treated when in the bin list. If the option is set, each file will have to be confirmed separately. If the option is not set, OK will only need to be selected once, and all files will be deleted. Even if the bin is in the middle of a list of files and/or directories you can drag further files and/or directories onto the bin icon. This will add them to the end of the list, and will offer you the option to delete them when it gets round to that point of the list. The program will make use of the multi-tasking delete operation, as per the normal filer. (N.B. The bin WILL delete locked files if the option is set, and will also delete a directory if it is the Currently Selected Directory, by going up a directory. The CSD will ONLY be changed if the directory to be deleted is the CSD.) Set-Type - Drag a file or group of files onto this icon, and a window will open showing the filename, and asking you for the new type. Enter the type in the necessary icon, and press RETURN. This will *SetType the file accordingly. The filename in the window will then change if there is another file in the list, and you will be asked to enter the type as before. When there are no more files to set-type, the window will close. Bas-Edit - Drag a file onto this icon to load it into the BASIC Editor. If the option is set, then the CSD will be set to that of the file. Just click on the icon to enter the BASIC Editor with no file loaded and the CSD unchanged. VDU - Drag a file onto this icon to show it on screen. Press SHIFT to scroll through the text. Speaker - Click on this icon to toggle the internal speaker status. The sprite will change to reflect the status of the internal speaker, when you click on the icon, and will also change if the status is changed by another program, or by the CLI. CSD - Drag a file onto this icon to set the CSD to the directory containing that file. Drag a directory or application onto it, and the CSD will be set inside that directory. If the option is set, then a window will open telling you what the CSD has been set to. Sprites - Drag an application onto this icon to force the wimp to look at the !Sprites file inside it (if there is one), or drag a sprite file onto the icon to look at it. Please note : the filer window is not automatically updated, so the effects of using this option will not be immediately obvious. Click SELECT on the icon to open the icon-cacher choice window. Here it is possible to choose between *IconSprites and *ToolSprites, for any icon dragged onto the icon. If a *ToolSprites is performed, a request is made to the Wimp to redraw the whole screen, so the new tools are shown. Clock - Click on the icon to show the clock for a few seconds. The ability to do this is of use to anybody with an ARM2, and maybe an ARM250, where the constant screen updates of a normal clock can slow the computer down quite noticably. The length of time for which the clock is shown is set from the options window, as is the format. At this point in time four formats are available : hours and minutes (hh:mm); hours, minutes and seconds (hh:mm:ss); analogue without seconds (-s); analogue with seconds (+s). There is also the option to specify whether the clock should be on the left side of the icon bar, the right side of the icon bar, or in its own window, which can be moved around the screen to wherever you like. ARM Cache - Click on the icon to toggle the state of the cache on/off. The sprite will change to reflect the state of the cache, when you click on the icon, and will also change if the state is changed by another program, or by the CLI. (NB. State checking is not available on RiscPCs - somebody removed the code from RISC OS!!) Volume control - Click on the icon to open a window. This window has a red bar which can be dragged in order to alter the volume, and also two arrows, which can be clicked on to increase or decrease the sound volume. Clicking on the icon marked 'Test' makes a beep to allow you to judge how loud the volume is. Auto Warn - Click on the icon to open a window. Enter the minimum time (in seconds) of a pause that you wish to be alerted from. (ie. entering a time of 10 seconds would generate a beep if a task took up more than 10 seconds.) Click on the OK icon, or press RETURN, to update the warn time. Then, as long as the icon is on the icon bar, a beep is generated whenever a pause lasts longer than the time you entered in the window. NB. it is not worthwhile entering a time of 1 second as the program asks only to receive Wimp messages at one second intervals - ie. the slightest pause in Wimp polling would generate a warning beep. Lose Caret - Click on the icon to turn the caret off. This is useful if a program uses keyboard short-cuts, without having a window of its own. The application also supports interactive help. Finally, the program counts its errors and their time intervals. If it has to report five errors, each one being within two seconds of the previous one, then the program will kill itself (remove itself from memory, as opposed to anything more graphic!). This solves (hopefully!) the problems of an unbreakable error loop. Customisation ------------- Edit the line inside the !Run file inside the application to show what icons you which to appear on load up. i.e. Append to the Run <Suite$Dir>.!RunImage the suffixes which correspond to the icons - BIN - Bin icon SET - Set-Type icon BAS - BASIC Editor icon VDU - VDU icon SPE - Internal speaker icon CSD - Set CSD icon SPR - Icon Cacher CLK - Clock icon ARM - ARM3 Cache icon VOL - Volume control WRN - Auto Warn Alerter CRT - Lose Caret MEM - Free Memory A keyboard short-cut is also implemented, allowing you to remove an icon from screen quickly. To use this, simply press one Ctrl and one Shift key, and click on the icon to be removed. Also on the icon-bar menu is the 'Options' selection. This sub-menu offers control of how the program runs. The options are grouped according to the functions that they refer to. The options are : Bin : Force deletion of locked objects? Keep a backup of deleted files? Only if from the same disc as !Suite? Confirm deletion? Confirm with OK/Cancel icons, or with the mouse pointer? Delete groups of files one at a time, or as one? BASIC Ed : Set the CSD when loading a file into the BASIC Editor? SetCSD : Open a window showing the new CSD when it is set? Clock : Update time for how many seconds? Where? What format? Misc : Hi-res sprites? (For a multi-sync monitor) Force icons left? (Keeps icons to the left of other applications that install on the left side of the icon bar.) Save options as default. (The current state will be set every time !Suite is run. N.B. This saves only the options mentioned in this paragraph, and does not reflect the status of the icons shown on screen.) This version of !Suite uses a new library technique, which means that only the functions that you need have to be loaded. !LibraryMg is provided to control which libraries are loaded on start-up of !Suite. However, !LibraryMg works by changing the file-type of the libraries. As a result of this, !LibraryMg cannot work if the disc !Suite is on is write-protected. This also means that the libraries are still present on disc. If you are certain that you are never going to want these libraries, you can delete them. To do this, press and hold SHIFT, whilst double-clicking on the !Suite icon in the filer window. Now double click on the 'Libraries' directory, and here you will see all of !Suite's libraries. Now the unused libraries can be deleted in the normal way. (PLEASE only do this to your own BACKUP copy of the program, however, as !Suite should not be distributed with any of the libraries missing) Programmers info ---------------- This program responds to message type &4C49454E (that's NEIL in ASCII!) to alter what icons are shown on screen. So, to send the prog a message, use something like : DIM buff% 128 !buff%=100:buff%!4=0:buff%!8=0:buff%!12=0:buff%!16=&4C49454E buff%!20=icon:buff%!24=state SYS "Wimp_SendMessage",17,buff%,0 where icon is : 0 = Bin 1 = Set-Type 2 = BASIC Ed 3 = VDU 4 = Speaker 5 = Set CSD 6 = Icon cacher 7 = Clock 8 = ARM Cache 9 = Volume control 10 = Auto warn alerter 11 = Lose caret and state is : 0 = off 1 = on I cannot really think why anybody would want to use it, but I put it in on a whim, and it may be of use to you if you want to change the icons shown depending on who is using the computer. Bugs & Improvements ------------------- Please report any bugs found and any possible improvements you can think of at the address shown below. Registering ----------- To register, send £5 to me, at the address shown below, stating what version of which programs you have. You can enclose your own disk for the programs, and if you do so you can deduct 50p from the price. Registering entitles you to upgrade to later versions of the same programs and to get new programs for the price of £1. Any additional contributions from overseas towards postage would be greatly appreciated. Neil Walker. 16, Finderne Drive. Wymondham. Norfolk. NR18 0HU. Legal Notice ------------ This program is supplied 'as is'. I therefore cannot be held responsible for any loss of data, profits or any other loss, either directly or indirectly, that may be incurred by the use (or misuse) of this software, even if I am aware of the possibility of such a loss. However, I can assure you that in its original state, the program contains no deliberate viruses, or damaging procedures, except where these are necessary for the fulfilment of the program's function.