
                            MenuLauncher  v1.2
                            ==================


Requirements:
------------

Kickstart v39+ and associated libraries :
 (dos/exec/intuition/icon/commodities/gadtools etc...).

Reqtools.library v38.xx


Configuration file format:
-------------------------

CNFG
text1
command1
text2
command2
text3
command3
END

... where 'text' is the name that is displayed in the list, and 'command' is
    the command that is to be executed.  This example has 3 commands.  See
    the enclosed example file for more information.

NB: The "CNFG" and "END" markers are _required_ by the program.


Workbench tooltypes:
-------------------

 · TASKPRI=<task priority>

        Sets the priority of the program, values in the range -127 to 10 are
        accepted.

 · CONFIG=<config path and filename>

        Sets the filename and path that the program will get its configuration
        file from. Defaults to 'S:Menu.Config'.

 · PUBLICSCREEN=<publicscreen name>

        Sets the public screen that the program will open the window.
        Defaults to 'Workbench'

 · STACK=<stack size>

        Sets the stack size for all processes launched from this program.
        Values greater than 4095 bytes are accepted. The default is 8192 bytes.

NB: There are no CLI arguments (for now).


Keyboard actions:
----------------

 · <ESC> quits the program

 · <DEL> loads the last-saved settings

 · <ARROW-KEYS> move the window around the screen one pixel at a time

NB: Sending a Ctrl-C break signal to this task will cause the program to exit.


Menu options:
------------

Window:

 · Snapshot     - store current settings in ENVARC:

 · Last-Saved   - reload settings from ENVARC:

 · Quit         - frees all resources and exits the program

Settings:

 · Width        - allows you to specify the window width in characters

 · Height       - allows you to specify the window height in characters

 · BarWidth     - allows you to modify the width of the scroll-bar in pixels

NB:  Each time you alter any settings, or move the window, the position and
 size of the window will be stored in ENV:.  If you wish to keep the current
 settings, select Snapshot from the menu and they will be stored in ENVARC:.


Contact Address:
---------------

For information/source code contact me at:

FidoNet: 2:253/167.4 / AmigaNet: 39:138/16.4


Archive contents:
----------------

topazprop/8     - a font, similar to topaz but with proportional spacing,
                  looks much nicer than topaz 8
topazprop.font

readme.text     - this text file and icon
readme.text.info

Menu            - MenuLauncher; main program and icon
Menu.info

Menu.Config     - configuration file for MenuLauncher

ExampleSetup.iff - an iff file showing how I have MenuLauncher set up
                   on Workbench

PPMore          - text file reader (c) Nico François


Legal stuff:
-----------

 MenuLauncher is (c) Chris Sumner 1994 and it's freely distributable as
 long as all of its files are included in their original form without
 additions, deletions, or modifications of any kind, and only a nominal fee
 is charged for its distribution.

 This software is provided "AS IS" without warranty of any kind, either
 expressed or implied.  Reading Legal mush can turn your brain to guacamole.
 By using MenuLauncher you accept either the whole risk or the quality
 and performance of the program.


Acknowledgements:
----------------

Nico François - Reqtools, PPMore.
Wouter van Oortmerssen - AmigaE.
Steve Hines - QuickGrab.
Iain Hibbert - legal_text from nullmodem.doc.



(1st May 1994 00:25)
