home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !FALCON / !BONUS / UTILITY / STOOP103.ZIP / STOOP.TXT < prev    next >
Text File  |  1994-11-27  |  34KB  |  932 lines

  1. **************** * STOOP Manual * ****************
  2.  
  3. Version 1.03
  4.  
  5.  
  6. Hardware Required =================
  7.  
  8. Atari Falcon with 4Mb RAM and a VGA or SVGA display is recommended  (the
  9. screen resolution needed for  Stoop  is  a  minimum  640  x  480  by  16
  10. colours).
  11.  
  12.  
  13. Contents ========
  14.  
  15. Introduction
  16.     Getting Started 
  17.     VGA or SVGA Monitors 
  18.     RGB monitors
  19.     Televisions
  20.    Installing Stoop
  21.  
  22. Setting Up Stoop
  23.  
  24. Boards
  25.     Editing a Board
  26.     Changing Boards
  27.     Deleting a Board
  28.  
  29. Buttons
  30.     Deleting a Button
  31.     Using a Button
  32.  
  33. Passing Parameters to Auto-Booting Programs
  34.     Setting Up Stoop for Passing Parameters
  35.     Text Window Keyboard Commands
  36.     Environment Options
  37.     Problems With Passing Parameters
  38.     
  39. Groups
  40.     Using a Group
  41.     Deleting a Group
  42.  
  43. The File Selector
  44.     Copying Folders & Files
  45.     Moving Folders & Files
  46.    Deleting Folders & Files
  47.    Renaming Folders & Files
  48.    Creating Folders
  49.    Re-Ordering the AUTO Folder
  50.    Hiding Files from Stoop
  51.  
  52. Main Controls
  53.     Option Controls
  54.     Auto-Booting Programs
  55.  
  56. Manual Start Up Configurations
  57.  
  58.  
  59.  
  60. Introduction
  61. ============
  62.  
  63. Stoop is a boot manager for the Atari Falcon. It has its  own  graphical
  64. interface and uses the mouse for most operations but it does  make  some
  65. use of the keyboard.
  66.  
  67. Stoop can :
  68.  
  69. ≡ Be used to determine which AUTO programs, accessories, CPX modules and
  70.   NEWDESK.INF files should be active when starting up or re-booting.
  71.   
  72. ≡ Control other types of file (e.g. GDOS ASSIGN.SYS files) to a  maximum
  73.   of 20 different types.
  74.  
  75. ≡ Display up to 128 file names in each of 20 boards. These  boards  have
  76.   to be paged to view all of the file names,  but  paging  buttons  will
  77.   only appear when necessary.
  78.  
  79. ≡ Either change the extension of a file name to make it active/inactive,
  80.   e.g. ACX is changed to ACC and vice versa, (the file may be also moved
  81.   to another folder at the same time) this can be done for a maximum  of
  82.   254 files per file type. Or a single file can copied and renamed to  a
  83.   specific name, e.g. C:\AUTO\STOOP\GENERAL.INF may become NEWDESK.INF.
  84.  
  85. ≡ Make groups of files which may be selected or de-selected by a  single
  86.   button press, to a maximum of 50 files per board per group, and  since
  87.   there is a maximum of 20  boards  a  maximum  of  1000  files  can  be
  88.   assigned per group (but you wouldn't like the slow program start-up).
  89.  
  90. ≡ Control the screen  resolution  of  the  desktop  that  appears  after
  91.   booting, including starting  up  in  ST  compatible  screens,  without
  92.   having to use a specific NEWDESK.INF file.
  93.  
  94. ≡ Change the application the desktop runs after boot-up.
  95.  
  96. ≡ Store often used start-up configurations on buttons, to a  maximum  of
  97. 27.
  98.  
  99. ≡ Copy, delete and move folders and files, and also rename files,  using
  100.   its own file selector.
  101.  
  102. ≡ Re-order the contents of the AUTO folder.
  103.  
  104. ≡ Hide files from itself so that they cannot be selected/de-selected for
  105.   boot-up by error. Up to 50 files can be hidden.
  106.     
  107. ≡ Be easily configured while running from the AUTO folder.
  108.  
  109. This program has an element of overkill, it can store enough details  to
  110. control at least 100,000 files and uses a proportionate amount of memory
  111. to do so, hence this program runs only in 4 Mbytes.
  112.  
  113. However, if you would like to run it on a 1Mb Falcon drop a line  to  me
  114. (with your registration, of course) and  I  will  see  what  I  can  do.
  115. Conversely, if you find the large numbers of  files  and  boards  useful
  116. tell me before they get cut. If there are groups of users in each  camp,
  117. I will produce two versions of Stoop.
  118.  
  119.  
  120. Getting Started
  121. ===============
  122.  
  123. First, make sure that your system can run STOOP.PRG  when  you  boot  by
  124. ensuring that the screen resolution is AT LEAST 640 wide x 480 high x 16
  125. colours. This can be done  from  a  program  called  BOOTCONF.PRG,  this
  126. changes settings held in NVRAM which determine to some  extent  how  the
  127. computer will behave when it is started up.
  128.  
  129.  
  130. VGA or SVGA Monitors
  131. --------------------
  132.  
  133. The relevant settings are :-
  134.  
  135.     COLOUR  :     16 VGA
  136.     DISPLAY :     
  137.     COLUMNS :     80
  138.  
  139. (the setting of PAL and NTSC have no effect with VGA, so you can  ignore
  140. it)
  141.  
  142. The following settings should be OFF
  143.  
  144.     DOUBLE LINE (VGA)/ INTERLACE (TV) OVERSCAN  (TV  ONLY)  COMPATIBILITY
  145.     MODE
  146.  
  147.  
  148. RGB Monitors
  149. ------------
  150.  
  151. The relevant settings are :-
  152.  
  153.     COLOUR  :    16 NTSC
  154.     DISPLAY :    
  155.     COLUMNS :    80 DOUBLE LINE (VGA)/ INTERLACE (TV) OVERSCAN (TV ONLY)
  156.  
  157. (setting NTSC should mean that the monitor has a screen refresh of 60 Hz
  158. rather than 50 Hz, I think - I don't have access to an RGB monitor).
  159.  
  160. The following setting should be OFF
  161.  
  162.     COMPATIBILITY MODE
  163.  
  164.  
  165. Televisions
  166. -----------
  167.  
  168. The relevant settings  are  the  same  as  for  RGB  monitors  with  one
  169. difference depending upon which TV picture signal standard  is  used  by
  170. your TV, either PAL (as in Britain) or NTSC (as in U.S.A.).
  171.  
  172.  
  173. Installing Stoop
  174. ================
  175.  
  176. Your copy of Stoop should be the first program in the AUTO folder to  be
  177. executed for it to work most effectively. To ensure this, Stoop  has  to
  178. be the first entry in the AUTO  folder  directory  because  AUTO  folder
  179. programs are executed in this order.  There  several  methods  of  doing
  180. this, two are listed below :-
  181.  
  182. (i) Put STOOP.PRG straight into the AUTO folder.
  183.  
  184.      Do not re-boot at this point!
  185.  
  186.      Double click on STOOP.PRG to get it running.
  187.  
  188.      Locate the button on the screen labelled FSEL and click on it.
  189.  
  190.      Stoop's file selector should now appear.
  191.  
  192.      Click on the button marked REORDER and the current directory should
  193.      change to the AUTO folder on your boot disk or hard-drive.
  194.  
  195.      Click on the entry for  STOOP.PRG  in  the  directory  listing,  it
  196.      should then be highlighted.
  197.  
  198.      Now click on the entry where Stoop should be positioned  (which  is
  199.      the first entry which is not a folder).
  200.     
  201.      The name STOOP.PRG will appear where you have just  indicated,  but
  202.      it has not yet been moved in the folder.
  203.     
  204.      Now click on OK or REORDER, the files will then be physically moved
  205.      on the disk.
  206.     
  207. (ii) Use a program called AUTOSORT.PRG, if you have it.
  208.  
  209.      To finish, create a folder inside  the  AUTO  folder  and  call  it
  210.      STOOP. This folder is where Stoop  will  store  it's  configuration
  211.      file when you use the SAVE button.
  212.  
  213. *** WARNING *** Currently, Stoop is incompatible with NVDI 2.5  (version
  214. 3 has not been tested) hence make sure that NVDI runs  after  Stoop.  If
  215. you do run Stoop after NVDI, press Control+C to escape from Stoop.
  216.  
  217.  
  218. Setting Up Stoop
  219. ================
  220.  
  221. To start up Stoop after installation, you can either re-boot or  run  it
  222. from the Desktop. When you have started Stoop up you should see a screen
  223. divided into three main areas; the largest area is the boards where  all
  224. of the files will be displayed, to the right of it is the control  panel
  225. containing various buttons with a  board  labelled  GROUPS  and  at  the
  226. bottom of the screen are 27 buttons which can be used  to  store  preset
  227. start up configurations.
  228.  
  229.  
  230. Boards
  231. ======
  232.  
  233. The first step should be to arrange the boards to display  the  required
  234. files. Each board shows the files which  match  one  of  two  extensions
  235. (e.g. PRG and PRX) that exist in one folder or root directory.
  236.  
  237. There are 5 boards which you can  re-configure,  each  one  can  have  4
  238. different faces. Each board can be displayed as either one long board or
  239. two short ones. When you first run Stoop there may not  be  a  STOOP.CFG
  240. file present which contains the  configuration  information  for  Stoop,
  241. hence Stoop will use it's default configuration. The  first  two  boards
  242. should show the program files in the AUTO folder and the accessories  on
  243. the root directory of your boot drive. These boards may  be  altered  to
  244. show different types of file  (different  file  extensions)  and/or  the
  245. files in different folders or drives.
  246.  
  247. To alter a board, click on the BOARD button (right hand side of  screen)
  248. and then click on the board you want to change. A dialogue should pop up
  249. which displays the current details of that particular board:-
  250.  
  251. TITLE : The name of the board which is displayed just above the  top  of
  252. the board.
  253.  
  254. SOURCE PATH : The folder or drive which will hold the files to be  shown
  255. on the board.
  256.  
  257. DESTINATION PATH : The folder or drive which the file or files  will  be
  258. copied to (this MUST be given even if it  is  the  same  as  the  SOURCE
  259. PATH).
  260.  
  261. DESTINATION FILE : The name that will be given to a single file once  it
  262. has been copied. If this box contains any text then only one file may be
  263. selected on the board at any one time, otherwise  any  number  (zero  to
  264. all) of files can be selected.
  265.  
  266. LIVE & DEAD EXTS : These are the file extensions of the files that  will
  267. be shown on the board. The 'live' extension is the one that active files
  268. have (e.g. PRG or ACC) while  the  'dead'  extension  is  the  one  that
  269. inactive files will be given which usually terminates with an 'X'  (e.g.
  270. PRX or ACX).
  271.  
  272. SHORT/LONG button : This button will toggle between  showing  SHORT  and
  273. LONG on it's surface. When it shows LONG, one long board will appear  at
  274. the chosen position and it will display up to 34 file names, and when it
  275. shows SHORT there will be 2 short boards displayed showing up to 16 file
  276. names each.
  277.  
  278. OK and CANCEL : These have their usual meanings, they both let the  user
  279. quit the dialogue but OK confirms any changes and CANCEL ignores them.  
  280.  
  281.  
  282. Most of the above is straight forward, but the use  of  the  DESTINATION
  283. FILE needs explaining. Some programs use INF (or similar) files to  hold
  284. data about the program's start up settings, e.g. the Desktop is one such
  285. program and it uses NEWDESK.INF. If you want to start up these  programs
  286. with different settings, depending upon your needs, the INF file has  to
  287. be replaced with another version. For Stoop to do this automatically for
  288. you it needs the name of the INF file, this  is  what  DESTINATION  FILE
  289. should hold.
  290.  
  291. Example #1
  292. ----------
  293.  
  294. Suppose the dialogue holds the following data :-
  295.  
  296.     TITLE = NEWDESK SOURCE PATH = C:\AUTO\STOOP DESTINATION  PATH  =  C:\
  297.     DESTINATION FILE = NEWDESK.INF LIVE EXT = INF DEAD EXT =  INX  button
  298.              = SHORT
  299.  
  300. This allows a user to have different set-ups for the Desktop. Any  files
  301. contained in C:\AUTO\STOOP (but not any folders within it) that have INF
  302. or INX extensions will be displayed upon the board, INF  files  will  be
  303. highlighted and INX files will not.
  304.  
  305. The SHORT button means that two short boards will be shown in the chosen
  306. column, the other board may appear above or  below  the  board  you  are
  307. setting up.
  308.  
  309. Suppose that the folder C:\AUTO\STOOP contains these three files:-
  310.  
  311.     GENERAL.INX DTP.INX SBLASTER.INF
  312.  
  313. Their names will appear on the  board  without  their  extensions,  only
  314. SBLASTER is highlighted as it's extension is 'live' (it has INF for it's
  315. extension).
  316.  
  317. Selecting GENERAL on  the  board  will  highlight  it  and  un-highlight
  318. SBLASTER. Clicking on the GO button will cause GENERAL.INF to be  copied
  319. to drive C and named NEWDESK.INF (the previous  NEWDESK  file  is  first
  320. deleted).
  321.  
  322. Example #2
  323. ----------
  324.  
  325. Suppose the boxes hold the following data :-
  326.  
  327.     TITLE =  ACCESSORIES  SOURCE  PATH  =  C:\  DESTINATION  PATH  =  C:\
  328.     DESTINATION FILE = LIVE EXT   =   ACC   DEAD   EXT   =   ACX   button
  329.     = LONG
  330.     
  331. This allows a user to change the accessories loaded  at  boot  up.  Note
  332. that DESTINATION FILE should contain no text.
  333.  
  334. With this information, Stoop  will  show  all  the  files  in  the  root
  335. directory of drive C which have either ACC  or  ACX  extensions  on  the
  336. board. Files with 'live' extenders (ACC) will be highlighted while files
  337. with 'dead' extensions will not. Clicking on a 'dead' file will make  it
  338. live without changing the status of any other file  and  clicking  on  a
  339. 'live' file will make it 'dead'.
  340.  
  341. Clicking on GO will cause all files to be  renamed  according  to  their
  342. status on the board, highlighted names become 'live' (they are given the
  343. ACC extension) and all of the others are 'killed' (given ACX extenders).
  344.  
  345. Note that although TOS 4 only allows a maximum of 6  accessories  to  be
  346. loaded at any one time, Stoop will not stop you from selecting more than
  347. 6 accessories.
  348.  
  349. If the SOURCE  and  DESTINATION  PATH's  were  different  in  the  above
  350. example, the files would be re-named and they would  be  copied  to  the
  351. DESTINATION PATH, but  please  note  that  any  existing  files  in  the
  352. DESTINATION PATH would be unaffected. Hence avoid using different SOURCE
  353. and DESTINATION PATH's when multiple files are to be made  'live'  (i.e.
  354. DESTINATION FILE is undefined) as any files copied there by Stoop during
  355. a previous boot up will still be there.
  356.  
  357. The LONG button means that one long board will be shown  in  the  chosen
  358. column.
  359.  
  360.  
  361. Editing A Board
  362. ---------------
  363.  
  364. Now that you now what the boards can do, how do you change  them  to  do
  365. what you want?
  366.  
  367. There are basically two types  of  boxes  which  contain  text  on  this
  368. dialogue,
  369.  
  370. (i) Boxes which can be edited manually by placing the cursor in  it  and
  371.      adding characters from the keyboard.
  372.  
  373. (ii) Boxes which you click on and this brings up the file selector. This
  374.      type is used to hold file paths and names which  are  selected  via
  375.      the file selector.
  376.  
  377. TITLE : If the text cursor is not in the Title box you can (i) click the
  378. mouse on it, (ii) press TAB or (iii) press the up or down arrow keys  to
  379. move it into the box. You can then type the  new  name,  BACKSPACE  will
  380. delete back one character and ESC will clear all of  the  text.  Do  not
  381. press RETURN or ENTER unless you want to exit the dialogue  and  confirm
  382. the changes (this is equivalent to clicking on the OK button).
  383.  
  384. SOURCE PATH : Click the mouse on the text area of  this  box,  the  file
  385. selector will appear and you can choose the path you require.
  386.  
  387. DESTINATION PATH : Use the same procedure as for the SOURCE PATH.
  388.  
  389. DESTINATION FILE : Use the same procedure for the Title text box.
  390.  
  391. LIVE EXT : Use the same procedure for the Title text box.
  392.  
  393. DEAD EXT : Use the same procedure for the Title text box.
  394.  
  395. SHORT/LONG : Click on this to toggle it's setting.
  396.  
  397. Remember to SAVE the changes you make!
  398.  
  399.  
  400. Changing Boards
  401. ---------------
  402.  
  403. There are 20 boards, but only five to ten can be shown at any one  time,
  404. to show the others click anywhere on the board  with  your  RIGHT  mouse
  405. button, this will cycle through the boards for that position.
  406.  
  407. Each column has four boards. If the board in a column is  a  long  board
  408. the other three are hidden below it and 3 clicks will top each of  these
  409. boards in turn, a fourth click will show the first board again.  If  the
  410. column has two short boards, then 2 of the four boards  are  already  in
  411. view and each of the short boards has only one  other  board  under  it,
  412. hence 1 click on a short board will top the board underneath and another
  413. click will then return to the initial board.
  414.  
  415.  
  416. Deleting A Board
  417. ----------------
  418.  
  419. Go back to the Board dialogue for the board to be  deleted,  and  change
  420. the contents of the text boxes to :-
  421.  
  422.     TITLE = UNUSED SOURCE PATH = DESTINATION PATH =  DESTINATION  FILE  =
  423.     LIVE EXT = EXT DEAD EXT = EXX
  424.     
  425. To wipe a path, click on it to bring up the file selector and wipe  PATH
  426. (put the cursor in the PATH box and press ESC).
  427.  
  428.  
  429. Buttons
  430. =======
  431.  
  432. At the bottom of the screen are three rows of nine buttons, all of these
  433. buttons can have a particular set-up assigned to them.  There  are  only
  434. nine buttons per row because of the font size and number  of  characters
  435. (8) used for the legend on each key, if it were  smaller  it  would  not
  436. look as good. Twenty-seven set-ups should be enough for everyone.
  437.  
  438. To select them you can either click the mouse on them or you can  use  a
  439. function key. The top row can be accessed by pressing just the  function
  440. key (F1-F9), the middle row needs the Control key to  be  pressed  while
  441. the function key is being pressed (CTRL F1-CTRL F9) and the  bottom  row
  442. needs the Alternate to be pressed while the function key is pressed (ALT
  443. F1-ALT F9). To make things a little easier to  remember  (there  are  no
  444. prompts about which modifier key to  use,  Control  or  Alternate),  the
  445. Control key is physically above the Alternate key on  the  keyboard  and
  446. the screen buttons which use the Control key (middle row) are physically
  447. above the buttons which use the Alternate key (bottom row).
  448.  
  449. Once you have set up the boards, you can begin assigning combinations of
  450. files, a screen resolution and a auto-booting  program  to  one  of  the
  451. buttons at the bottom of the screen.
  452.  
  453. 1. Select all of the files on the boards that you want to be active  for
  454.    a particular task (do not forget that  the  hidden  panels  may  have
  455.    selected files (use the CLEAR button to de-select all files).
  456.  
  457. 2. Choose your resolution, if you want to use a Falcon screen mode first
  458.    choose the number of colours required by clicking on one of the  five
  459.    buttons labelled 2,4,16,256 and TC (top left of control panel),  then
  460.    adjust the number of horizontal pixels (640 or 320) and the  vertical
  461.    resolution (480 or 240 pixels) by clicking  on  the  2  buttons  just
  462.    below the colour resolution buttons.
  463.  
  464. 3. Click on the BUTTON button (right side of control  panel).  Click  on
  465.    the button you want to assign the current set up to, a dialogue  will
  466.    appear.
  467.  
  468. LEGEND : Here you can enter two lines of text which will appear  on  the
  469. button, example DTP and 2 could be used to denote a  DTP  set  up  in  2
  470. colours (monochrome). Use the mouse, TAB or the arrow keys  to  move  to
  471. the second line.
  472.  
  473. AUTO BOOT : Clicking on this text box will bring up the  file  selector,
  474. you can then choose the program you want to run.
  475.  
  476. OK and CANCEL have their usual meanings. The same editing keys used  for
  477. the BOARD dialogue are also used with this dialogue.
  478.  
  479. Do not forget to SAVE the changes!
  480.  
  481.  
  482. Deleting a Button
  483. -----------------
  484.  
  485. Click on the DELETE button (lower right of control panel) and then click
  486. on the button to be deleted.
  487.  
  488. Do not forget to SAVE the changes!
  489.  
  490.  
  491. Using a Button
  492. --------------
  493.  
  494. Once a preset button has been set up, a single mouse click is  all  that
  495. is needed to use it. When this happens, Stoop displays the configuration
  496. belonging to the button and then changes the files (selected  files  are
  497. made active, un-selected are made inactive), it then changes NEWDESK.INF
  498. so that the correct screen resolution will be used  and  that  the  auto
  499. boot program (if there is one) is automatically  run  when  the  Desktop
  500. starts up.
  501.  
  502. *** WARNING *** While  Stoop  does  and  display  files  containing  odd
  503. characters in their names, it cannot assign them properly to a button or
  504. group. However these file names cause BIG problems if you  try  to  hide
  505. them from Stoop (see section on the file selector later on).
  506.  
  507. Passing Parameters to Auto-Booting Programs
  508. ===========================================
  509.  
  510. Stoop can now pass parametrs to auto-booting programs,  though  this  is
  511. not reliable as it should be because of bugs in TOS 4 or Lattice C which
  512. do not allow the path for a drive or partition to  be  set.  Environment
  513. strings can also be set at the same time.
  514.  
  515. To pass parameters to a program another program is needed, in this  case
  516. Launcher.prg, which is run instead of  the  required  program  and  then
  517. calls the program that you want to use. Launcher has to load in details,
  518. prepared by Stoop, which contain the program's name and the  other  data
  519. such as the filename(s) to be passed and the environment strings  to  be
  520. set.
  521.  
  522.  
  523. Setting Up Stoop for Passing Parameters
  524. ---------------------------------------
  525.  
  526. The parameters are attached to the  preset  buttons  so  that  when  you
  527. select a preset configuration to be set up the parameters will be set up
  528. as well.
  529.  
  530. To set up for passing parameters, set up a button for normal  operation,
  531. see the section 'Deleting A Button', but after you have given the button
  532. a name select the LAUNCH button on the dialogue.  A  new  dialogue  will
  533. appear which has two windows, called tail and environment.
  534.  
  535. These windows can be have text entered into them in two  ways,  you  can
  536. type directly into them or you can  use  the  file  selector  to  either
  537. insert the text from a file or the full name of the file in the  window.
  538. Whatever you choose, the new text will appear at the cursor position.
  539.  
  540. The tail window should contain  the  parameters  to  be  passed  to  the
  541. program you want  to  use,  this  includes  filenames  or  command  line
  542. parameters.
  543.  
  544. To enter text into either window using the file selector.
  545.  
  546. First move the cursor to the line where you want the text to appear (see
  547. below for keyboard commands), then call the file selector with the  FSEL
  548. button, select the file you want and  press  OK.  Another  dialogue  now
  549. appears, this gives you three choices; INSERT, PUT NAME or ABORT.
  550.  
  551. INSERT - Choosing this button will put the text contained  in  the  file
  552. into your window. (WARNING - only try this with small files of about 10k
  553. length).
  554.  
  555. PUT NAME - This will put the file name, including it's full path, in the
  556. window.
  557.  
  558. ABORT - Allows you to abort making changes to the text in the window.
  559.  
  560. Example, if the program for which you  are  setting  the  button  up  is
  561. Gemview, you can put the names of picture  files  you  want  Gemview  to
  562. automatically load and display when you  auto-boot  it.  (Use  the  FSEL
  563. button and PUT NAME to enter the picture files, you can only do this one
  564. at a time.)
  565.  
  566.  
  567. Text Window Keyboard Commands
  568. -----------------------------
  569.  
  570. The four cursor keys move the cursor as normal (left, right, up or  down
  571. one space).
  572.  
  573. Holding a SHIFT key down with either of the left and right  cursor  keys
  574. to move the cursor to the start or end of the current line respectively.
  575.  
  576. Holding a SHIFT key down with either of the up and down cursor keys will
  577. page the text up or down respectively.
  578.  
  579. RETURN will add a new line below the current line the cursor is  on.  If
  580. the cursor is in the middle of the line, the text will be split  between
  581. the lines.
  582.  
  583. DELETE will delete the character the cursor is covering. If  the  cursor
  584. is at the end of the line, this line and the one below will  be  joined,
  585. (any characters over the maximum character line length will be  left  on
  586. the next line).
  587.  
  588. BACKSPACE will delete the character in  front  of  the  cursor.  If  the
  589. cursor is at the start of the line, this line and the one above will  be
  590. joined, (any characters over the maximum character line length  will  be
  591. left on the line).
  592.  
  593. TAB will change the window the cursor is in (this may also be done  with
  594. a click of the mouse on the requred window).
  595.  
  596. CTRL - Y (hold the Control key down, press Y key before  letting  go  of
  597. Control) will delete the current line. (BUG - the first line  cannot  be
  598. deleted in this way, to get around this put  the  cursor  on  the  first
  599. character and press return to move the line to the  next  row  and  then
  600. delete, or just use the Backspace and Delete keys to  remove  individual
  601. characters.)
  602.  
  603. CTRL - U (hold the Control key down, press U key before  letting  go  of
  604. Control) will put the last line to be deleted by CTRL - Y at the current
  605. position of the cursor.
  606.  
  607. These commands are fairly basic, but they are not intended  to  be  used
  608. with large amounts of text.
  609.  
  610. NB. The maximum line length is 125 characters, if  this  is  too  small,
  611. please let me know.
  612.  
  613.  
  614. Environment Options
  615. -------------------
  616.  
  617. Just below the Environment window are two recessed displays clicking  on
  618. the  first  of  these  will  present  options  which  can  increase  the
  619. usefulness of environment strings.
  620.  
  621. The options will appear on a pop-up window in the middle of the  screen,
  622. they are :-
  623.  
  624. SEND TO PROGRAM ONLY - this is the default setting, the contents of  the
  625. environment window are sent to the launcher program which then sets them
  626. up for the program it will launch.
  627.  
  628. SEND TO FILE ONLY - the environment window contents are sent to a  file,
  629. the name of the file can be chosen using the file selector  by  clicking
  630. on the second recessed display.
  631.  
  632. This will allow users of MultiTos to edit a MINT _or_ GEM  configuration
  633. file before launching MultiTos. Other programs which  have  an  editable
  634. configuration file may also benefit from this option.
  635.  
  636. If this is popular, I will add the ability to edit more than one file.
  637.  
  638. IGNORE ENVIRONMENT - the contents of the environment window are not used
  639. in any way.
  640.  
  641.  
  642. Problems With Passing Parameters
  643. --------------------------------
  644.  
  645. For some reason unknown to me, I cannot set the current path on a drive.
  646. This is a bug in either TOS 4.04 or in Lattice C  5.60.  Please  let  me
  647. know if this is a known bug - and if a fix is possible.
  648.  
  649. This only causes problems with a few programs which I believe  look  for
  650. their .RSC and .INF files in the current  directory  for  their  current
  651. drive. The only program that I found that does this is  Papyrus  and  to
  652. get around it put the .RSC and .INF files  it  looks  for  in  the  root
  653. directory of drive C (or A if you do not have a harddrive).
  654.  
  655. Hopefully, I can come up with a better solution to this problem for  the
  656. next release.
  657.  
  658.  
  659. Groups
  660. ======
  661.  
  662. A set of files can be assigned to a Group, this allows  you  to  set  up
  663. groups of common files this makes setting up preset buttons quicker  but
  664. is more useful for when you want start  up  your  Falcon  in  a  one-off
  665. configuration.
  666.  
  667. Example, the files UISIII(.PRG) in the AUTO folder could be grouped with
  668. CALL_UIS(.ACC) and assigned to a group called UIS, when UIS  is  clicked
  669. on both of these files will be selected.
  670.  
  671. To set up a group :-
  672.  
  673. 1. Select the files on the boards you want  assign  to  the  group,  all
  674.    other files must be inactive.
  675.  
  676. 2. Click on the GROUP button (right side  of  control  panel)  and  then
  677.    click on the GROUP board, a simple dialogue will appear.
  678.  
  679. 3. Type in the name to be given to the group. Then exit. The  name  will
  680.    appear in alphabetical order on the GROUP board.
  681.  
  682.  
  683. Using a Group
  684. -------------
  685.  
  686. To click the left mouse button on the group name to select all the files
  687. associated with it. Clicking with the right button  on  the  group  name
  688. will de-select all the names associated with it.
  689.  
  690. If a file is included in two (or more) groups it can be selected by  one
  691. group and de-selected by the  other  during  use,  this  may  cause  you
  692. problems.
  693.  
  694.  
  695. Deleting A Group
  696. ----------------
  697.  
  698. Click on the DELETE button, then click on the group name  on  the  GROUP
  699. board to be deleted.
  700.  
  701. *** WARNING *** While  Stoop  does  and  display  files  containing  odd
  702. characters in their names, it cannot assign them properly to a button or
  703. group. However these file names cause BIG problems if you  try  to  hide
  704. them from Stoop (see the next section).
  705.  
  706.  
  707. The File Selector
  708. =================
  709.  
  710. The file selector is divided into several main parts; the PATH and  FILE
  711. text boxes which can be manually edited, the file & folder display area,
  712. the drive buttons, the file utility buttons and the OK & CANCEL buttons.
  713.  
  714. The file selector offers some of  the  extended  facilities  offered  by
  715. enhanced GEM file selectors, namely it can COPY, DELETE, MOVE and RENAME
  716. files and folders, it can also create folders.
  717.  
  718. There are also two Stoop specific functions it can  carry  out,  it  can
  719. re-order the AUTO folder and it can hide files from Stoop so  that  they
  720. cannot be displayed on the boards, but the file selector can still  show
  721. them (so that you can un-hide them).
  722.  
  723. To select a file, just click on it and do this again to de-select it  or
  724. select another file.
  725.  
  726. To enter a folder, just click on it. To select a folder, hold  down  the
  727. SHIFT key on the keyboard as you click on it.
  728.  
  729. To select multiple files and folders, hold down a SHIFT key as you click
  730. on each one. There is NO lasso function using the mouse (I will put  one
  731. in soon).
  732.  
  733.  
  734. Copying Folders & Files
  735. -----------------------
  736.  
  737. 1. Choose the files and folders you want to copy.
  738.  
  739. 2. Click on the COPY button.
  740.  
  741. 3. Select the folder or drive to copy them to.
  742.  
  743. 4. Press RETURN or click on OK.
  744.  
  745. Files cannot be copied on top of themselves, if you try  this  all  copy
  746. operations are ignored.
  747.  
  748.  
  749. Moving Folders & Files
  750. ----------------------
  751.  
  752. 1. Choose the files and folders you want to move.
  753.  
  754. 2. Click on the MOVE button.
  755.  
  756. 3. Select the folder or drive to move them to.
  757.  
  758. 4. Press RETURN or click on OK.
  759.  
  760. Files cannot be moved on top of themselves, if you  try  this  all  move
  761. operations are ignored.
  762.  
  763.  
  764. Deleting Folders & Files
  765. ------------------------
  766.  
  767. 1. Choose the files and folders you want to delete.
  768.  
  769. 2. Click on the DELETE button.
  770.  
  771.  
  772. Renaming Folders & Files
  773. ------------------------
  774.  
  775. 1. Select the file or folder to be renamed, it's name should  appear  in
  776.    the FILENAME text box.
  777.  
  778. 2. Click on the RENAME button.
  779.  
  780. 3. Edit the name in FILENAME to the new name.
  781.  
  782. 4. Click on the RENAME button or press RETURN or click on OK.
  783.  
  784.  
  785. Creating Folders
  786. ----------------
  787.  
  788. 1. Type in the name of the new folder in the FILENAME text box.
  789.  
  790. 2. Click on the FOLDER button.
  791.  
  792.  
  793. Re-Ordering the AUTO Folder
  794. ---------------------------
  795.  
  796. 1. Click on the REORDER button, the file selector should now display the
  797.    contents of the AUTO folder on the boot drive.
  798.  
  799. 2. Click on the file you want to move.
  800.  
  801. 3. Click on the position you want it to be moved to.
  802.  
  803. 4. Repeat these actions as many times as you require.
  804.  
  805. 5. Click on the REORDER button or press RETURN or click on OK, the files
  806.    will then be re-ordered.
  807.  
  808. Note : folders in the AUTO folder cannot be re-ordered.
  809.  
  810.  
  811. Hiding Files from Stoop
  812. -----------------------
  813.  
  814. 1. Select the file to be hidden from Stoop.
  815.  
  816. 2. Click on the HIDE button.
  817.  
  818. The hidden file will still be visible on the file selector but it's name
  819. will be in grey rather than black. If the hidden file was visible  on  a
  820. board before you hid it, it will disappear from there when you exit  the
  821. file selector.
  822.  
  823. The details of the hidden files have to be added to Stoop's INF file, so
  824. remember to SAVE after hiding a file.
  825.  
  826. *** WARNING *** Do not hide files which contain  odd  characters,  while
  827. Stoop can display the names of such files it has problems with them  and
  828. CAN cause STOOP.CFG to crash Stoop. Try renaming the offending file.
  829.  
  830.  
  831. Main Controls
  832. =============
  833.  
  834. GO & EXIT Buttons
  835.  
  836. GO : This causes the Stoop to change all selected files on the boards to
  837. be made active and all un-selected  files  to  become  inactive,  copies
  838. required files to folders and then changes the NEWDESK.INF file so  that
  839. the Desktop will start up  in  the  selected  resolution  and  boot  the
  840. current AUTO BOOT program.
  841.  
  842. Stoop then exits, the AUTO folder programs are run, the accessories  are
  843. loaded and then the Desktop appears.
  844.  
  845. GO is provided so that you can make and  use  a  start-up  configuration
  846. without having to assign it to a button, or make a small  change  to  an
  847. configuration (e.g.    existing  change   the   number   of   colours   or
  848. resolution), see the information below.
  849.  
  850. EXIT : Clicking on this causes Stoop to exit  without  making  a  single
  851. change to files or NEWDESK.INF.
  852.  
  853.  
  854. Option Controls
  855. ===============
  856.  
  857. The six buttons near the bottom of the control panel make  Stoop  a  bit
  858. easier to use.
  859.  
  860. FSEL : Brings up the file selector.
  861.  
  862. DELETE : Used to wipe start up configurations  assigned  to  the  preset
  863. buttons or wipe Simply click on the DELETE button and then on the button
  864. groups.    or group to be wiped.
  865.  
  866. Remember to SAVE the changes afterwards!
  867.  
  868. SAVE : Saves all the data Stoop needs to remember your requirements.
  869.  
  870. CLEAR : De-selects all files on all boards.
  871.  
  872. CONFIG : This has not yet been implemented. It will allow the user  some
  873. control over Stoop (e.g. colours, etc).
  874.  
  875. INITIAL : Clicking on this button causes all the files on all the boards
  876. to be changed to their initial setting (active or inactive)  when  Stoop
  877. was first started up.
  878.  
  879.  
  880. Auto-Booting Programs
  881. =====================
  882.  
  883. Stoop loads NEWDESK.INF from your boot  partition  (if  it  exists)  and
  884. reads the current auto-program,  this   is   then   displayed   in   the
  885. AUTO-PROGRAM box at the bottom of the control panel.
  886.  
  887. When you select a button which has an auto-booting program then the  box
  888. will display the name of the program.
  889.  
  890. The program can also be selected by clicking on  the  AUTO-PROGRAM  box,
  891. this will bring up the file  selector  so  that  you  can  choose  which
  892. program you require.
  893.  
  894.  
  895. Manual Start Up Configurations
  896. ==============================
  897.  
  898. Sometimes you may want to use a particular start up  configuration  just
  899. once, and as it does need to be used again  assigning  it  to  a  preset
  900. waste of time.    button is a This is what to do instead :-
  901.  
  902. 1. Set up the files on the boards as you want them  (I  often  show  the
  903.    contents of a preset (by using the right mouse button), which has the
  904.    nearest configuration to what I require, to give a position to  start
  905.    from).
  906.  
  907. 2. If you want to auto-boot a program, click on the AUTO BOOT  text  box
  908.    (near the bottom of the control panel), this will bring up  the  file
  909.    selector. Select the file you want and exit.
  910.  
  911. 3. Click on GO.
  912.  
  913. Example
  914. -------
  915.  
  916. How to change the resolution of a preset configuration from  16  to  256
  917. colours.
  918.  
  919. 1. Show the contents of the preset by clicking the right mouse button on
  920. the preset button.
  921.  
  922. 2. Make the change by clicking on the 256 button.
  923.  
  924. At this point you have three options, you can:-
  925.  
  926. (i) use the BUTTON button to re-assign the new configuration to the  old
  927.       preset button, (ii)  use the  BUTTON  button  to  assign  the  new
  928. configuration to another preset button and (iii) press  GO,  which  will
  929. use the current set-up without saving it so that it might be used again.
  930.  
  931.  
  932.