Macros by Paul Clifford
 DoggySoft, 1993

    ____________________________________________________________________
   /                                                                    \
-=<                        HOW TO USE THIS PROGRAM                       >=-
   \____________________________________________________________________/


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

Macros is a general purpose macros program, which can be used together with
other program which do not offer macros. There is space for a total of
twenty user definable macros, each of which can be up to 100 characters in
length. The macros can be entered a variety of ways, including by hotkeys,
into three different buffers, depending on your use.

You can save and load macro files for use with different programs, and once
saved, can be loaded into Edit for futher modification. The program is
described below in four different sections - the iconbar menu, the main
menu, the main window and the iconbar icon.

Iconbar menu
============

Apart from Info and Quit, the two other options on this menu are 'Load
macros' and 'Save macros' which lead off to a subwindow. Selecting 'Load
macros' opens a window which you can load macro files with, by either
dragging them to the arrow icon or typing in the pathname. You can load
macro files that have been saved in the application directory by either
using the full pathname or just the leafname, which is easier, eg. to
re-load the default file, just type in 'Default' and press RETURN.

'Save macros' leads to a subwindow where you can save the current macros by
dragging the icon to a directory viewer, or just typing in a leafname to
save the macros inside the application. If you save your macros inside the
application as 'Default' then this will be loaded every time Macros is run
from then onwards.

Main menu
=========

This menu has six menu options, three of which lead to submenus. 'Speed'
allows you to alter the speed at which macros are entered. Slow, Medium and
Fast all enter a set number of characters each null event, but Psycho enters
all the characters at once, making it very fast, but sometimes losing
characters when entering macros into the keyboard buffer.

'Output' allows you to re-direct the macros to different buffers - either
the keyboard, the serial input buffer or the serial output buffer. By
default, macros are sent to the keyboard buffer, but if you intend to use
Macros with comms programs you might want to set it to 'Serial O', so that
the macros are sent straight down the serial port.

Before explaining the third menu item, it is necessary to point out that
pressing RETURN in one of the macro icons will enter a '' character rather
than going to the next line. When entered, this character will be translated
into either a carriage return or a line feed, depending on the setting of
the 'New line' submenu.

'Inside' allows you to toggle whether or not you are allowed to enter macros
from one icon to another in the main Macros window. Turning it off results
in a beep if you try to enter a macro into the keyboard buffer with the
caret in the main window.

'Hotkeys' lets you enter macros using ALT and function key definitions. The
first 10 macros can be entered using ALT+Fx, x being the number of the
macro. To enter the next ten, ALT+SHIFT+Fx is used, x being the number of
the macro, minus 10.

'Lock' is a useful option when you are entering macros into the keyboard
buffer. When set, after you start entering a macro, moving the caret to
another window while the macro is still being entered will stop the entry
until the caret is put back. It should not be relyed totally on though,
because occasionally, the odd character might manage to slip through.

'Clear' clears all of the macro entries, allowing you to define a fresh set
of macros.

Main window
===========

To the right of each macro is a button with Enter written in it. Clicking on
this with SELECT attempts to enter the macro into the selected buffer, while
clicking on it with ADJUST will pass the macro through OS_CLI, allowing star
commands to be executed. If 'Serial I' or 'Serial O' are selected, macros
can also be entered by putting the caret in the icon and pressing the INSERT
key.

When being entered, macros are first passed through OS_GSTrans, allowing for
the inclusion of control comands, system variables etc.. Details on this
format can be found on page 451 of the Risc OS 2 user guide or page 147 of
the Risc OS 3 user guide.

Iconbar icon
============

Clicking SELECT or ADJUST on this performs the normal action of opening the
main window at the front of the window stack. However, dragging a text file
here will enter its contents into the chosen buffer. The speeds chosen on
the 'Speed' menu apply here, with one slight difference. 'Psycho' no longer
enters the whole lot before returning control to the machine, as with long
textfiles this could hog the machine for quite a while. Despite this, it is
still marginally faster than the other options.

    ____________________________________________________________________
   /                                                                    \
-=<                              CONDITIONS                              >=-
   \____________________________________________________________________/


If you find this program useful, I would appreciate a small (or large!)
donation, although this is not obligatory.

Macros may be distributed freely on the following conditions:

  1) No more than 2.00 is charged for a disc containing it, unless
     permission is obtained from me.
  2) Any modifications are sent to me so I can keep track of the current
     version number.
  3) All the files are included, unchanged, except 'Resources.Macros' which
     may be deleted if you wish.
  4) You do not claim to have written Macros yourself.
  5) You don't phone me for anything (write to me, contact DoggySoft, or
     send a message via Arcade), as the person answering would most likely
     not be me, and think you mad.

    ____________________________________________________________________
   /                                                                    \
-=<                          HOW TO CONTACT ME                           >=-
   \____________________________________________________________________/


My address (phone number deliberately missing!):

  Paul Clifford,
  3 St Anthonys Avenue,
  Woodford Green,
  Essex,
  IG8 7EP,
  England.

  Or ring Arcade BBS (081-654-2212) and mail me as user #168

DoggySoft (and Jp's) address:

  DoggySoft Consumer Department,
  Furzefield House,
  Furzefield Road,
  Beaconsfield,
  Bucks, HP9 1PQ. 

  Or ring 0494-673222