home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !FALCON / !BONUS / UTILITY / STOP104A.ZIP / STOOP.TXT < prev   
Text File  |  1995-04-02  |  43KB  |  1,069 lines
  1.                 STOOP Manual
  2.                 Version 1.04
  3.  
  4.  
  5. Hardware required
  6.  
  7. Atari Falcon with 4Mb RAM and a VGA or SVGA display is recommended (the 
  8. screen resolution needed for Stoop is a minimum 640 x 480 by 16 colours).
  9.  
  10. Contents
  11.     Introduction
  12.     Getting Started
  13.     Setting Up Stoop
  14.         Boards
  15.             Editing a Board
  16.             Changing Boards
  17.             Deleting a board
  18.             Using Font Folders With NVDI 3
  19.         Buttons
  20.             Setting Up A Button
  21.             Showing A Button's Configuration
  22.             Deleting a Button
  23.             Merging & Removing Files from Buttons
  24.             Copying Buttons
  25.             Swapping Buttons
  26.             Using a Button
  27.         Passing Parameters to Auto-Booting Programs
  28.             Setting Up Stoop for Passing Parameters
  29.             Text Window Keyboard Commands
  30.             Environment Options
  31.             Problems With Passing Parameters
  32.         Groups
  33.             Using a Group
  34.             Deleting a Group
  35.     The File Selector
  36.         Copying Folders & Files
  37.         Moving Folders & Files
  38.         Deleting Folders & Files
  39.         Renaming Folders & Files
  40.         Creating Folders
  41.         Re-Ordering the AUTO Folder
  42.         Hiding Files from Stoop
  43.     Main Controls
  44.         GO & EXIT
  45.         Auto-Booting Programs
  46.     Option Controls
  47.         FSEL
  48.         DELETE
  49.         SAVE
  50.         CLEAR
  51.         CONFIG
  52.             SYSTEM Dialogue
  53.             START UP Dialogue
  54.             COLOURS Dialogue
  55.     Manual Start Up Configurations
  56.     
  57.  
  58. Introduction
  59.  
  60. Stoop is a boot manager for the Atari Falcon. It has its own graphical 
  61. interface and uses the mouse for most operations though it does make some 
  62. use of the keyboard.
  63. Stoop can :
  64. ≡    Be used to determine which AUTO programs, accessories, CPX modules and 
  65.     NEWDESK.INF files should be active when starting up or re-booting. 
  66. ≡    Control other types of file (e.g. GDOS ASSIGN.SYS files) to a maximum 
  67.     of 20 different types.
  68. ≡    Display up to 512 file names in each of 20 boards. These boards have 
  69.     to be paged to view all of the file names, but paging buttons will 
  70.     only appear when they are necessary.
  71. ≡    Either change the extension of a file name to make it active/inactive, 
  72.     e.g. ACX is changed to ACC and vice versa, (the file may be also moved 
  73.     to another folder at the same time) this can be done for a maximum of 
  74.     254 files per file type. Or a single file can copied and renamed to a 
  75.     specific name, e.g. C:\AUTO\STOOP\GENERAL.INF may become NEWDESK.INF.
  76. ≡    Make groups of files which may be selected or de-selected by a single 
  77.     button press, to a maximum of 50 files per board per group, and since 
  78.     there is a maximum of 20 boards a maximum of 1000 files can be 
  79.     assigned per group.
  80. ≡    Control the screen resolution of the desktop that appears after 
  81.     booting, including starting up in ST compatible screens, without 
  82.     having to use a specific NEWDESK.INF file.
  83. ≡    Change the application the desktop runs after boot-up.
  84. ≡    Store often used start-up configurations on buttons, to a maximum of 
  85.     27.
  86. ≡    Copy, delete and move folders and files, and also rename files, using 
  87.     its own file selector.
  88. ≡    Re-order the contents of the AUTO folder.
  89. ≡    Hide files from itself so that they cannot be selected/de-selected for 
  90.     boot-up by error. Up to 50 files can be hidden.
  91. ≡    Be easily configured while running from the AUTO folder.
  92. ≡    Pass parameters to applications that are to be auto-booted.
  93.  
  94. New in version 1.04
  95.  
  96. ≡    Be booted in any resolution on a RGB or VGA monitor.
  97. ≡    Display folders instead of files in a board, this is primarily for 
  98.     moving folders of fonts in and out of NVDI 3's font directories, which 
  99.     means that you can choose which fonts to use at boot up.
  100. ≡    Protect your system with a password.
  101. ≡    Now wait for a set period and then, if not used, it will set up a 
  102.     default configuration and exit.
  103. ≡    Swap preset buttons around.
  104. ≡    Show an unlimited number of files and folders in the fileselector in a 
  105.     single directory, it is now only limited by available memory.
  106. ≡    Merge and remove file names with/from preset configurations.
  107. ≡    Change the speaker volume and balance.
  108. ≡    Turn off the keyclick and the system bell sounds.
  109. ≡    Change the colours used by Stoop.
  110. ≡    Select an auto-booting program for a one-off configuration more 
  111.     easily.
  112.  
  113.  
  114.                 Getting Started
  115.  
  116. Installing Stoop
  117.  
  118. Run the INSTALL program, make sure that the STOOP and LAUNCH program 
  119. files are in the same directory as INSTALL before starting.
  120. INSTALL will modify any STOOP.CFG it finds, backup this file first (e.g. 
  121. copy it to another directory) and it will place STOOP at the start of the 
  122. AUTO folder or copy it into the same position as the earlier version of 
  123. Stoop if you have one.
  124.  
  125. When running at boot up, Stoop has a problem with NVDI. Please make sure 
  126. that the STOOP program runs before NVDI.
  127.  
  128.  
  129.                Setting Up Stoop
  130.  
  131. To start up Stoop after installation, you can either re-boot or run it 
  132. from the Desktop.
  133.  
  134. When you have started Stoop up you should see a screen divided into three 
  135. main areas; the largest area is the boards where all of the files will be 
  136. displayed, to the right of it is the control panel containing various 
  137. buttons with a board labelled GROUPS and at the bottom of the screen are 
  138. 27 buttons which can be used to store preset start up configurations.
  139.  
  140.  
  141.                 Boards
  142.  
  143. The first step should be to arrange the boards to display the required 
  144. files. Each board shows the files which match one of two extensions (e.g. 
  145. PRG and PRX) that exist in one folder or root directory.
  146. There are 5 boards which you can re-configure, each one can have 4 
  147. different faces. Each board can be displayed as either one long board or 
  148. two short ones.   
  149.  
  150. When you first run Stoop there may not be a STOOP.CFG file present which 
  151. contains the configuration information for Stoop, hence Stoop will use 
  152. it's default configuration. The first two boards should show the program 
  153. files in the AUTO folder and the accessories on the root directory of 
  154. your boot drive.
  155.  
  156. These boards may be altered to show different types of file (different 
  157. file extensions) and/or the files in different folders or drives.
  158. To alter a board, click on the BOARD button (right hand side of screen) 
  159. and then click on the board you want to change. A dialogue should pop up 
  160. which displays the current details of that particular board:-
  161.  
  162. TITLE
  163. The name of the board which is to be displayed just above the top of the 
  164. board.
  165.  
  166. SOURCE PATH
  167. The folder or drive which will hold the files or folders to be shown on 
  168. the board.
  169.  
  170. DESTINATION PATH
  171. The folder or drive which the file or files or folders will be copied to 
  172. (this MUST be given even if it is the same as the SOURCE PATH). If 
  173. folders are to be displayed on the board, the destination path MUST be 
  174. (i) different to the source path and (ii) outside of the source 
  175. directory, i.e. it must NOT be in the source directory OR be a 
  176. subdirectory of the source directory.
  177.  
  178. DESTINATION FILE
  179. The name that will be given to a single file once it has been copied. If 
  180. this box contains any text then only one file may be selected on the 
  181. board at any one time, otherwise any number (zero to all) of files can be 
  182. selected. If the board is set to use folders, this will be empty.
  183.  
  184. LIVE & DEAD EXTS
  185. These are the file extensions of the files that will be shown on the 
  186. board. The 'live' extension is the one that active files have (e.g. PRG 
  187. or ACC) while the 'dead' extension is the one that inactive files will be 
  188. given which usually terminates with an 'X' (e.g. PRX or ACX). If the 
  189. board is set to use folders, these sections will be empty.
  190.  
  191. FILES/FOLDERS button
  192. This button will toggle between FILES and FOLDERS. When FILES is 
  193. displayed, the board will show a list of files from the source directory 
  194. and when FOLDERS is shown, the board will show a list of the folders from 
  195. the source directory. The folders in BOTH of the paths (source and 
  196. destination) will be displayed on the board, the names of folders in the 
  197. source will be highlighted to show that they are active, and the names of 
  198. folders in the destination will NOT be selected. Any folders that are 
  199. highlighted on the board will be moved to the source directory when Stoop 
  200. sets up the configuration, and any folders that are not highlighted are 
  201. moved to the destination directory.
  202.  
  203. SHORT/LONG button
  204. This button will toggle between showing SHORT and LONG on it's surface. 
  205. When it shows LONG, one long board will appear at the chosen position and 
  206. it will display up to 34 file names, and when it shows SHORT there will 
  207. be 2 short boards displayed showing up to 16 file names each.
  208.  
  209. OK and CANCEL
  210. These have their usual meanings, they both let the user quit the dialogue 
  211. but OK confirms any changes and CANCEL ignores them.   
  212. Most of the above is straight forward, but the use of the DESTINATION 
  213. FILE needs explaining. Some programs use INF (or similar) files to hold 
  214. data about the program's start up settings, e.g. the Desktop is one such 
  215. program and it uses NEWDESK.INF. If you want to start up these programs 
  216. with different settings, depending upon your needs, the INF file has to 
  217. be replaced with another version. For Stoop to do this automatically for 
  218. you it needs the name of the INF file, this is what DESTINATION FILE 
  219. should hold. 
  220.  
  221. Example #1.
  222.  
  223. Suppose the dialogue holds the following data :-
  224.     TITLE            = NEWDESK
  225.     SOURCE PATH        = C:\AUTO\STOOP 
  226.     DESTINATION PATH    = C:\
  227.     DESTINATION FILE    = NEWDESK.INF
  228.     LIVE EXT        = INF
  229.     DEAD EXT        = INX
  230.     first button        = FILES
  231.     second button        = SHORT
  232.  
  233. This allows a user to have different set-ups for the Desktop. Any files 
  234. contained in C:\AUTO\STOOP (but not any folders within it) that have INF 
  235. or INX extensions will be displayed upon the board, INF files will be 
  236. highlighted and INX files will not.
  237.  
  238. The SHORT button means that two short boards will be shown in the chosen 
  239. column, the other board may appear above or below the board you are 
  240. setting up.
  241.  
  242. Suppose that the folder C:\AUTO\STOOP contains these three files:-
  243.     GENERAL.INX
  244.     DTP.INX
  245.     SBLASTER.INF
  246.  
  247. Their names will appear on the board without their extensions, only 
  248. SBLASTER is highlighted as it's extension is 'live' (it has INF for it's 
  249. extension).
  250.  
  251. Selecting GENERAL on the board will highlight it and un-highlight 
  252. SBLASTER. Clicking on the GO button will cause GENERAL.INF to be copied 
  253. to drive C and named NEWDESK.INF (the previous NEWDESK file is first 
  254. deleted).
  255.  
  256. Example #2.
  257.  
  258. Suppose the boxes hold the following data :-
  259.     TITLE            = ACCESSORIES
  260.     SOURCE PATH        = C:\ 
  261.     DESTINATION PATH    = C:\
  262.     DESTINATION FILE    =
  263.     LIVE EXT        = ACC
  264.     DEAD EXT        = ACX
  265.     first button        = FILES
  266.     second button        = LONG
  267.     
  268. This allows a user to change the accessories loaded at boot up. Note that 
  269. DESTINATION FILE should contain no text.
  270.  
  271. With this information, Stoop will show all the files in the root 
  272. directory of drive C which have either ACC or ACX extensions on the 
  273. board. Files with 'live' extenders (ACC) will be highlighted while files 
  274. with 'dead' extensions will not. Clicking on a 'dead' file will make it 
  275. live without changing the status of any other file and clicking on a 
  276. 'live' file will make it 'dead'. 
  277.  
  278. Clicking on GO will cause all files to be renamed according to their 
  279. status on the board, highlighted names become 'live' (they are given the 
  280. ACC extension) and all of the others are 'killed' (given ACX extenders).
  281. Note that although TOS 4 only allows a maximum of 6 accessories to be 
  282. loaded at any one time, Stoop will not stop you from selecting more than 
  283. 6 accessories.
  284.  
  285. If the SOURCE and DESTINATION PATH's were different in the above example, 
  286. the files would be re-named and they would be copied to the DESTINATION 
  287. PATH, but please note that any existing files in the DESTINATION PATH 
  288. would be unaffected. Hence avoid using different SOURCE and DESTINATION 
  289. PATH's when multiple files are to be made 'live' (i.e. DESTINATION FILE 
  290. is undefined) as any files copied there by Stoop during a previous boot 
  291. up will still be there.
  292.  
  293. The FILES button means that the board will only display the names of 
  294. folders.
  295.  
  296. The LONG button means that one long board will be shown in the chosen 
  297. column.
  298.  
  299.  
  300. Editing A Board
  301.  
  302. Now that you now what the boards can do, how do you change them to do 
  303. what you want?
  304.  
  305. There are basically two types of boxes which contain text on this 
  306. dialogue, 
  307.  
  308. (i)    Boxes which can be edited manually by placing the cursor in it and 
  309. adding characters from the keyboard.
  310.  
  311. (ii)    Boxes which you click on and this brings up the file selector. This 
  312. type is used to hold file paths and names which are selected via the 
  313. file selector.
  314.  
  315. TITLE
  316. If the text cursor is not in the Title box you can (i) click the mouse on 
  317. it, (ii) press TAB or (iii) press the up or down arrow keys to move it 
  318. into the box. You can then type the new name, BACKSPACE will delete back 
  319. one character and ESC will clear all of the text. Do not press RETURN or 
  320. ENTER unless you want to exit the dialogue and confirm the changes (this 
  321. is equivalent to clicking on the OK button).
  322.  
  323. SOURCE PATH
  324. Click the mouse on the text area of this box, the file selector will 
  325. appear and you can choose the path you require.
  326.  
  327. DESTINATION PATH
  328. Use the same procedure as for the SOURCE PATH.
  329.  
  330. DESTINATION FILE
  331. Use the same procedure for the Title text box.
  332.  
  333. LIVE EXT
  334. Use the same procedure for the Title text box.
  335.  
  336. DEAD EXT
  337. Use the same procedure for the Title text box.
  338.  
  339. FILES/FOLDERS
  340. Click on this to toggle it's setting.
  341.  
  342. SHORT/LONG
  343. Click on this to toggle it's setting.
  344.  
  345.  
  346. Changing Boards
  347.  
  348. There are 20 boards, but only five to ten can be shown at any one time, 
  349. to show the others click anywhere on the board with your RIGHT mouse 
  350. button, this will cycle through the boards for that position.
  351. Each column has four boards. If the board in a column is a long board the 
  352. other three are hidden below it and 3 clicks will top each of these 
  353. boards in turn, a fourth click will show the first board again. If the 
  354. column has two short boards, then 2 of the four boards are already in 
  355. view and each of the short boards has only one other board under it, 
  356. hence 1 click on a short board will top the board underneath and another 
  357. click will then return to the initial board.  
  358.  
  359.  
  360. Deleting A Board
  361.  
  362. Click on the DELETE button on the control panel, then click on the board 
  363. and everything for that board will be returned to the default settings.
  364.  
  365.  
  366. Using Font Folders With NVDI 3
  367.  
  368. NVDI 3 can use fonts files which are held in folders within the directory 
  369. or directories specified in the NVDI.INF file. This makes it possible to 
  370. group fonts into families and select or deselect the group in one 
  371. operation instead of having to find and alter each fint file. You may 
  372. choose to group your fonts in a different scheme, e.g. body fonts, 
  373. display fonts and symbol fonts, however NVDI does not provide a simple 
  374. way of doing this. Stoop can help you control your fonts, either 
  375. selecting individual font files or folders containing font files. The 
  376. following shows how to use Stoop to control folders.
  377.  
  378. Suppose your Speedo fonts are held in folders in C:\GEMSYS\SPEEDO, to set 
  379. up a board the following data should be used to set up a board :-
  380.  
  381.     TITLE            = SPEEDO
  382.     SOURCE PATH        = C:\GEMSYS\SPEEDO
  383.     DESTINATION PATH    = C:\GEMSYS\HIDE.SPD
  384.     DESTINATION FILE    =
  385.     LIVE EXT        = 
  386.     DEAD EXT        = 
  387.     first button        = FOLDERS
  388.     second button        = LONG
  389.  
  390. The FOLDERS button means that the board will only display the names of 
  391. folders.
  392.  
  393. This allows a user to change the Speedo fonts to be used by NVDI 3. In 
  394. this example, the source path must be the same as a font path set in NVDI 
  395. 3 INF file (i.e. FONTPATH = C:\GEMSYS\SPEEDO\).
  396.  
  397. Initially, with this information, Stoop will show all the folders in the 
  398. GEMSYS\SPEEDO directory, which can have any file name extension, on the 
  399. board. Folders in this directory will be highlighted. Stoop will also 
  400. show all of the folders in the GEMSYS\HIDE.SPD directory, but these will 
  401. not be highlighted.
  402.  
  403. Once the board is displayed, the folders can be selected or deselected 
  404. and after clicking on GO, the folders will be moved to their appropriate 
  405. positions. If folders are selected they will be moved to SPEEDO folder 
  406. and if they are unhighlighted they will be moved to the HIDE.SPD folder.
  407. The destination directory, in this example C:\GEMSYS\HIDE.SPD, should be 
  408. outside of the source folder AND it must be in the SAME PARTITION, if it 
  409. is not things may be go wrong. If you are using two boards with folders, 
  410. DO NOT use the same destination folder as any extensions (.TTF, .DOC, 
  411. etc.) are not used to tell them apart, so they will get mixed up and 
  412. appear in both boards which will cause problems.
  413.  
  414.  
  415.                 Buttons
  416.  
  417. At the bottom of the screen are three rows of nine buttons, all of these 
  418. buttons can have a particular set-up assigned to them. There are only 
  419. nine buttons per row because of the font size and number of characters 
  420. (8) used for the legend on each key, if it were smaller it would not look 
  421. as good. Twenty-seven set-ups should be enough for everyone but if they 
  422. are not please write or email.
  423.  
  424. To select them you can either click the mouse on them or you can use a 
  425. function key. The top row can be accessed by pressing just the function 
  426. key (F1-F9), the middle row needs the Control key to be pressed while the 
  427. function key is being pressed (CTRL F1-CTRL F9) and the bottom row needs 
  428. the Alternate to be pressed while the function key is pressed (ALT F1-ALT 
  429. F9). To make things a little easier to remember (there are no prompts 
  430. about which modifier key to use, Control or Alternate), the Control key 
  431. is physically above the Alternate key on the keyboard and the screen 
  432. buttons which use the Control key (middle row) are physically above the 
  433. buttons which use the Alternate key (bottom row).
  434.  
  435. For users who would like to use the F10 function key, this is now 
  436. possible, but additional buttons are not available, instead pressing F10 
  437. is the same as pressing Control F1 and Control F10 gives the same result 
  438. as pressing Alternate F1. Alternate F10 has alias and produces no result. 
  439. This enables those users, who have set up the 10 function buttons on the 
  440. Desktop to call programs, to use the same function buttons in Stoop to 
  441. autoboot the same programs.
  442.  
  443.  
  444. Setting Up A Button
  445.  
  446. Once you have set up the boards, you can begin assigning combinations of 
  447. files, a screen resolution and a auto-booting program to one of the 
  448. buttons at the bottom of the screen.
  449. There are two ways of doing this. If you want to set up only a single 
  450. button, follow the following instructions.
  451.  
  452. 1.    Select all of the files on the boards that you want to be active for a 
  453.     particular task (do not forget that the hidden panels may have 
  454.     selected files (use the CLEAR button to de-select all files).
  455.  
  456. 2.    Choose your resolution, if you want to use a Falcon screen mode first 
  457.     choose the number of colours required by clicking on one of the five 
  458.     buttons labelled 2,4,16,256 and TC (top left of control panel), then 
  459.     adjust the number of horizontal pixels (640 or 320) and the vertical 
  460.     resolution (480 or 240 pixels) by clicking on the 2 buttons just below 
  461.     the colour resolution buttons.
  462.  
  463. 3.    Click on the BUTTON button (right side of control panel). Click on the 
  464.     button you want to assign the current set up to, a dialogue will 
  465.     appear.
  466.  
  467. LEGEND
  468. Here you can enter two lines of text which will appear on the button, 
  469. example DTP and 2 could be used to denote a DTP set up in 2 colours 
  470. (monochrome). Use the mouse, TAB or the arrow keys to move to the second 
  471. line.
  472.  
  473. AUTO BOOT
  474. Clicking on this text box will bring up the file selector, you can then 
  475. choose the program you want to run when the Desktop starts up..
  476.  
  477. OK and CANCEL have their usual meanings.
  478.  
  479. The same editing keys used for the BOARD dialogue are also used with this 
  480. dialogue.
  481.  
  482. If you want to set up several buttons, you can repeat the previous 
  483. instructions  for each button or you can click on the BUTTON button first 
  484. and then click on the SET UP button which then appears. You then set up 
  485. the files you want by selecting them on the boards and then you click on 
  486. the preset button you want to use, the dialogue for setting the title, 
  487. etc.,  of the button will then appear. You can repeat this as often as 
  488. you like, but when you finish you can click on SET UP or BUTTON to stop.
  489.  
  490.  
  491. Showing A Button's Configuration
  492.  
  493. To show which files make up the configuration of a button, click with the 
  494. RIGHT button on the button.
  495.  
  496. If you want to change the parameters of a button sent to the Launch 
  497. program, click on the button while holding down the Alternate key. This 
  498. will also show the files belonging to that button.
  499.  
  500.  
  501. Deleting a Button
  502.  
  503. Click on the DELETE button (lower right of control panel) and then click 
  504. on the button to be deleted.
  505.  
  506. If you want to make a lot of deletions, click on BUTTON and then on 
  507. DELETE. Every button you click on, from now until you click on BUTTON or 
  508. DELETE again, will be wiped - so BECAREFUL.
  509.  
  510.  
  511. Merging & Removing Files from Buttons
  512.  
  513. Files can be added or removed from a button very easily. Click on BUTTON, 
  514. then select either MERGE to add files or REMOVE to delete them from the 
  515. button(s). Any highlighted file on the boards should been deselected. 
  516. Choose the files you want added or removed and then select the button(s) 
  517. that you want changed (this can be done either order or even mixed up). 
  518. Finally, choose the MERGE or REMOVE button (which ever you have already 
  519. selected) and the changes will be made.
  520.  
  521.  
  522. Copying Buttons
  523.  
  524. If you want to make a configuration for a button which is very similar to 
  525. another one already set up, you can copy it in two ways. You can show the 
  526. configuration already set up by clicking on it's button with the RIGHT 
  527. mouse button, then you can make the changes to it and assign the new 
  528. configuration to another button.
  529.  
  530. The other way is to click on BUTTON and then on COPY. Then you should 
  531. click on COPY to deselect it and then make the changes as normal, this 
  532. method also copies everything which makes setting up the same 
  533. configuration for different screen resolutions easier.
  534.  
  535. If you are going to make several copies, make each copy and then use the 
  536. SET UP button to make the changes to each one, this means that BUTTON 
  537. will not have to be reselected for each button.
  538.  
  539.  
  540. Swapping Buttons
  541.  
  542. Buttons can be rearranged so that you can reorder or group together 
  543. similar set ups. Click on BUTTON and then on SWAP. Then simply click on 
  544. the two buttons you want to swap. To stop, click on BUTTON or SWAP.
  545.  
  546.  
  547. Using a Button
  548.  
  549. Once a preset button has been set up, a single mouse click is all that is 
  550. needed to use it. When this happens, Stoop displays the configuration 
  551. belonging to the button and then changes the files (selected files are 
  552. made active, un-selected are made inactive), it then changes NEWDESK.INF 
  553. so that the correct screen resolution will be used and that the auto boot 
  554. program (if there is one) is automatically run when the Desktop starts 
  555. up.
  556.  
  557. The preset configurations can also be activated by using the function 
  558. keys,
  559.     F1..F9            will select one of the top row buttons,
  560.     Control F1..F9        will select a middle row button and
  561.     Alternate F1..F9    will select a bottom row button.
  562.  
  563. In addition, F10 is aliased with Control F1, hence pressing F10 is the 
  564. same as pressing Control F1, and pressing Control F10 is equivalent to 
  565. pressing Alternate F1. Alternate F10 does not have an alias.
  566.  
  567.  
  568.        Passing Parameters to Auto-Booting Programs
  569.  
  570. Stoop can now pass parameters to auto-booting programs, though this is 
  571. not reliable as it should be because of bugs in TOS 4 or Lattice C which 
  572. do not allow the path for a drive or partition to be set.  Environment 
  573. strings can also be set at the same time.
  574.  
  575. To pass parameters to a program another program is needed, in this case 
  576. Launcher.prg, which is run instead of the required program and then calls 
  577. the program that you want to use. Launcher has to load in details, 
  578. prepared by Stoop, which contain the program's name and the other data 
  579. such as the filename(s) to be passed and the environment strings to be 
  580. set.
  581.  
  582.  
  583. Setting Up Stoop for Passing Parameters
  584.  
  585. The parameters are attached to the  preset  buttons  so  that  when  you 
  586. select a preset configuration to be set up the parameters will be set up 
  587. as well.
  588.  
  589. To set up for passing parameters, set up a button for normal operation, 
  590. see the section 'Button', but after you have given the button a name 
  591. select the LAUNCH button on the dialogue.  A new dialogue  will appear 
  592. which has two windows, called tail and environment.
  593.  
  594. These windows can be have text entered into them in two  ways,  you  can 
  595. type directly into them or you can  use  the  file  selector  to  either 
  596. insert the text from a file or the full name of the file in the  window. 
  597. Whatever you choose, the new text will appear at the cursor position.
  598.  
  599. The tail window should contain  the  parameters  to  be  passed  to  the 
  600. program you want  to  use,  this  includes  filenames  or  command  line 
  601. parameters.
  602.  
  603. To enter text into either window using the file selector.
  604.  
  605. First move the cursor to the line where you  want  the  text  to  appear 
  606. (see below for keyboard commands), then call the file selector with the 
  607. FSEL button, select the file you want and press OK. Another dialogue now 
  608. appears, this gives you three choices; INSERT, PUT NAME or ABORT.
  609.  
  610. INSERT
  611. Choosing this button will put the text contained in the file into your 
  612. window. (WARNING - only try this with small files of about 10k length).
  613.  
  614. PUT NAME
  615. This will put the file name, including it's full path, in the window.
  616.  
  617. ABORT
  618. Allows you to abort making changes to the text in the window.
  619. Example, if the program for which you are setting the button up is 
  620. Gemview, you can put the names of picture  files  you  want  Gemview  to 
  621. automatically load and display when you  auto-boot  it.  (Use  the  FSEL 
  622. button and PUT NAME to enter the picture files, you can only do this one 
  623. at a time.)
  624.  
  625.  
  626. Text Window Keyboard Commands
  627.  
  628. The four cursor keys move the cursor as normal (left, right, up or down 
  629. one space).
  630.  
  631. Holding a SHIFT key down with either of the left and right cursor keys to 
  632. move the cursor to the  start   or   end   of   the current line 
  633. respectively.
  634.  
  635. Holding a SHIFT key down with either of the up and down cursor keys will 
  636. page the text up or down respectively.
  637.  
  638. RETURN will add a new line below the current line the cursor is  on.  If 
  639. the cursor is in the middle of the line, the text will be split  between 
  640. the lines.
  641.  
  642. DELETE will delete the character the cursor is covering. If  the  cursor 
  643. is at the end of the line, this line and the one below will  be  joined, 
  644. (any characters over the maximum character line length will be left on 
  645. the next line).
  646.  
  647. BACKSPACE will delete the character in front of the cursor. If the cursor 
  648. is at the start of the line, this line and the one above will be joined, 
  649. (any characters over the maximum character line length will be left on 
  650. the line).
  651.  
  652. TAB will change the window the cursor is in (this may also be done  with 
  653. a click of the mouse on the required window).
  654.  
  655. CTRL - Y (hold the Control key down, press Y key before letting  go  of 
  656. Control) will delete the current line. (BUG - the first line cannot be 
  657. deleted in this way, to get around  this put the cursor on the first 
  658. character and press return to move the  line to the next row and then 
  659. delete, or just use the  Backspace  and  Delete keys to remove individual 
  660. characters.)
  661.  
  662. CTRL - U (hold the Control key down, press U key before letting  go  of 
  663. Control) will put the last line to  be  deleted  by  CTRL  -  Y  at  the 
  664. current position of the cursor.
  665.  
  666. These commands are fairly basic, but they are not intended  to  be  used 
  667. with large amounts of text.
  668.  
  669. NB. The maximum line length is 125 characters, if this is too small, 
  670. please let me know. 
  671.  
  672.  
  673. Environment Options
  674.  
  675. Just below the Environment window are two recessed displays clicking  on 
  676. the first of these will present options which can increase the usefulness 
  677. of environment strings. These options will appear on a pop-up window in 
  678. the middle of the screen, they are :-
  679.  
  680. SEND TO PROGRAM ONLY
  681. This is the  default  setting,  the  contents  of the environment 
  682. window are sent to the launcher program which then  sets them up for 
  683. the program it will launch.
  684.  
  685. SEND TO FILE ONLY
  686. The environment window contents are sent to a  file, the name of the 
  687. file can be chosen using the file selector  by  clicking on the second 
  688. recessed display.
  689.  
  690. This will allow users of MultiTos to edit a MINT or GEM configuration 
  691. file before launching MultiTos. Other programs which have an editable 
  692. configuration file may also benefit from this option.
  693.  
  694. If this is popular, I will add the ability to edit more than one file.
  695.  
  696. IGNORE ENVIRONMENT
  697. The contents of the environment window are not used in any way.
  698.  
  699.  
  700. Problems With Passing Parameters
  701.  
  702. For some reason unknown to me, I cannot set the current path on a drive. 
  703. This is a bug in either TOS 4.04 or in Lattice C  5.60.  Please  let  me 
  704. know if this is a known bug - and if a fix is possible.
  705.  
  706. This only causes problems with a few programs which I believe  look  for 
  707. their .RSC and .INF files in the current  directory  for  their  current 
  708. drive. The only program that I found that does this is  Papyrus  and  to 
  709. get around it put the .RSC and .INF files  it  looks  for  in  the  root 
  710. directory of drive C (or A if you do not have a harddrive).
  711.  
  712. *** WARNING ***
  713.  
  714. While Stoop does and display files containing odd characters in their 
  715. names, it cannot assign them properly to a button or group. However these 
  716. file names cause BIG problems if you try to hide them from Stoop (see 
  717. section on the file selector later on).
  718.  
  719.  
  720.                 Groups
  721.  
  722. A set of files can be assigned to a Group, this allows you to set up 
  723. groups of common files this makes setting up preset buttons quicker but 
  724. is more useful for when you want start up your Falcon in a one-off 
  725. configuration.
  726.  
  727. Example, the files UISIII(.PRG) in the AUTO folder could be grouped with 
  728. CALL_UIS(.ACC) and assigned to a group called UIS, when UIS is clicked on 
  729. both of these files will be selected.
  730. To set up a group :-
  731.  
  732. 1.    Select the files on the boards you want assign to the group, all other 
  733.     files must be inactive.
  734.  
  735. 2.    Click on the GROUP button (right side of control panel) and then click 
  736.     on the GROUP board, a simple dialogue will appear.
  737.  
  738. 3.    Type in the name to be given to the group. Then exit. The name will 
  739.     appear in alphabetical order on the GROUP board.
  740.  
  741. To de-select all the files assigned to a group, simply click with the 
  742. Right button on the name in the GROUP board.
  743.  
  744.  
  745. Deleting A Group
  746.  
  747. Click on the DELETE button, then click on the group name on the GROUP 
  748. board to be deleted.
  749.  
  750. *** WARNING ***
  751. While Stoop does and display files containing odd characters in their 
  752. names, it cannot assign them properly to a button or group. However these 
  753. file names cause BIG problems if you try to hide them from Stoop (see 
  754. section on the file selector later on).
  755.  
  756.  
  757.               The File Selector
  758.  
  759. The file selector is divided into several main parts; the PATH and FILE 
  760. text boxes which can be manually edited, the file & folder display area, 
  761. the drive buttons, the file utility buttons and the OK & CANCEL buttons.
  762.  
  763. The file selector offers some of the extended facilities offered by 
  764. enhanced GEM file selectors, namely it can COPY, DELETE, MOVE and RENAME 
  765. files and folders, it can also create folders. Also, there are two Stoop 
  766. specific functions it can carry out, it can re-order the AUTO folder and 
  767. it can hide files from Stoop so that they cannot be displayed on the 
  768. boards, but the file selector can still show them (so that you can 
  769. un-hide them).  
  770.  
  771. To select a file, just click on it and do this again to de-select it or 
  772. select another file.
  773.  
  774. To enter a folder, just click on it. To select a folder, hold down the 
  775. SHIFT key on the keyboard as you click on it.
  776. To select multiple files and folders, hold down a SHIFT key as you click 
  777. on each one. There is NO lasso function using the mouse (I will put one 
  778. in  soon).
  779.  
  780. Copying Folders & Files
  781.  
  782. 1.    Choose the files and folders you want to copy.
  783. 2.    Click on the COPY button.
  784. 3.    Select the folder or drive to copy them to.
  785. 4.    Press RETURN or click on OK.
  786.  
  787. Files cannot be copied on top of themselves, if you try this all copy 
  788. operations are ignored.
  789.  
  790. Moving Folders & Files
  791.  
  792. 1.    Choose the files and folders you want to move.
  793. 2.    Click on the MOVE button.
  794. 3.    Select the folder or drive to move them to.
  795. 4.    Press RETURN or click on OK.
  796.  
  797. Files cannot be moved on top of themselves, if you try this all move 
  798. operations are ignored.
  799.  
  800. Deleting Folders & Files
  801.  
  802. 1.    Choose the files and folders you want to delete.
  803. 2.    Click on the DELETE button.
  804.  
  805. Renaming Folders & Files
  806.  
  807. 1.    Select the file or folder to be renamed, it's name should appear in 
  808.     the FILENAME text box.
  809. 2.    Click on the RENAME button.
  810. 3.    Edit the name in FILENAME to the new name.
  811. 4.    Click on the RENAME button or press RETURN or click on OK.
  812.  
  813. Creating Folders
  814.  
  815. 1.    Type in the name of the new folder in the FILENAME text box.
  816. 2.    Click on the FOLDER button.
  817.  
  818. Re-Ordering the AUTO Folder
  819.  
  820. 1.    Click on the REORDER button, the file selector should now display the 
  821.     contents of the AUTO folder on the boot drive.
  822. 2.    Click on the file you want to move.
  823. 3.    Click on the position you want it to be moved to.
  824. 4.    Repeat these actions as many times as you require.
  825. 5.    Click on the REORDER button or press RETURN or click on OK, the files 
  826.     will then be re-ordered.
  827.  
  828. Note : folders in the AUTO folder cannot be re-ordered.
  829.  
  830. Hiding Files from Stoop
  831.  
  832. 1.    Select the file to be hidden from Stoop.
  833. 2.    Click on the HIDE button.
  834.  
  835. The hidden file will still be visible on the file selector but it's name 
  836. will be in grey rather than black. If the hidden file was visible on a 
  837. board before you hid it, it will disappear from there when you exit the 
  838. file selector.    
  839.  
  840. The details of the hidden files have to be added to Stoop's INF file, so 
  841. remember to SAVE after hiding a file.
  842.  
  843. *** WARNING ***
  844. Do not hide files which contain odd characters, while Stoop can display 
  845. the names of such files it has problems with them and CAN cause STOOP.CFG 
  846. to crash Stoop. Try renaming the offending file.
  847.  
  848.  
  849.                 Main Controls
  850.  
  851.  
  852. GO & EXIT Buttons
  853.  
  854. GO
  855. This causes the Stoop to change all selected files on the boards to be 
  856. made active and all un-selected files to become inactive, copies required 
  857. files to folders and then changes the NEWDESK.INF file so that the 
  858. Desktop will start up in the selected resolution and boot the current 
  859. AUTO BOOT program.
  860.  
  861. Stoop then exits, the AUTO folder programs are run, the accessories are 
  862. loaded and then the Desktop appears.
  863.  
  864. GO is provided so that you can make and use a start-up configuration 
  865. without having to assign it to a button, or make a small change to an 
  866. existing configuration (e.g. change the number of colours or resolution), 
  867. see the information below.
  868.  
  869. EXIT
  870. Clicking on this causes Stoop to exit without making a single change to 
  871. files or NEWDESK.INF.
  872.  
  873.  
  874. Auto-Booting Programs
  875.  
  876. Clicking on the AUTO BOOT window (just above the Stoop logo) will bring 
  877. up a dialogue for selecting the program for the Desktop to run after the 
  878. computer has finished booting. This is only useful for configurations 
  879. which you do not want to assign to a preset button.
  880. The dialogue can contain a list of up to sixty program names, these names 
  881. can be easily selected and passed back to the AUTO BOOT window by 
  882. clicking on one and choosing OK. This program will only be passed back to 
  883. Desktop for running if the GO button is used to exit Stoop.
  884.  
  885. ADD
  886. This brings up the fileselector and allows you to add another name to the 
  887. program list.
  888.  
  889. REMOVE
  890. This will delete the name which has been highlighted.
  891.  
  892. MERGE
  893. This will search the preset button configurations and add any new program 
  894. names found to the program list.
  895.  
  896. FSEL 
  897. This brings up the file selector, the program list dialogue will exit if 
  898. OK on the file selector is used, any file name chosen will be passed 
  899. immediately to the AUTO BOOT window.
  900.  
  901. NONE
  902. This exits the dialogue and clears the AUTO BOOT window.
  903.  
  904. CANCEL 
  905. Exits the dialogue and leaves the AUTO BOOT window unchanged, though any 
  906. changes made to the program list are retained.
  907.  
  908.  
  909.               Option Controls
  910.  
  911. The six buttons near the bottom of the control panel make Stoop a bit 
  912. easier to use.
  913.  
  914. FSEL
  915. Brings up the file selector.
  916.  
  917. DELETE
  918. Used to wipe buttons, boards and groups. Simply click on the DELETE 
  919. button and then on the button, board or group to be wiped. Remember to 
  920. SAVE the changes afterwards!
  921.  
  922. SAVE
  923. Saves all the data Stoop needs to remember your requirements.
  924.  
  925. CLEAR
  926. De-selects all files on all boards.
  927.  
  928. CONFIG
  929. This button allows to change the configuration of Stoop and your Falcon. 
  930. When you click on it, a dialogue will appear which is in two parts 
  931. separated by a groove. On the right are four buttons, SYSTEM, START UP, 
  932. COLOURS and QUIT, and on the left is a dialogue. When you first click on 
  933. CONFIG the dialogue will be the 'System Controls' dialogue, and the 
  934. SYSTEM button on the right will be depressed. If you click on START UP or 
  935. COLOURS the dialogue will change.
  936.  
  937. SYSTEM Dialogue
  938.  
  939. The first three controls are self-explanatory, you can turn on or off the 
  940. following;
  941.  
  942. (i)     the CPU cache (leave it on, as it accelerates your Falcon, especially 
  943.     if the code has been written to take advantage of it),
  944.  
  945. (ii)    the system bell, this makes the high pitched ping when you an error 
  946.     occurs (such as clicking the mouse on another part of the screen when 
  947.     a dialogue is shown), and
  948.  
  949. (iii)    the key clicks, this is the sound made by your Falcon when a key is 
  950.     pressed.
  951.     
  952. The Sound Level slider controls the volume of the sound from your internal 
  953. speaker or from the stereo output at the back of the machine. To change it,
  954. the slider can be dragged (to the left to increase volume) or the mouse can
  955. be click on the position you want the slider to move to and the buttons on
  956. either end can be used for fine adjustment.
  957.  
  958. The Sound Balance is only useful if you have stereo speakers attached to 
  959. your  Falcon, it controls the relative volumes of the left and right 
  960. speakers.
  961.  
  962. Both of these controls make a sound as you use them, this enables you to 
  963. judge what you are setting.
  964.  
  965. The UNDO button will remove the adjustments you have made, however once 
  966. the dialogue is exited the adjustments are not remembered and 
  967. subsequently cannot be undone by this button.
  968.  
  969.  
  970. START UP Dialogue
  971.  
  972. This allows you to choose between 
  973. (i)    entering a password to access Stoop,
  974.  
  975. (ii)    having Stoop wait a set period for you to use it and if nothing 
  976.     happens it will set up a default configuration and exit, or
  977.  
  978. (iii)    neither of these.
  979.  
  980. Only one of these options is viable at any one time.
  981.  
  982. To set the password, click on CHANGE PASSWORD, if you already have a 
  983. password set up you will be asked for it before you can replace it. The 
  984. password will be not be displayed but an asterisk will be used to show 
  985. each character as it is entered, it may be edited by using Backspace or 
  986. wiped by using Esc. The new password has to be entered twice, press 
  987. return after each one.
  988.  
  989. To make Stoop ask for the password when it starts up, click on PASSWORD 
  990. OFF, it should change to PASSWORD ON. You will have to save these changes 
  991. for them to take effect next time you run Stoop.
  992.  
  993. To make Stoop do a time-out when it starts up, click on TIMEOUT OFF, if 
  994. should change to TIMEOUT ON. To set the time you want Stoop to wait, edit 
  995. the Time delay, it can have a value ranging from 0 to 999 and the unit of 
  996. measurement can be seconds (s), minutes (m) or hours (h). You do not have 
  997. to leave a space between the number and the unit.
  998.  
  999. To select the default configuration you can simply press the key that you 
  1000. require. Please note that F10 is aliased with Control F1, i.e. pressing 
  1001. F10 is the same as pressing Control F1, and Control F10 is equivalent to 
  1002. Alternate F1, but Alternate F10 has no alias.
  1003.  
  1004. If you choose zero for the time delay value, Stoop will automatically set 
  1005. up the default configuration and exit. If you want to change the way 
  1006. Stoop starts up at a later date, you will have to run Stoop from the 
  1007.  
  1008. Desktop (minimum resolution 640 x 480 by 16 colours).
  1009.  
  1010.  
  1011. COLOURS Dialogue
  1012.  
  1013. The colours used by Stoop can be changed in this dialogue, this has no 
  1014. effect on the colours used by the Desktop. Simply click on the colour you 
  1015. wish to change and then adjust the RGB sliders.
  1016.  
  1017. The UNDO button offers two levels of undo, if you have made changes to 
  1018. the colours, the first click on this button will remove the changes. The 
  1019. second click will offer you the choice of reverting back to the original 
  1020. Stoop colours, a third click will revert back to the colours you have 
  1021. just selected if you make the wrong choice at this point.
  1022.  
  1023.  
  1024. INITIAL
  1025.  
  1026. Clicking on this button causes all the files on all the boards to be 
  1027. changed to their initial setting (active or inactive) when Stoop was 
  1028. first started up.
  1029.  
  1030.  
  1031.           Manual Start Up Configurations
  1032.  
  1033. Sometimes you may want to use a particular start up configuration just 
  1034. once, and as it does need to be used again assigning it to a preset 
  1035. button is a waste of time.    This is what to do instead :-
  1036.  
  1037. 1.     Set up the files on the boards as you want them (I often show the 
  1038.     contents of a preset (by using the right mouse button), which has the 
  1039.     nearest configuration to what I require, to give a position to start 
  1040.     from).
  1041.  
  1042. 2.    If you want to auto-boot a program, click on the AUTO BOOT text box 
  1043.     (near the bottom of the control panel), this will bring up the file 
  1044.     selector. Select the file you want and exit.
  1045.  
  1046. 3.    Click on GO.
  1047.  
  1048. Example.
  1049.  
  1050. How to change the resolution of a preset configuration from 16 to 256 
  1051. colours.
  1052.  
  1053. 1.     Show the contents of the preset by clicking the right mouse button on 
  1054.     the preset button.
  1055.  
  1056. 2.    Now click on the preset button.    (The SHOW button will pop up.)
  1057.  
  1058. 3.    Make the change by clicking on the 256 button.
  1059.  
  1060. At this point you have three options, you can:-
  1061.  
  1062. (i)    use the BUTTON button to re-assign the new configuration to the old 
  1063.     preset button,
  1064.  
  1065. (ii)    use the BUTTON button to assign the new configuration to another 
  1066.     preset button and
  1067.  
  1068. (iii)    press GO, which will use the current set-up without saving it so 
  1069.     that it might be used again.