**************** * STOOP Manual * ****************

Version 1.03


Hardware Required =================

Atari Falcon with 4Mb RAM and a VGA or SVGA display is recommended  (the
screen resolution needed for  Stoop  is  a  minimum  640  x  480  by  16
colours).


Contents ========

Introduction
	Getting Started 
	VGA or SVGA Monitors 
	RGB monitors
	Televisions
   Installing Stoop

Setting Up Stoop

Boards
	Editing a Board
	Changing Boards
	Deleting a Board

Buttons
	Deleting a Button
	Using a Button

Passing Parameters to Auto-Booting Programs
	Setting Up Stoop for Passing Parameters
	Text Window Keyboard Commands
	Environment Options
	Problems With Passing Parameters
	
Groups
	Using a Group
	Deleting a Group

The File Selector
	Copying Folders & Files
	Moving Folders & Files
   Deleting Folders & Files
   Renaming Folders & Files
   Creating Folders
   Re-Ordering the AUTO Folder
   Hiding Files from Stoop

Main Controls
	Option Controls
	Auto-Booting Programs

Manual Start Up Configurations



Introduction
============

Stoop is a boot manager for the Atari Falcon. It has its  own  graphical
interface and uses the mouse for most operations but it does  make  some
use of the keyboard.

Stoop can :

 Be used to determine which AUTO programs, accessories, CPX modules and
  NEWDESK.INF files should be active when starting up or re-booting.
  
 Control other types of file (e.g. GDOS ASSIGN.SYS files) to a  maximum
  of 20 different types.

 Display up to 128 file names in each of 20 boards. These  boards  have
  to be paged to view all of the file names,  but  paging  buttons  will
  only appear when necessary.

 Either change the extension of a file name to make it active/inactive,
  e.g. ACX is changed to ACC and vice versa, (the file may be also moved
  to another folder at the same time) this can be done for a maximum  of
  254 files per file type. Or a single file can copied and renamed to  a
  specific name, e.g. C:\AUTO\STOOP\GENERAL.INF may become NEWDESK.INF.

 Make groups of files which may be selected or de-selected by a  single
  button press, to a maximum of 50 files per board per group, and  since
  there is a maximum of 20  boards  a  maximum  of  1000  files  can  be
  assigned per group (but you wouldn't like the slow program start-up).

 Control the screen  resolution  of  the  desktop  that  appears  after
  booting, including starting  up  in  ST  compatible  screens,  without
  having to use a specific NEWDESK.INF file.

 Change the application the desktop runs after boot-up.

 Store often used start-up configurations on buttons, to a  maximum  of
27.

 Copy, delete and move folders and files, and also rename files,  using
  its own file selector.

 Re-order the contents of the AUTO folder.

 Hide files from itself so that they cannot be selected/de-selected for
  boot-up by error. Up to 50 files can be hidden.
	
 Be easily configured while running from the AUTO folder.

This program has an element of overkill, it can store enough details  to
control at least 100,000 files and uses a proportionate amount of memory
to do so, hence this program runs only in 4 Mbytes.

However, if you would like to run it on a 1Mb Falcon drop a line  to  me
(with your registration, of course) and  I  will  see  what  I  can  do.
Conversely, if you find the large numbers of  files  and  boards  useful
tell me before they get cut. If there are groups of users in each  camp,
I will produce two versions of Stoop.


Getting Started
===============

First, make sure that your system can run STOOP.PRG  when  you  boot  by
ensuring that the screen resolution is AT LEAST 640 wide x 480 high x 16
colours. This can be done  from  a  program  called  BOOTCONF.PRG,  this
changes settings held in NVRAM which determine to some  extent  how  the
computer will behave when it is started up.


VGA or SVGA Monitors
--------------------

The relevant settings are :-

	COLOUR  : 	16 VGA
	DISPLAY : 	
	COLUMNS : 	80

(the setting of PAL and NTSC have no effect with VGA, so you can  ignore
it)

The following settings should be OFF

	DOUBLE LINE (VGA)/ INTERLACE (TV) OVERSCAN  (TV  ONLY)  COMPATIBILITY
	MODE


RGB Monitors
------------

The relevant settings are :-

	COLOUR  :	16 NTSC
	DISPLAY :	
	COLUMNS :	80 DOUBLE LINE (VGA)/ INTERLACE (TV) OVERSCAN (TV ONLY)

(setting NTSC should mean that the monitor has a screen refresh of 60 Hz
rather than 50 Hz, I think - I don't have access to an RGB monitor).

The following setting should be OFF

	COMPATIBILITY MODE


Televisions
-----------

The relevant settings  are  the  same  as  for  RGB  monitors  with  one
difference depending upon which TV picture signal standard  is  used  by
your TV, either PAL (as in Britain) or NTSC (as in U.S.A.).


Installing Stoop
================

Your copy of Stoop should be the first program in the AUTO folder to  be
executed for it to work most effectively. To ensure this, Stoop  has  to
be the first entry in the AUTO  folder  directory  because  AUTO  folder
programs are executed in this order.  There  several  methods  of  doing
this, two are listed below :-

(i) Put STOOP.PRG straight into the AUTO folder.

     Do not re-boot at this point!

     Double click on STOOP.PRG to get it running.

     Locate the button on the screen labelled FSEL and click on it.

     Stoop's file selector should now appear.

     Click on the button marked REORDER and the current directory should
     change to the AUTO folder on your boot disk or hard-drive.

     Click on the entry for  STOOP.PRG  in  the  directory  listing,  it
     should then be highlighted.

     Now click on the entry where Stoop should be positioned  (which  is
     the first entry which is not a folder).
	
     The name STOOP.PRG will appear where you have just  indicated,  but
     it has not yet been moved in the folder.
	
     Now click on OK or REORDER, the files will then be physically moved
     on the disk.
	
(ii) Use a program called AUTOSORT.PRG, if you have it.

     To finish, create a folder inside  the  AUTO  folder  and  call  it
     STOOP. This folder is where Stoop  will  store  it's  configuration
     file when you use the SAVE button.

*** WARNING *** Currently, Stoop is incompatible with NVDI 2.5  (version
3 has not been tested) hence make sure that NVDI runs  after  Stoop.  If
you do run Stoop after NVDI, press Control+C to escape from Stoop.


Setting Up Stoop
================

To start up Stoop after installation, you can either re-boot or  run  it
from the Desktop. When you have started Stoop up you should see a screen
divided into three main areas; the largest area is the boards where  all
of the files will be displayed, to the right of it is the control  panel
containing various buttons with a  board  labelled  GROUPS  and  at  the
bottom of the screen are 27 buttons which can be used  to  store  preset
start up configurations.


Boards
======

The first step should be to arrange the boards to display  the  required
files. Each board shows the files which  match  one  of  two  extensions
(e.g. PRG and PRX) that exist in one folder or root directory.

There are 5 boards which you can  re-configure,  each  one  can  have  4
different faces. Each board can be displayed as either one long board or
two short ones. When you first run Stoop there may not  be  a  STOOP.CFG
file present which contains the  configuration  information  for  Stoop,
hence Stoop will use it's default configuration. The  first  two  boards
should show the program files in the AUTO folder and the accessories  on
the root directory of your boot drive. These boards may  be  altered  to
show different types of file  (different  file  extensions)  and/or  the
files in different folders or drives.

To alter a board, click on the BOARD button (right hand side of  screen)
and then click on the board you want to change. A dialogue should pop up
which displays the current details of that particular board:-

TITLE : The name of the board which is displayed just above the  top  of
the board.

SOURCE PATH : The folder or drive which will hold the files to be  shown
on the board.

DESTINATION PATH : The folder or drive which the file or files  will  be
copied to (this MUST be given even if it  is  the  same  as  the  SOURCE
PATH).

DESTINATION FILE : The name that will be given to a single file once  it
has been copied. If this box contains any text then only one file may be
selected on the board at any one time, otherwise  any  number  (zero  to
all) of files can be selected.

LIVE & DEAD EXTS : These are the file extensions of the files that  will
be shown on the board. The 'live' extension is the one that active files
have (e.g. PRG or ACC) while  the  'dead'  extension  is  the  one  that
inactive files will be given which usually terminates with an 'X'  (e.g.
PRX or ACX).

SHORT/LONG button : This button will toggle between  showing  SHORT  and
LONG on it's surface. When it shows LONG, one long board will appear  at
the chosen position and it will display up to 34 file names, and when it
shows SHORT there will be 2 short boards displayed showing up to 16 file
names each.

OK and CANCEL : These have their usual meanings, they both let the  user
quit the dialogue but OK confirms any changes and CANCEL ignores them.  


Most of the above is straight forward, but the use  of  the  DESTINATION
FILE needs explaining. Some programs use INF (or similar) files to  hold
data about the program's start up settings, e.g. the Desktop is one such
program and it uses NEWDESK.INF. If you want to start up these  programs
with different settings, depending upon your needs, the INF file has  to
be replaced with another version. For Stoop to do this automatically for
you it needs the name of the INF file, this  is  what  DESTINATION  FILE
should hold.

Example #1
----------

Suppose the dialogue holds the following data :-

	TITLE = NEWDESK SOURCE PATH = C:\AUTO\STOOP DESTINATION  PATH  =  C:\
	DESTINATION FILE = NEWDESK.INF LIVE EXT = INF DEAD EXT =  INX  button
	         = SHORT

This allows a user to have different set-ups for the Desktop. Any  files
contained in C:\AUTO\STOOP (but not any folders within it) that have INF
or INX extensions will be displayed upon the board, INF  files  will  be
highlighted and INX files will not.

The SHORT button means that two short boards will be shown in the chosen
column, the other board may appear above or  below  the  board  you  are
setting up.

Suppose that the folder C:\AUTO\STOOP contains these three files:-

	GENERAL.INX DTP.INX SBLASTER.INF

Their names will appear on the  board  without  their  extensions,  only
SBLASTER is highlighted as it's extension is 'live' (it has INF for it's
extension).

Selecting GENERAL on  the  board  will  highlight  it  and  un-highlight
SBLASTER. Clicking on the GO button will cause GENERAL.INF to be  copied
to drive C and named NEWDESK.INF (the previous  NEWDESK  file  is  first
deleted).

Example #2
----------

Suppose the boxes hold the following data :-

	TITLE =  ACCESSORIES  SOURCE  PATH  =  C:\  DESTINATION  PATH  =  C:\
	DESTINATION FILE = LIVE EXT   =   ACC   DEAD   EXT   =   ACX   button
	= LONG
	
This allows a user to change the accessories loaded  at  boot  up.  Note
that DESTINATION FILE should contain no text.

With this information, Stoop  will  show  all  the  files  in  the  root
directory of drive C which have either ACC  or  ACX  extensions  on  the
board. Files with 'live' extenders (ACC) will be highlighted while files
with 'dead' extensions will not. Clicking on a 'dead' file will make  it
live without changing the status of any other file  and  clicking  on  a
'live' file will make it 'dead'.

Clicking on GO will cause all files to be  renamed  according  to  their
status on the board, highlighted names become 'live' (they are given the
ACC extension) and all of the others are 'killed' (given ACX extenders).

Note that although TOS 4 only allows a maximum of 6  accessories  to  be
loaded at any one time, Stoop will not stop you from selecting more than
6 accessories.

If the SOURCE  and  DESTINATION  PATH's  were  different  in  the  above
example, the files would be re-named and they would  be  copied  to  the
DESTINATION PATH, but  please  note  that  any  existing  files  in  the
DESTINATION PATH would be unaffected. Hence avoid using different SOURCE
and DESTINATION PATH's when multiple files are to be made  'live'  (i.e.
DESTINATION FILE is undefined) as any files copied there by Stoop during
a previous boot up will still be there.

The LONG button means that one long board will be shown  in  the  chosen
column.


Editing A Board
---------------

Now that you now what the boards can do, how do you change  them  to  do
what you want?

There are basically two types  of  boxes  which  contain  text  on  this
dialogue,

(i) Boxes which can be edited manually by placing the cursor in  it  and
     adding characters from the keyboard.

(ii) Boxes which you click on and this brings up the file selector. This
     type is used to hold file paths and names which  are  selected  via
     the file selector.

TITLE : If the text cursor is not in the Title box you can (i) click the
mouse on it, (ii) press TAB or (iii) press the up or down arrow keys  to
move it into the box. You can then type the  new  name,  BACKSPACE  will
delete back one character and ESC will clear all of  the  text.  Do  not
press RETURN or ENTER unless you want to exit the dialogue  and  confirm
the changes (this is equivalent to clicking on the OK button).

SOURCE PATH : Click the mouse on the text area of  this  box,  the  file
selector will appear and you can choose the path you require.

DESTINATION PATH : Use the same procedure as for the SOURCE PATH.

DESTINATION FILE : Use the same procedure for the Title text box.

LIVE EXT : Use the same procedure for the Title text box.

DEAD EXT : Use the same procedure for the Title text box.

SHORT/LONG : Click on this to toggle it's setting.

Remember to SAVE the changes you make!


Changing Boards
---------------

There are 20 boards, but only five to ten can be shown at any one  time,
to show the others click anywhere on the board  with  your  RIGHT  mouse
button, this will cycle through the boards for that position.

Each column has four boards. If the board in a column is  a  long  board
the other three are hidden below it and 3 clicks will top each of  these
boards in turn, a fourth click will show the first board again.  If  the
column has two short boards, then 2 of the four boards  are  already  in
view and each of the short boards has only one  other  board  under  it,
hence 1 click on a short board will top the board underneath and another
click will then return to the initial board.


Deleting A Board
----------------

Go back to the Board dialogue for the board to be  deleted,  and  change
the contents of the text boxes to :-

	TITLE = UNUSED SOURCE PATH = DESTINATION PATH =  DESTINATION  FILE  =
	LIVE EXT = EXT DEAD EXT = EXX
	
To wipe a path, click on it to bring up the file selector and wipe  PATH
(put the cursor in the PATH box and press ESC).


Buttons
=======

At the bottom of the screen are three rows of nine buttons, all of these
buttons can have a particular set-up assigned to them.  There  are  only
nine buttons per row because of the font size and number  of  characters
(8) used for the legend on each key, if it were  smaller  it  would  not
look as good. Twenty-seven set-ups should be enough for everyone.

To select them you can either click the mouse on them or you can  use  a
function key. The top row can be accessed by pressing just the  function
key (F1-F9), the middle row needs the Control key to  be  pressed  while
the function key is being pressed (CTRL F1-CTRL F9) and the  bottom  row
needs the Alternate to be pressed while the function key is pressed (ALT
F1-ALT F9). To make things a little easier to  remember  (there  are  no
prompts about which modifier key to  use,  Control  or  Alternate),  the
Control key is physically above the Alternate key on  the  keyboard  and
the screen buttons which use the Control key (middle row) are physically
above the buttons which use the Alternate key (bottom row).

Once you have set up the boards, you can begin assigning combinations of
files, a screen resolution and a auto-booting  program  to  one  of  the
buttons at the bottom of the screen.

1. Select all of the files on the boards that you want to be active  for
   a particular task (do not forget that  the  hidden  panels  may  have
   selected files (use the CLEAR button to de-select all files).

2. Choose your resolution, if you want to use a Falcon screen mode first
   choose the number of colours required by clicking on one of the  five
   buttons labelled 2,4,16,256 and TC (top left of control panel),  then
   adjust the number of horizontal pixels (640 or 320) and the  vertical
   resolution (480 or 240 pixels) by clicking  on  the  2  buttons  just
   below the colour resolution buttons.

3. Click on the BUTTON button (right side of control  panel).  Click  on
   the button you want to assign the current set up to, a dialogue  will
   appear.

LEGEND : Here you can enter two lines of text which will appear  on  the
button, example DTP and 2 could be used to denote a  DTP  set  up  in  2
colours (monochrome). Use the mouse, TAB or the arrow keys  to  move  to
the second line.

AUTO BOOT : Clicking on this text box will bring up the  file  selector,
you can then choose the program you want to run.

OK and CANCEL have their usual meanings. The same editing keys used  for
the BOARD dialogue are also used with this dialogue.

Do not forget to SAVE the changes!


Deleting a Button
-----------------

Click on the DELETE button (lower right of control panel) and then click
on the button to be deleted.

Do not forget to SAVE the changes!


Using a Button
--------------

Once a preset button has been set up, a single mouse click is  all  that
is needed to use it. When this happens, Stoop displays the configuration
belonging to the button and then changes the files (selected  files  are
made active, un-selected are made inactive), it then changes NEWDESK.INF
so that the correct screen resolution will be used  and  that  the  auto
boot program (if there is one) is automatically  run  when  the  Desktop
starts up.

*** WARNING *** While  Stoop  does  and  display  files  containing  odd
characters in their names, it cannot assign them properly to a button or
group. However these file names cause BIG problems if you  try  to  hide
them from Stoop (see section on the file selector later on).

Passing Parameters to Auto-Booting Programs
===========================================

Stoop can now pass parametrs to auto-booting programs,  though  this  is
not reliable as it should be because of bugs in TOS 4 or Lattice C which
do not allow the path for a drive or partition to  be  set.  Environment
strings can also be set at the same time.

To pass parameters to a program another program is needed, in this  case
Launcher.prg, which is run instead of  the  required  program  and  then
calls the program that you want to use. Launcher has to load in details,
prepared by Stoop, which contain the program's name and the  other  data
such as the filename(s) to be passed and the environment strings  to  be
set.


Setting Up Stoop for Passing Parameters
---------------------------------------

The parameters are attached to the  preset  buttons  so  that  when  you
select a preset configuration to be set up the parameters will be set up
as well.

To set up for passing parameters, set up a button for normal  operation,
see the section 'Deleting A Button', but after you have given the button
a name select the LAUNCH button on the dialogue.  A  new  dialogue  will
appear which has two windows, called tail and environment.

These windows can be have text entered into them in two  ways,  you  can
type directly into them or you can  use  the  file  selector  to  either
insert the text from a file or the full name of the file in the  window.
Whatever you choose, the new text will appear at the cursor position.

The tail window should contain  the  parameters  to  be  passed  to  the
program you want  to  use,  this  includes  filenames  or  command  line
parameters.

To enter text into either window using the file selector.

First move the cursor to the line where you want the text to appear (see
below for keyboard commands), then call the file selector with the  FSEL
button, select the file you want and  press  OK.  Another  dialogue  now
appears, this gives you three choices; INSERT, PUT NAME or ABORT.

INSERT - Choosing this button will put the text contained  in  the  file
into your window. (WARNING - only try this with small files of about 10k
length).

PUT NAME - This will put the file name, including it's full path, in the
window.

ABORT - Allows you to abort making changes to the text in the window.

Example, if the program for which you  are  setting  the  button  up  is
Gemview, you can put the names of picture  files  you  want  Gemview  to
automatically load and display when you  auto-boot  it.  (Use  the  FSEL
button and PUT NAME to enter the picture files, you can only do this one
at a time.)


Text Window Keyboard Commands
-----------------------------

The four cursor keys move the cursor as normal (left, right, up or  down
one space).

Holding a SHIFT key down with either of the left and right  cursor  keys
to move the cursor to the start or end of the current line respectively.

Holding a SHIFT key down with either of the up and down cursor keys will
page the text up or down respectively.

RETURN will add a new line below the current line the cursor is  on.  If
the cursor is in the middle of the line, the text will be split  between
the lines.

DELETE will delete the character the cursor is covering. If  the  cursor
is at the end of the line, this line and the one below will  be  joined,
(any characters over the maximum character line length will be  left  on
the next line).

BACKSPACE will delete the character in  front  of  the  cursor.  If  the
cursor is at the start of the line, this line and the one above will  be
joined, (any characters over the maximum character line length  will  be
left on the line).

TAB will change the window the cursor is in (this may also be done  with
a click of the mouse on the requred window).

CTRL - Y (hold the Control key down, press Y key before  letting  go  of
Control) will delete the current line. (BUG - the first line  cannot  be
deleted in this way, to get around this put  the  cursor  on  the  first
character and press return to move the line to the  next  row  and  then
delete, or just use the Backspace and Delete keys to  remove  individual
characters.)

CTRL - U (hold the Control key down, press U key before  letting  go  of
Control) will put the last line to be deleted by CTRL - Y at the current
position of the cursor.

These commands are fairly basic, but they are not intended  to  be  used
with large amounts of text.

NB. The maximum line length is 125 characters, if  this  is  too  small,
please let me know.


Environment Options
-------------------

Just below the Environment window are two recessed displays clicking  on
the  first  of  these  will  present  options  which  can  increase  the
usefulness of environment strings.

The options will appear on a pop-up window in the middle of the  screen,
they are :-

SEND TO PROGRAM ONLY - this is the default setting, the contents of  the
environment window are sent to the launcher program which then sets them
up for the program it will launch.

SEND TO FILE ONLY - the environment window contents are sent to a  file,
the name of the file can be chosen using the file selector  by  clicking
on the second recessed display.

This will allow users of MultiTos to edit a MINT _or_ GEM  configuration
file before launching MultiTos. Other programs which  have  an  editable
configuration file may also benefit from this option.

If this is popular, I will add the ability to edit more than one file.

IGNORE ENVIRONMENT - the contents of the environment window are not used
in any way.


Problems With Passing Parameters
--------------------------------

For some reason unknown to me, I cannot set the current path on a drive.
This is a bug in either TOS 4.04 or in Lattice C  5.60.  Please  let  me
know if this is a known bug - and if a fix is possible.

This only causes problems with a few programs which I believe  look  for
their .RSC and .INF files in the current  directory  for  their  current
drive. The only program that I found that does this is  Papyrus  and  to
get around it put the .RSC and .INF files  it  looks  for  in  the  root
directory of drive C (or A if you do not have a harddrive).

Hopefully, I can come up with a better solution to this problem for  the
next release.


Groups
======

A set of files can be assigned to a Group, this allows  you  to  set  up
groups of common files this makes setting up preset buttons quicker  but
is more useful for when you want start  up  your  Falcon  in  a  one-off
configuration.

Example, the files UISIII(.PRG) in the AUTO folder could be grouped with
CALL_UIS(.ACC) and assigned to a group called UIS, when UIS  is  clicked
on both of these files will be selected.

To set up a group :-

1. Select the files on the boards you want  assign  to  the  group,  all
   other files must be inactive.

2. Click on the GROUP button (right side  of  control  panel)  and  then
   click on the GROUP board, a simple dialogue will appear.

3. Type in the name to be given to the group. Then exit. The  name  will
   appear in alphabetical order on the GROUP board.


Using a Group
-------------

To click the left mouse button on the group name to select all the files
associated with it. Clicking with the right button  on  the  group  name
will de-select all the names associated with it.

If a file is included in two (or more) groups it can be selected by  one
group and de-selected by the  other  during  use,  this  may  cause  you
problems.


Deleting A Group
----------------

Click on the DELETE button, then click on the group name  on  the  GROUP
board to be deleted.

*** WARNING *** While  Stoop  does  and  display  files  containing  odd
characters in their names, it cannot assign them properly to a button or
group. However these file names cause BIG problems if you  try  to  hide
them from Stoop (see the next section).


The File Selector
=================

The file selector is divided into several main parts; the PATH and  FILE
text boxes which can be manually edited, the file & folder display area,
the drive buttons, the file utility buttons and the OK & CANCEL buttons.

The file selector offers some of  the  extended  facilities  offered  by
enhanced GEM file selectors, namely it can COPY, DELETE, MOVE and RENAME
files and folders, it can also create folders.

There are also two Stoop specific functions it can  carry  out,  it  can
re-order the AUTO folder and it can hide files from Stoop so  that  they
cannot be displayed on the boards, but the file selector can still  show
them (so that you can un-hide them).

To select a file, just click on it and do this again to de-select it  or
select another file.

To enter a folder, just click on it. To select a folder, hold  down  the
SHIFT key on the keyboard as you click on it.

To select multiple files and folders, hold down a SHIFT key as you click
on each one. There is NO lasso function using the mouse (I will put  one
in soon).


Copying Folders & Files
-----------------------

1. Choose the files and folders you want to copy.

2. Click on the COPY button.

3. Select the folder or drive to copy them to.

4. Press RETURN or click on OK.

Files cannot be copied on top of themselves, if you try  this  all  copy
operations are ignored.


Moving Folders & Files
----------------------

1. Choose the files and folders you want to move.

2. Click on the MOVE button.

3. Select the folder or drive to move them to.

4. Press RETURN or click on OK.

Files cannot be moved on top of themselves, if you  try  this  all  move
operations are ignored.


Deleting Folders & Files
------------------------

1. Choose the files and folders you want to delete.

2. Click on the DELETE button.


Renaming Folders & Files
------------------------

1. Select the file or folder to be renamed, it's name should  appear  in
   the FILENAME text box.

2. Click on the RENAME button.

3. Edit the name in FILENAME to the new name.

4. Click on the RENAME button or press RETURN or click on OK.


Creating Folders
----------------

1. Type in the name of the new folder in the FILENAME text box.

2. Click on the FOLDER button.


Re-Ordering the AUTO Folder
---------------------------

1. Click on the REORDER button, the file selector should now display the
   contents of the AUTO folder on the boot drive.

2. Click on the file you want to move.

3. Click on the position you want it to be moved to.

4. Repeat these actions as many times as you require.

5. Click on the REORDER button or press RETURN or click on OK, the files
   will then be re-ordered.

Note : folders in the AUTO folder cannot be re-ordered.


Hiding Files from Stoop
-----------------------

1. Select the file to be hidden from Stoop.

2. Click on the HIDE button.

The hidden file will still be visible on the file selector but it's name
will be in grey rather than black. If the hidden file was visible  on  a
board before you hid it, it will disappear from there when you exit  the
file selector.

The details of the hidden files have to be added to Stoop's INF file, so
remember to SAVE after hiding a file.

*** WARNING *** Do not hide files which contain  odd  characters,  while
Stoop can display the names of such files it has problems with them  and
CAN cause STOOP.CFG to crash Stoop. Try renaming the offending file.


Main Controls
=============

GO & EXIT Buttons

GO : This causes the Stoop to change all selected files on the boards to
be made active and all un-selected  files  to  become  inactive,  copies
required files to folders and then changes the NEWDESK.INF file so  that
the Desktop will start up  in  the  selected  resolution  and  boot  the
current AUTO BOOT program.

Stoop then exits, the AUTO folder programs are run, the accessories  are
loaded and then the Desktop appears.

GO is provided so that you can make and  use  a  start-up  configuration
without having to assign it to a button, or make a small  change  to  an
configuration (e.g.	existing  change   the   number   of   colours   or
resolution), see the information below.

EXIT : Clicking on this causes Stoop to exit  without  making  a  single
change to files or NEWDESK.INF.


Option Controls
===============

The six buttons near the bottom of the control panel make  Stoop  a  bit
easier to use.

FSEL : Brings up the file selector.

DELETE : Used to wipe start up configurations  assigned  to  the  preset
buttons or wipe Simply click on the DELETE button and then on the button
groups.	or group to be wiped.

Remember to SAVE the changes afterwards!

SAVE : Saves all the data Stoop needs to remember your requirements.

CLEAR : De-selects all files on all boards.

CONFIG : This has not yet been implemented. It will allow the user  some
control over Stoop (e.g. colours, etc).

INITIAL : Clicking on this button causes all the files on all the boards
to be changed to their initial setting (active or inactive)  when  Stoop
was first started up.


Auto-Booting Programs
=====================

Stoop loads NEWDESK.INF from your boot  partition  (if  it  exists)  and
reads the current auto-program,  this   is   then   displayed   in   the
AUTO-PROGRAM box at the bottom of the control panel.

When you select a button which has an auto-booting program then the  box
will display the name of the program.

The program can also be selected by clicking on  the  AUTO-PROGRAM  box,
this will bring up the file  selector  so  that  you  can  choose  which
program you require.


Manual Start Up Configurations
==============================

Sometimes you may want to use a particular start up  configuration  just
once, and as it does need to be used again  assigning  it  to  a  preset
waste of time.	button is a This is what to do instead :-

1. Set up the files on the boards as you want them  (I  often  show  the
   contents of a preset (by using the right mouse button), which has the
   nearest configuration to what I require, to give a position to  start
   from).

2. If you want to auto-boot a program, click on the AUTO BOOT  text  box
   (near the bottom of the control panel), this will bring up  the  file
   selector. Select the file you want and exit.

3. Click on GO.

Example
-------

How to change the resolution of a preset configuration from  16  to  256
colours.

1. Show the contents of the preset by clicking the right mouse button on
the preset button.

2. Make the change by clicking on the 256 button.

At this point you have three options, you can:-

(i) use the BUTTON button to re-assign the new configuration to the  old
      preset button, (ii)  use the  BUTTON  button  to  assign  the  new
configuration to another preset button and (iii) press  GO,  which  will
use the current set-up without saving it so that it might be used again.


