LAUNCHPAD

by Dilwyn Jones


Copyright (C) 2003 Dilwyn Jones


Published by:

Q-Celt Computing, The Falconry, Glenmacnass, Glendalough, County
Wicklow, Ireland.

INTRODUCTION

Launchpad is a program launcher, rather akin to the desktop systems
found on other computers. It is not intended to be anything too
complicated or particularly clever, but serves me quite well. It's
based on code used in the DEV Manager program from Q-Celt Computing,
but with a more graphical front end thanks to the use of Easyptr 3 from
Albin Hessler Software to create this program.

Launchpad was written by Dilwyn Jones. It was created in SBASIC using
Easyptr 3 (Albin Hessler Software) and compiled with QLiberator 3.36
from Liberation Software. Launchpad uses Norman Dunbar's DJToolkit
extensions, plus the Display Code extensions published in QL Today -
both toolkits are supplied linked into the main program.

As with any complex software, it is quite possible that the last bug
will never be eliminated. If you do discover what you think might be a
bug in the software, please let the author or publisher know so that we
may try to improve the software.


REQUIREMENTS

Launchpad should work on all QDOS and SMSQ systems which are QLiberator
and Easyptr compatible, and which have pointer environment and Toolkit
2 available. Expanded memory (minimum 512 kilobytes of RAM) is
required. Although not essential, use of the SMSQ/E operating system
affords some extra features in Launchpad, especially when GD2 (the
so-called "colour driver") is available.

Launchpad is best suited to running on a hard disk system or other
large capacity drive. It is perfectly possible to run Launchpad from
floppy disk, but it needs to be configured to prompt you to insert its
"system" disk when required, as changes to the settings in Launchpad
need to be written out to a couple of system files.


INTRODUCTION

The Launchpad system can be divided into several main sections:

* the graphical user interface

* optional user accounts and password controlled logins

* program launching

* the accessory programs included

* system control menus and user preference settings

* file handling and integration with File Info 2

Launchpad is the culmination of some two years of development. I very
much hope that the time and effort invested in its development will be
appreciated by you, the users. I wrote Launchpad to be what I wanted of
such a program.

I would like to thank people like Darren Branagh, whose continued
encouragement and enthusiasm helped ensure the completion of what has
been an enourmous software project. I would also like to thank my wife
for her patience with me during the long time it took to write this
software. Credit is due to those early testers and users who braved
very bug-ridden early versions and kept coming up with suggestions for
new facilities to help improve those early versions.

It is suggested that you set up a hotkey to pick Launchpad when
required, rather than have to CTRL C around all your programs to find
it. I tend to use ALT L for this:

ERT HOT_PICK('l','launchpad')

It is probably best to insert the HOT_PICK command into your boot
program. Launchpad does not change the QL convention that any
extensions or toolkits required by your programs should be installed by
your boot program before Launchpad or any other program is executed.
Launchpad is written as a normal QL program job and tries not to change
any established ground rules regarding program execution.

An example of a simple boot program for SMSQ/E systems is shown below:

100 REMark start Launchpad
110 REMark put a TK2_EXT here to start Toolkit 2 if required
120 REMark load any resident extensions here
130 REMark then define any hotkeys
140 ERT HOT_PICK('l','launchpad')
150 HOT_GO
160 EXEC FLP1_LAUNCHPAD_OBJ

For the trial version, change the last line to:
160 EXEC FLP1_LAUNCHPAD_DEMO_OBJ

For systems which do not have pointer environment built in, you will
need the pointer interface, window manager and hotkey system - most
pointer driven QL programs include the files PTR_GEN, WMAN and
HOT_REXT. These may be loaded by adding the following lines.

122 LRESPR FLP1_PTR_GEN
123 LRESPR FLP1_WMAN
124 LRESPR FLP1_HOT_REXT

Obviously, replace FLP1_ with the drive/directory name required.

Before being used, Launchpad should be copied to a directory of your
choice and configured accordingly using the Config program. See the
quick start document README_DOC if you'd rather get going quickly than
reading the entire manual first.

There's several DOC files to read - each application has its own DOC
file, and this Launchpad manual itself spans more than one document
file! Please do try to make time to read the manuals, they will help to
make sure you get the most understanding of this package. Launchpad is
not too difficult to master, but there's quite a lot to master quickly
in the early days of using it!


1. THE GRAPHICAL USER INTERFACE

In common with systems on most computers these days, Launchpad has been
designed to have an user interface based on a "point and click" system.
You find what you want, move that pointer to that facility on the
screen and click on the mouse button.

When using a QL mouse system, the following terminology is normally
used:

HIT - pressing the left mouse button (keyboard equivalent is pressing
      the space bar)

DO  - pressing the right hand mouse key (keyboard equivalent is
      pressing the enter key)

The interface itself is based on a "desktop" approach, where you have a
single on-screen work surface from where your most commonly used
programs may be launched and from where all other parts may be
accessed. This may be divided into sections as follows.

1.1 The system icons along the top of the screen follows the usual
pointer environment conventions of having icons for Move, Resize,
Sleep, Refresh, Copyright, Exit and so on.

An icon is a small symbol on the screen which when a Hit or Do is
performed on it allows a certain action to be carried out, e.g. a
particular program is executed (or in Launchpad terminology,
"launched")

1.1.1 Move - selecting this icon (which looks like a small double
      square) allows you to move Launchpad's display around the screen
      if its size is set to be less than the visible screen area. This
      icon appears in virtually all menus in Launchpad.

1.1.2 Resize - change the size of the screen area used for Launchpad's
      display. This is the icon which looks like a small square within
      a larger square, indicating the change of size.

1.1.3 Sleep - puts Launchpad to sleep in the QPAC2 button frame if
      present.

1.1.4 Refresh - manually redraws Launchpad's screen display, useful if
      something goes wrong and makes a mess of the program's screen
      display.

1.1.5 Copyright icon - displays a short screen message with the program
      version number (which may also be displayed when configuring the
      program), copyright details and so on.

1.1.6 Exit - the "X" icon lets you quit from Launchpad (with a
      confirmation message). This icon appears in virtually all menus
      in Launchpad.

1.2 The menus bar contains a number of command names which generate a
further menu, usually for facilities which are used less often than the
main desktop surface. The menus bar consists of commands to access the
File, Launch, Utility, MyQL, Menu and Help menus.

1.2.1 The File menu
This displays a menu with several file-related options such as adding
icons for new programs to the desktop, creating new directories on a
hard disk, printing a list of the current program settings for
reference, manually saving system settings if the normal automatic
saving fails for some reason, controlling the number and names of
users, logging off, or exiting from the program.

1.2.2 The Launch menu
This accesses the Quicklaunch system, where commonly used programs are
organised into lists (or "menus") from where they may be quickly
accessed and launched, or have their details changed.

1.2.3 The Utilities menu
This menu includes a list of small accessory programs such as viewers
and games supplied with Launchpad, the facility to turn off or on a
simple clock display at the top of the Launchpad screen, a facility to
send commands to the BASIC interpreter, a menu to select and launch a
program from disk, lock the Launchpad program itself temporarily, a
menu to pick a program, and a facility for QPC2 users to launch a
Windows or DOS program or file.

1.2.4 The MyQL menu
System control and file handling facilities. MyQL leads to further
menus for setting display options, time setting, network settings etc.

1.2.5 The Menu menu
Launchpad lets you have up to four separate desktops. Each can have a
name - this menu lets you change the names and choose the one to be
displayed. Having up to 4 desktops available lets you organise your
most used program icons into four separate groups.

1.2.6 The Jobs Menu
This is idential to the Pick/Remove A Program command in the Utility
menu. See section 2.7 - Pick/Remove A Program for further details.

1.2.7 The Help menu
Brings up the Launchpad instructions text files. This uses the
PtrView_obj text file viewer accessory program. Both this program and
the various instruction text files (files with names ending in _TXT)
supplied must be present on Launchpad's default drive for the Help
system to work.

1.3 The Desktop Menu selection icons on the right of the screen
indicate which of the four desktop icon lists you'd like to use. Each
desktop can have a separate set of 40 program launcher icons. Although
the name of each defaults to Menu 1, Menu 2 and so on, the names may be
altered to short names of your choice, using the Menu menu (see 1.2.5
above)

1.4 The desktop itself is the main work surface. Here you can set up
icons for your favourite programs, and manipulate those as required.
Programs referred to via the desktops have an icon (a little picture or
symbol) and a short name under the icon. The name may be up to 20
characters long, but depending on the size of the icon grid used in a
particular display resolution, the name may be shortened to fit (e.g. a
QL 512x256 pixel display would mean that only the first 10 characters
of a name could be shown - a bit of trial and error will quickly
explain how this works).

You can fill in a "form" for each program on the desktop specifying any
particular requirements or presets required by certain programs (e.g.
memory control for difficult programs like Quill, DEV settings for
running FLP-only programs from hard disk, DATA_USE and PROG_USE
defaults and command line options), which gives greater versatility
than the rather simplistic approach taken for items set up in the
Quicklaunch menu, for example. If you wish to use facilities like DEV,
SUB, or some of the xxx_USE options, please read the documentation
supplied with them, e.g. your disk interface manual. The DEV_USE
options would not work in Launchpad if your system does not have the
DEV device, for example.

Icons may also point to files if you are a File Info 2 user. In this
case you can create an icon for the file and when you launch that file,
the program associated with that type of file by File Info 2 will be
launched to load that file. For example, File Info 2 users can arrange
that if a _DOC file is executed, Quill can be started automatically to
load the DOC file.

In case you have never heard of it, File Info 2 is a very useful piece
of free software by Wolfgang Lenerz and Thierry Godefroy, which may be
obtained from many QL-related websites and most QL PD software
libraries.

Desktop icons must always have a name. If the filename slot in the
definition form is left blank, but a command is placed in the Option
Command slot, this is treated as a command to be sent to SuperBASIC or
SBASIC. In this way you could set up a command icon to start a BASIC
compiler, for example, by setting up an icon called LIBERATE, no
filename, and an option command of LIBERATE an icon is set up to start
the QLiberator compiler on my system.

If you are accustomed to a 'Desktop' on other operating systems like
Windows, where the desktop itself is a file folder into which files may
be saved, please note that the Launchpad Desktop is rather different in
this respect. Your programs will not be able to save files directly to
the Desktop menus, as these may only contain shortcuts or links to
files, not the files themselves.


2.0 PROGRAM LAUNCHING

Launchpad's primary function is launching programs, hence the name. It
affords a number of methods of launching programs:

* via icons on the desktop

* via the Quicklaunch menu system

* manually, by selecting a program from disk or hard disk with the file
selection menu

* QPC2 emulator users may also execute a DOS or Windows program or file
via the QPC_EXEC facility offered by that emulator.

In addition, Launchpad's own little accessory programs may be launched
from the Accessories menu.


2.1 ADDING PROGRAM ICONS TO THE DESKTOP

Commonly used programs are probably best accessed via the desktop,
making the icons quickly available in a highly visible way. Since
Launchpad offers a choice of up to four desktop surfaces, commonly used
programs may be divided into four categories as you see fit.

There are two ways of adding programs to the desktop, three if you
include copying existing icons.

2.1.1 Via the File menu, you can use the Add New Program command to
locate an empty icon space. Icons are located on a 5x8 grid on the
desktop, giving up to 40 icons per desktop surface, or 160 items in
total in current versions. The Add New Program command locates the
first vacant icon slot on the current desktop, or simply does nothing
if none is available.

2.1.2 Using an existing program icon, you can Do (right click) on the
icon or the space used by the name underneath it to bring up the
'context menu' of commands applicable to the icon to allow you to
delete the existing program link and replace it with a new one. From
this menu, select the 'New' icon. This will ask if you wish to delete
the existing definition for this program item. Click on YES to remove
the old icon and set up a new definition, or click on NO to keep the
existing definition (e.g. if you selected this command by mistake).

2.1.3 Copying an existing definition. If the program to be added uses a
fairly similar definition to the existing program icon, it is possible
to copy the entire definition as an elementary 'drag and drop'
operation. Do (right click) on the original icon, select the COPY
command from the menu which appears and then move the icon to the
location where you'd like the copy to be placed. If you want the copy
to go on a different desktop menu, move the icon to one of the four
menu selection commands at the top right and click on the one required,
which will display that particular desktop. Move the icon over the
location where the new copy of the icon is to be placed and Hit or Do
on that location. The definition is copied there.

2.1.4 Item Definition Form
The rather intimidating name for what amounts to a card index
describing what the program or file icon refers to - its filename,
which little icon is used to represent it, the filename and so on. The
form allows you to specify any of a multitude of special settings for a
program if required (e.g. any DEV_USE settings), but the vast majority
of programs will not need any of these and most may be left blank.

2.1.4.1 Item Name - The short name which appears below the icon on the
screen. May be up to 20 characters wide, but may not be left blank.

2.1.4.2 Item Icon - The little picture used to refer to the program or
file on screen. There are two screens of icons to choose from. When you
click on the Item Icon box in the form, a further screen comes up
listing half of the available icons (to show the other half of the list
click on the Page button at the top of the screen). Simply click on the
icon you wish to use, or if for some reason you'd rather have no icon,
click on the None button at the top.

2.1.4.3 Filename - the full filename of the program should be entered
here. Normal QL filename limits of 36 characters for the filename and 5
character drive names apply - the entry should not be longer than 41
characters. The filename may be entered in one of two ways. Hit the
Filename box to type in the filename manually, or Do on the box to use
a file selection menu popup, which allows you to pick a filename from a
list of files and to wade through directories on a hard disk system,
for example. Across the top of the Files menu, there will be a list of
directory devices on your system (FLP, WIN, RAM, MDV etc). Click on
whichever of these you want to search for the program or file in
question. Below these are a list of drive numbers, from 1 to 8 - click
on the drive number required. The <- button lets you go back up to the
next directory level if you are already within a directory. The DATA$
and PROG$ buttons list files on the current DATA_USE default drive and
current PROG_USE default drive respectively. LPAD$ does the same for
the current Launchpad default drive and directory. The SORT button
simply sorts the files list into alphabetical order. The 'F2' window
below shows the name of the current drive and directory from which the
files list is taken, click on the black box or press F2 to edit the
name, a new files list is displayed when you enter the name. The large
black box at the bottom shows the list of files - executable files are
preceded with an 'E', directory names with a '>' symbol and any S-ROFF
(Sinclair Relocatable files) are preceded with an 'R'. When you find
the filename you require, Hit or Do on that filename and it's
transferred into the Item Definition Form's Filename box. If possible,
the program will also try to extract the Job Name information from the
file and place it in the Job Name box, although you can later amend or
enter this yourself if required (e.g. for programs which change their
own job name). The Job Name is used to Pick the program when it's
running in the QL. It is usually the same name as you will see when you
enter the JOBS command in BASIC to list program jobs running on a QL.

2.1.4.4 Set Screen Mode Number
Most programs will not need this to be set at all, in which case it may
be left blank. Some programs (e.g. older grahical programs) may only
run in 8 colour screen mode and will not start properly unless the QL
is switched into MODE 8 first, in which case you can enter an '8' into
this box for such programs. In general it is best to leave this box
unset, especially on "colour driver" systems (GD2 systems), unless the
program will not run properly without it. I suggest you try the program
first with this blank and only enter something if it cannot be made to
work without a value in this box. On a GD2 system, this is best left
unset and may actually be ignored in some circumstances.

2.1.4.5 Option Command
Most program will not need this. Short strings may be passed to some
programs as a 'command line option', usually stating some startup
defaults or telling the program to load a particular file or use some
given settings. Some of the programs in Launchpad's accessories menu
use a similar facility. The best way to explain this is with some
examples using the EX command in BASIC. Some programs allow their
default drives to be specified like this:

EX FLP1_MYPROG_EXE;'FLP1_'
A program called MYPROG_EXE is executed from FLP1_ and is told to use
FLP1_ as it's default drive.

EX FLP1_UNZIP;'FLP1_CATALOGUE_ZIP'
The Unzip program is executed from FLP1_ and decompresses a zipped file
called CATALOGUE_ZIP.

EX WIN1_CPROG;'-d -h'
A program called CPROG is executed from WIN1_ and options -d and -h
sent to the program, the significance of which depends on the program
in question.

If the filename slot os left blank and a command included, then rather
than executing, Launchpad tries to send it as a command to BASIC
instead, the actual results depending on whether or not BASIC is
expecting input or not.

2.1.4.6 Exep Settings
The Extended Environment provides a number of Exep and Hotkey command
options to deal with programs which prove to be a little awkward when
run in the extended environment.

The Psion KB option lets you protect memory from being grabbed by
programs like Quill (which have a habit of grabbing as much free memory
as they can when starting up) by specifying how many kilobytes of
memory these programs are to be allowed to have. Normally a value of
128 or 256 kilobytes will be adequate. The value entered must be in
kilobytes. Normally, only Psion programs will need a value entered
here, other programs will require this to be left blank.

Impure is for programs which cannot code-share, because they modify
themselves while running in some way. In other words, you cannot run
two instances of the program from the same code. Examples include older
Turbo compiled programs, or programs which include data storage areas
within their code, or compiled programs with attached BASIC extensions
which modify their own code in some ways. Just click on the Impure box
to flick between Yes and No. The vast majority of programs will have
this set to No.

Freeze is for programs which continue writing to their display even
when their windows are buried by another program, thus corrupting the
display of the other program, a behaviour referred to in QDOS
documentation as "destructive". The usual culprits are programs which
write direct to the display without going via the operating system,
such as older games, or my very own Vision Mixer program. Setting the
Freeze option to Yes helps improve the impolite behaviour of such
programs.

Guardian enables a guardian window around programs which tend to resize
their own display and cause problems as a result. This option helps
tidy things up. Rarely required.

Unlock. Some programs like clocks and caps lock indicators tend to need
to write to the display irrespective of what other programs are doing.
In other words, they are allowed to be "destructive" but the pointer
environment may hinder their operation by suspending them if their
windows are buried for example. Setting Unlock to Yes may help in this
case. Normally Unlock would only be needed for programs like clocks or
indicators which need to overwrite something on the display when
buried.

2.1.4.7 Data Default and Program Default
These correspond to the DATA_USE and PROG_USE default drives and
directories in BASIC. A few programs need these to be set so that they
know where to look for files when they start.Note that as the QL system
sets these on a global not a per-job basis, whatever is entered here
affects all programs. Do not set these unless the program concerned
requires them to be set.

2.1.4.8 DEV Device Settings
See your system's documentation for the DEV device. If installed on
your system (most Miracle Systems disk interfaces and versions of the
SMSQ operating system include the DEV device, and the device driver is
freely available in a file called DEV_REXT available from most QL PD
software libraries). DEV is a "substitute" device driver which allows
renaming and concealment of drive and directory names, particularly
useful for moving older floppy disk-only programs to run from
sub-directories on a hard disk. It may be best explained with an
example in BASIC.

Suppose we want to transfer a copy of Quill to run from hard disk.
Quill is configured ot run from FLP1_ and to save its files to FLP2_.
We want it to run from a directory called WIN1_QUILL_ and to save its
files to a directory called WIN1_QUILL_DOCS_, so we could use the
following DEV related commands in BASIC:

DEV_USE 1,WIN1_QUILL_
DEV_USE 2,WIN1_QUILL_DOCS_

What this means is that any reference to dev1_ is in fact a reference
to WIN1_QUILL_ and any reference to dev2_ is really a reference to
WIN1_QUILL_DOCS_. Where this becomes more useful is if we rename DEV1_
and DEV2_ to answer to the names FLP1_ and FLP2_, so that these old
programs which only know about FLP1_ and FLP2_ know and understand
what's going on:

DEV_USE FLP

References to FLP1_ now really refer to WIN1_QUILL_, which fool the
program into running from hard disk. Once you have decided on the
settings, enter them into the relevant boxes in the Item Definition
Form.

It may be useful to rename the original floppy disks to something else
to allow them to be accessed when required. The FLP_USE command would
allow this in BASIC, try FLP_USE FDV to make the floppy disk drives
answer to FDV1_ and FDV2_ for example.

The primary use of the DEV device settings is in moving programs from
floppy disk to hard disk systems without having to be an expert in
hacking their code to run properly from hard disk. Most well written
recent software won't need to use the DEV or SUB devices at all.

2.1.4.9 Sub Device
This is another substitute device driver, written by Phil Borman and
commonly supplied with the Qubide IDE hard disk interface. It is
similar to the DEV device in many respects, except that the drive and
directory names must be entered into separate boxes.

2.1.4.10 Device names
QL BASIC allows various nnn_USE commands to rename device drivers.
FLP_USE changes the floppy disk driver name from FLP to some other 3
letter name, while RAM_USE does the same for the ramdisk driver. Where
implemented on your system, Launchpad lets you change the names of the
DEV, FLP, RAM, ROM, SUB, WIN, PAR and SER devices by entering new 3
letter names in their respective boxes. Most programs will not need
this, these boxes are best left blank unless really required.

2.1.4.11 WIN2
This was a facility on the original Miracle Systems hard disk system,
allowing references to WIN2_ to really refer to a directory on WIN1_,
providing a mechanism to get around the limitations of older programs
which did not understand directories. It was used to help transfer
'awkward' programs to run from hard disk.

Once all required settings have been entered (most programs will only
need an item name, filename, job name and an icon) click on OK to enter
the definition and it should then appear on the desktop as an item you
can click on to launch that program or file.

2.1.4.12 Other Uses
By leaving the filename box empty in the Item Definition Form, you can
set up a "type in" command for SuperBASIC or SBASIC (or any named job).
Enter the command into the Option Command box. To send the command to
BASIC, leave the Job Name box empty. To send to another job, enter that
job's name into the Job Name box. No linefeed is normally sent, but if
one is required put a backslash character \ at the end of the command.
For example, to fire up the QLiberator compiler to compile a BASIC
program, simply enter the command LIBERATE in the Option Command box.
This will make the word LIBERATE appear in BASIC's channel #0 window
(as long as it's capable of accepting input at the time). If you want
it to act as if ENTER had been pressed as well, enter LIBERATE\ in the
box. Note that the \ to linefeed conversion works only in such
commands, it is not done if a filename was entered (i.e. a program is
executed).

If no Filename or Option Command is specified, the icon will only try
to Pick the named job instead.

File Info 2. If you use File Info 2 you can use the filename of a
non-executable file such as a text file in the Filename box and
Launchpad will attempt to launch the text file via File Info 2's
associated program for a file with that suffix. For example, entering
WIN1_MY_DOC in the filename box would normally cause Quill to be fired
up to load the file concerned (as long as the appropriate entry had
been made in File Info 2's file associations list of course. This
allows you to place shortcut links to commonly used individual files on
the desktop if required.

2.1.5 Altering A Definition
If you simply want to see the existing definition for a particular
icon, Do (right mouse button click) on that icon and from the context
action menu which appears select the Properties command just to see the
definition, or the Alter command to make changes to the definition. The
procedure for altering is exactly the same as that for entering a new
definition.
2.1.6 Removing An Icon
Do on the icon and select the Delete command. This only deletes the
icon, name and definition details. It does NOT erase the entire program
from disk - it is not THAT drastic! Note, though, that there is no
UNDELETE or anything like that, once the definition is removed it
cannot be recovered.

2.1.7 Launching A Program Icon
Simply Hit (left mouse button click) the icon to launch the program,
file, or command defined by the icon. Alternatively, Do on the icon and
from the Action context menu, select the Launch command.

2.1.8 Sorting the icons into order.
Do on the icon, and select Order, then the appropriate sorting method
required from the list. Unsort will remove the sorting if required.

2.1.9 Picking A Program.
Do on the icon, and select the Pick command.

2.1.10 Settings
Do on the icon, and select the Set command. This will put the settings
for that program into effect, without actually launching or picking the
program if required. There is also a Set and Pick command which
combines the action of Set and Pick commands.

2.1.11 Rjob
If the program referred to is already running and you wish to stop it
for some reason, it is usually best to switch to that program ('Pick'
it) and quit from it in the normal way. Sometimes, that is not possible
(e.g. the program has stopped responding). In this case, Do on the
program's desktop icon and select the RJOB command from the Action
context menu which will try to force-remove the program.


2.2 The Quicklaunch Menu System

The Quicklaunch menu is a system which allows you to set up your own
menu system. You can define programs and menus of your own on this menu
and organise it to your own requirements - the most commonly used
programs accessed from the first level and less commonly used programs
in sub-menus, for example. Although simple to use, Quicklaunch may be a
little more complex to set up than to use.

+-------------------------------+
| [move]  [QUICKLAUNCH]  [ X ]  |
+-------------------------------+
| Database ->                   |
| File Transfer ->              |
| FileFinder                    |
| Games ->                      |
| Programming ->                |
| Text 87                       |
| Utilities ->                  |
|                               |
|                               |
| [Add program] [New menu] [<-] |
+-------------------------------+

The Quicklaunch menu is shown above. The top part consists of title,
move icon and exit icon. Click on the double-square move icon to move
the menu elsewhere on the screen, or click on the [X] icon top right to
quit. Commands to add a new program, add a new menu and go back up to
the previous menu are at the bottom of the menu.

The central part lists the items in the current menu level. Items which
have names ending with a right facing arrow are menu names - a Hit on
these will take you into that menu.

Other items are links to programs or files. A Hit on these will try to
execute the program (or if a non-executable file, and File Info 2 is
available, the files are launched via File Info 2).

When you first use Launchpad, the Quicklaunch menu will be empty. You
will need to set it up yourself, a rather time consuming but hopefully
not too difficult task.

To set up a new program, simply Hit or Do on the Add Program button at
the bottom. This brings up the Add New Menu Item form. You will be
relieved to know that this is much less daunting than the equivalent
for the desktop icons! You will be asked to enter the following items:

1. The item name as shown in the menu. This name should not be blank
(or you'll be presented with a 'bad name' error message), and may not
include the right facing arrow, semi-colons or asterisks, as these
three characters are used as internal identifiers and including these
would fatally confuse the menu system. The item name may be up to 30
characters long for a program or file, and up to 29 characters for a
menu name (the 30th is used internally as the menu marker character
character).

2. The filename of the program or file to be linked to. Hit on this box
to type in a filename yourself, or Do to bring up the usual file
selection menu.

3. Command Line String. If a command line string is required, enter it
into this box. A Hit on the box will let you type in some text, whereas
a Do on the box will bring up the usual file selection menu to let you
select a filename which may be used as the command parameter if
required.

4. Job Name. Where possible, this will be extracted from the file when
the filename is entered. A Hit on this box will allow you to type it in
yourself, or amend what is already shown.

Note: if the Filename box is left empty, this entry will be treated as
a command or piece of text to be sent to the named job (or BASIC if the
job name is left empty). This would allow you to send a command to fire
up a compiler from BASIC for example.

Given that only those four items are entered, the definition for each
item in the Quicklaunch system is much less comprehensive than for
those entered as icons on the desktop - there are no DEV settings etc
to contend with, so 'difficult' programs like Quill are probably best
placed on the desktop rather than in the Quicklaunch menu system.

To add a new menu, click on the [New Menu] button at the bottom of the
menu. This brings up a text entry box, asking you to enter the name of
the new menu. It should not be the same as any existing menu name, or
as any other item in the current menu. The menu reference is placed in
the current menu. Ensure that you are in the correct menu before
calling this command as the reference to the menu cannot be moved into
another menu once installed (you would have to delete it and start
again). The name may be up to 29 characters long - the 30th character
is used to hold the forward right facing arrow which indicates that
this item calls a sub-menu. If you clicked on Add Menu by mistake,
making a blank entry will let you escape from entering a new menu name.
Try not use the right arrow (CHR$ 191), semi-colon or asterisk
characters in names, they are used for special purposes internally, and
may confuse Launchpad if used in a name.

Note for advanced users: the Quicklaunch system is set up as a
recursive menu system, it is, therefore, theoretically possible that
the program may run out of memory with deep menu nestings (several
layers of sub-menus). If this happens, please let us know, it is
possible we may need to alter program stack space to cope with this.

Launching a program or file, or entering a sub-menu is accomplished by
a Hit on the item's name. A Do will bring up an Action context menu,
with commands to alter the existing definition (brings up a Rename
window), delete this entry, launch this entry (or enter the menu if it
was a pointer to a sub-menu) with a list of options such as modifying
the command string and the Psion KB/Guardian/Unlock/Freeze/Impure
options for execution, option to Pick the program if already running,
and finally sorting the current menu into alphabetical order.


2.3 Manually Launching Programs
By going into the Utility menu and selecting the Launch A Program
command, you can use a file selection menu to locate a program and run
it. This is useful for launching a program not used often enough to
warrant putting it on the desktop or into a Quicklaunch menu, or for a
quick test of a program if you are not certain you wish to install it
on your system.

When you have selected a file, an options screen appears, where you can
enter a command string and specify any Exep-style control options (the
usual Freeze, Unlock, Impure etc). Click on the LAUNCH button to
actually launch the program or on the Exit symbol to abort.


2.4 QPC:Launch DOS/Windows File
If you are using QPC2, there is a facility called QPC_EXEC which in
simple terms allows you to execute a DOS or Windows program or file
from within QPC2. Launchpad also offers this facility when running on
QPC2 (only!).

Go into the Utility menu and select the QPC:Launch DOS/Windows File
command. This brings up a horrendous dialogue window with all sorts of
boxes and icons in it. Don't worry if you find this horrible, I do, and
I wrote it! Eight items may be specified - the actual program and/or
file to be launched, as well as lists of three of your favourite
DOS/Windows programs and three favourite DOS/Windows files (i.e.
path/filename of the programs or files), which act as time saving
shortcuts:

+-----------------------------------------------------------+
| [Move]                  [ QPC-EXEC ]                  [X] |
+-----------------------------------------------------------+
|                                                           |
| Launch a DOS/Windows program and/or file from within QPC2 |
|                                                           |
| --------------------------------------------------------- |
|                                                           |
| DOS/Windows program path/filename:                        |
|   [                                                ]      |
| Favourite programs:                                       |
| A [ C:\Program Files\Accessories\Wordpad.exe       ]  1   |
| B [ C:\Windows\Notepad.exe                         ]  2   |
| C [ C:\Windows\Explorer.exe                        ]  3   |
|                                                           |
| --------------------------------------------------------- |
|                                                           |
| DOS/Windows file path/filename :                          |
|   [                                                ]      |
| Favourite files:                                          |
| D [                                                ]  4   |
| E [                                                ]  5   |
| F [                                                ]  6   |
|                                                           |
| --------------------------------------------------------- |
|                                                           |
|                          [ OK ]                           |
+-----------------------------------------------------------+

The first black box contains the name of the DOS or Windows program
which is to be launched. The fifth contains the name of the DOS or
Windows file - if both boxes are filled in, the program is launched and
that program loads the file specified (e.g. a word processor might load
a document). If no program is specified and a file specified, the
Windows file association mechanism would try to work out which program
is normally associated with that kind of file, and take appropriate
action.

The three lines beneath the program filename contains filenames for up
to three of your most commonly used programs - I tend to include
Windows Wordpad, Notepad and Explorer here. By clicking on these boxes
you can modify one of these to represent whichever program you'd like
included here.

Similarly, you can include the filenames of up to three DOS or Windows
files under the main DOS/Windows file box.

Launchpad saves the updated details for future use.

To transfer the favourite file links up to the main box above, simply
click on the number icon to the right of the box. In common with most
of Launchpad, the underlined letter or number shows which key to press
to access that item from the keyboard.

Finally, to launch the DOS/Windows program and/or file, click on the OK
button at the bottom, or click on the [X] exit icon top right to escape
from this screen.

2.5 Accessories
A number of small programs are supplied as part of the Launchpad
package. These include a couple of simple games, a screen saver
package, some file viewers and a couple of useful utility programs.
These programs may vary from time to time as I see fit. Currently
included are:

Calculator       - simple pointer driven calculator
Calendar         - monthly calendar with simple diary notes facility
Character Map    - aid to accessing accented characters etc
Digital Invaders - simple pointer driven game
Hexpawn          - simple pointer driven game
Pic Viewer       - viewer program for QL screens and PIC files
Q-Trans          - file handler for copying, deleting, viewing etc
Screen Grabber   - screen capture utility
Screen Saver     - Launchpad screen saver utility
System Status    - Displays system settings in a window on the screen
Text file viewer - Load and view plain text files

All of these have their own instruction files supplied on the master
disk, and all may be used independently of Launchpad. These accessory
programs may be freely distributed or included with the demo version of
Launchpad.


2.6 Clock
Accessed from the Utility menu, the Clock command simply starts the
Toolkit 2 clock in a window at the top of the screen.

The clock may be invoked in various formats, including slightly
different layouts for USA and European formats, and showing the time or
date (or both). Select the format required from the menu which appears.
Launchpad then saves your choice for the next time you log on. If you
exit Launchpad with the clock running, it will try to ensure that the
clock starts automatically next time you log onto Launchpad. To disable
the clock, select the Disable Clock command from the Clock format menu.

The Toolkit 2 clock is "destructive", it writes all over anything which
appears over it, including other Launchpad windows and menus! My excuse
is, I didn't write it, I've only implemented it following requests from
early users!

2.7 Pick/Remove A Program
This menu, accessed from the Utility menu, presents a list of programs
("jobs" in QDOS terminology) running in the computer. A list of job
numbers, owner job, job size, priority and job name is drawn.
QLiberator compiled jobs are identified by a "Q" between the Priority
and Job Name columns. You can either Pick (jump to or select) or Remove
(stop a running program) a job by selecting the appropriate command at
the top of the screen. The selected Pick or Rjob command is highlighted
in red. Click on the name or number of a job in the list below to pick
or remove that job.

2.7.1 Pick Job
For the Pick command, a Hit (left click) on the job entry will simply
pick that program, while a Do (right click) will pick that program and
issue a Wake event to the job. This will be ignored by some programs,
like others (e.g. the QPAC2 Files menus) may respond in a specified way
such as re-reading a list of files or redrawing the display. The job is
picked by Job Number, not by name.

2.7.2 Remove Job
The selected job number is removed from memory. The job is removed by
job number, not by name, which should help to reduce the possibilities
of accidents with removal of similarly named jobs by mistake. CAUTION:
Launchpad can even remove itself with this command - use caution!

2.7.3 Refresh
To refresh the jobs list, click on the little lightning symbol icon at
the top.

2.8 Command
Accessed from the Utility menu, this facility is designed to let you
send a command to SuperBASIC or SBASIC. It cannot send the command to a
named job. Select whether or not you want a linefeed added to the end
of the command (usually, you would if it was being sent as a direct
command to BASIC). Click on the black strip to enter the command, which
is sent when you press ENTER. Launchpad tries to pick BASIC and then
sends the command to BASIC.

2.9 Print Settings and Save Settings
The Print Settings command from the File menu sends the main settings
list for Launchpad to the printer. It may serve as a useful reference
guide or an aid to resolving why certain problems occur (e.g. one
program not starting properly if another is in use, because of clashing
settings).

On entry to this command, a selection menu appears. Since the complete
printout for systems with many programs installed on the Desktop or
Quicklaunch menus may be several pages long, you can select which
groups of settings items to print if your requirement for a specific
reference printout.

Alongside the five item group descriptions are small black check boxes.
If a cross appears in the box, that item is printed. If the box is
blank, that group of items is not printed. Additionally, a sixth item
lets you specify that a formfeed character may be printed at the end of
the printout to ensure that the last page is in fact ejected from the
printer - useful on laser printers for example where the last page is
often not printed unless the text has reached the bottom of the page.

The groups of items available are:

* Username
* Desktop menu items
* Quicklaunch menu items
* Miscellaneous Settings list (e.g. display settings)
* Restore System Defaults settings

The normal Launchpad default printer port is offered, although you can
temporarily change this if the printout is to go to a file, for
example, instead of to the usual printer.

The Save Settings command from the same menu is there just to help you
when you suspect certain changes may not have been saved successfully,
e.g. the disk to which your system files are written filled up. In that
case, replace the disk and select Save Settings to force another copy
of the settings file to be saved (saving normally occurs
automatically).


3.0 Users

Launchpad recognises that more than one person in a family or workplace
may wish to use a QL, and each may have their own preferred settings -
one person may want to work in high colour high resolution modes, one
person may want compatibility with older programs to play older games
and so on. You can even set up more than one account for yourself if
you need more than one type of system setup depending on what you are
doing at the time.

Under Launchpad, up to 16 users may save their own system settings and
preferred program icons. Only one user may be logged into a copy of
Launchpad at a time, although users can quickly log in and out without
actually leaving Launchpad.

Each user "account" stores the following settings:

* icons on the desktop

* Quicklaunch menu programs

* system settings, as set in the MyQL menu

Note, however, that as the QL operating system is not really geared up
to security and multiple users, there is a limit on what I can offer in
this regard. For example, if you know what you are doing, it is quite
easy for one person to access another's files, as one user's
directories are not protected from another's programs, the operating
system does not restrict access to directories or individual files in
the same way as Windows is able to, for example. It is best to regard
the concept of "users" within Launchpad as a way of providing everyone
with their own preferred system settings and program icons, with the
passwords being little more than a method of preventing anyone else
(e.g. your children) modifying the settings for a given user.

Each user may have their own user name and an optional password, e.g.
if office security or a degree of "child-proofing" is required. If
there is only one user and no user name or password is specified, the
login box never appears and you go straight into your own system. There
is also a Lock command available in the Utility menu which lets you
temporarily lock the Launchpad program if your original login username
also has a password - it shows a small menu informaing you that the
program is locked temporarily and asks you to type in your password to
remove the "lock". If your login contains no password, you need only
make a blank entry or click on the [X] icon to escape and "unlock"
Launchpad. The [X] icon is not available if a password is required. Be
careful when using the Lock command, if you are using someone else's
user login and don't know the password, you are locked out and will
have to stop Launchpad. As with the Login box, the password is shown as
a string of asterisks to prevent it being seen as you type.


3.1 Logging Onto Launchpad

If more than one user "account" has been set up, the login box appears
and you will need to enter a user name and a password if one has been
set up for that user.


+---------------------------------------------+
| [Move]     [ LAUNCHPAD USER LOGIN ]     [X] |
|                                             |
|         Enter a user name and password      |
|       then hit OK to log onto Launchpad.    |
|              |                              |
|         Hit [v] for list of user names.     |
|                                             |
|                                   |         |
|   User name [                   ] v [ OK  ] |
|                                             |
|   Password  [                   ]   [Clear] |
|                                             |
+---------------------------------------------+

When this box appears, Hit the User Name box to enter a user name, or
click on the box containing the down arrow symbol to get a list of the
users, Hit a name from the list and it will get transferred into the
User Name box. Then enter the password for this user into the Password
box below if a password is required (leave this box blank if not).
Passwords are shown as a row of asterisks to prevent them being seen by
others on the screen.

Once the user name and password entries are ready, Hit the OK button to
log onto Launchpad. If you think you have made a mistake with the
password for example (as it cannot be seen on the screen), Hit the
Clear button to empty the User Name and Password boxes.

Once you have logged into Launchpad, it will read your user data from
disk (floppy disk users will be prompted to insert their system disk)
and begin to set up your icons, menus and other settings. If your saved
settings require a change of colour depth or display resolution, there
may be some on-screen flashing as the computer changes settings.

To logoff from your session on Launchpad, go into the File menu and
select the Logoff command which will take you back to the Login box.

To quit altogether from Launchpad, either click on the [X] icon at the
top right of the display, or go to the File menu and select the Exit
command.

3.2 Altering The List Of Users

To add or remove users in Launchpad, you should go into the Users part
of the File menu (or select the Users part of the MyQL menu).

+----------------------------------+
| [Move]   [LAUNCHPAD USERS]   [X] |
| +------------------+             |
| | user name 1      |  [New User] |
| | user name 2      |  [ Delete ] |
| | user name 3      |  [  Copy  ] |
| | user name 4      |  [Password] |
| |                  |             |
| |                  |             |
| |                  |  [   OK   ] |
| +------------------+             |
+----------------------------------+

The window on the left shows the user names currently set up on this
system. One of th euser names may be blank.

To set up a new user, Hit the New User command on the right. This
brings up the new user entry box, very similar to the normal Login box.
Enter the name of the new user in the User Name box, and their password
in the Password box (leave this box empty if no password is required),
then click on the [OK] command. The password is shown as a line of
asterisks, so if you make a mistake, you may find it best to clear it
with the [CLEAR] command and start again.

There will be a brief pause while the new user's details are set up.
Floppy disk users will be prompted to insert their system files disk at
this point.

Technical notes:

During entry of the new user's details, a User ID number is shown. This
is for internal use only, the only significance being that it is the
number which decides the filename of the file holding that user's
settings. A user's details are held in a file called LAUNCHPADx_dat,
where x stands for the User ID number, so if you notice that your User
ID is 4, your details will be held in a file called LAUNCHPAD4_dat.

The passwords and user names are stored in a file called LAUNCHPDAD_pwl
(the _pwl standing for PassWords List). If this file is missing,
Launchpad cannot start up properly. This is the reason why you need to
configure Launchpad's system directory before using it, so that it
knows where files like these are stored. The passwords are stored
encoded in this file to prevent prying eyes.

Adminstrators: if you forget a password, a small BASIC program is
supplied called PASSWORDS_BAS. This will allow you to examine and alter
passwords in an emergency. If security is an issue, remove this program
from the Launchpad system directory and keep it somewhere where only
you know where to find it, e.g. on a separate floppy disk in a safe or
other secure location. The program is quite easy to use, no need for
instructions here (it has its own instructions file).

To remove a user from the list, hit or do on that user's name in the
list, then hit or do on the [Delete] command on the right. If a
password was specified for that user, you will need to enter the
password before the Delete is completed. A confirmation box appears,
reply by clicking on Yes or No as appropriate. Floppy disk users will
need to insert the system disk so that the system files may be updated.

If the new user's sytem setup will be largely the same as those of an
existing user, it is possible to save time by copying an existing
user's details. This will copy the system settings, desktop icons and
Quicklaunch program and menu details. Highlight the existing user's
name, then enter a user name and password for the new user, before
clicking on [OK]. Again, floppy disk users will need to insert their
system disk to update the files.

Finally, the Password command on this menu lets you change a user's
password, or assign a password to a user who previously had no
password. You can even change the User Name if required. If a password
has previously been set for this user, you'll be asked to enter the
original password before you can change it.

User names and passwords may be up to 16 characters long, which should
be enough for most purposes.
