*****************************************************************************

                                FormEd 3.59
               by Acorn Computers, the RISC squad, and D. Salt

                         with RISC Squad commentary
                           v3.xx notes by D. Salt

*****************************************************************************

Version 2.80 - 21/09/90

Completed 21st September 1990 to v2.80. Here's a list of all the things I
did, as far as I can remember - I didn't make a list as I went along.

 - Icons can now be (de)selected by clicking MENU on them whilst holding the
   SHIFT key down.
 - The icon SELECT-dragging procedure now moves all of the selected icons in
   the window. ADJUST-dragging (resizing) is unchanged.
 - The main menu structure has been split into an Icon menu and a Window
   menu, for convenience and speed. Previous releases of FormEd were
   notoriously slow at creating their menus. Each menu includes an option
   for calling up the other, which will then be opened as default on each
   subsequent occasion.
 - The Window menu is largely unaltered, but does include a 'save' option
   for saving only one template at a time. Be warned, font freaks - the save
   routine will check for anti-aliased fonts in all other windows too, so I
   don't know what will happen in that situation. Whatever it is, it
   shouldn't be fatal.
 - The Icons menu is now far more versatile than before. Many choices are
   now available for all selected icons (in that window only) including
   specific choices from the 'Edit icons' submenu tree - notably 'Button
   type'.
 - The 'Renumber' option is virtually as before, but the renumbering process
   can be optimised via Ctrl-MENU. This is identical to selecting the
   'Renumber #nn' option.
 - The 'Deselect all' option deselects all icons in the current window.
 - The 'Copy' and 'Move' choices may now be performed on either single icons
   or on all the selected icons.
 - The 'Wipe' option may now be on selected icons, on a single icon or on
   any icon number specified. I find this useful in two instances:
   - when I import templates which have 'missing' icons that aren't used -
     see Paint's 'save' box: icon #1 is to the right and is '<CRAP>';
   - if I can't find one of my own icons!!
 - Note that any options which are either on 'selected' icons or on a
   specific icon can be controlled by clicking MENU over a specific icon for
   the latter, or on no icons (the window's work area) for the former. In
   such a case, if no icons are selected, you will be informed, eg. 'Wipe No
   Icons' - which will also be greyed out.

All in all, the lesson to be learned from this is - if you want any icons to
be selected (in the finished template) - leave them to the end, so they
don't screw up your work!

PS. I also put in an 'Info' box and attached it to the icon bar menu as
expected. Plus, while checking up on the 'Save one template' job I
re-enabled the facility to save the entire file merely by choosing the 'Save
templates' option on the icon bar menu - this had been REMed out!

*****************************************************************************

Updates, Version 2.81 - 24/11/90

The main problem bugging those people I knew of who were using this was that
of the unnamed windows not being saved. I have therefore included a new
error in the 'save' routine such that the error 'Only the named windows were
saved' occurs if any of the templates were unnamed.

I also fixed the 'Move Selected' option from the 'Icons' menu, which did
absolutely nothing in v2.80.

*****************************************************************************

Updates, Version 2.82 - 02/12/90

Oops, v2.81 was chronically buggered! The aforementioned error occurred on
every occasion, without exception. This is now completely fixed! The extra
features are as follows:

 - It is now impossible to create unnamed templates.
 - The identifiers of windows must be different on a non case-sensitive
   basis, i.e. it is not now possible to call one template 'Save' and a
   different template 'save' even though the names, strictly speaking, are
   distinct.
 - Clicking on the icon bar icon opens a dialogue box, prompting the user to
   enter the identifier of the new template. Press Return or click on 'OK'
   to confirm; press Escape or close the box to cancel.
 - Alternatively, a new template may still be created by the use of the icon
   bar menu structure. The normal rules for identifiers still apply.
 - Any new template has its title bar icon set to text as before, but the
   text defaults to the identifier at the time of creation. This allows easy
   reference on a set of newly created templates.
 - As a result of all this, the errors concerning unnamed templates are now
   a thing of the past!
 - On a completely different point: newly created icons now appear directly
   underneath the pointer rather than a small distance above it.

*****************************************************************************

Updates, Version 2.83 - 23/12/90

Aha, welcome back to all template designers. It's been exactly three weeks
since v2.82 and in such a short time I found a lot to do to the program, it
wasn't hard. Have you noticed how all of these have been issued at weekends,
i.e. Friday, Saturday, then Sunday twice?

I suppose I should tell you what I've done to it again - well, in order of
appearance...

 - The icon bar menu is restructured so that the templates and the sprites
   are handled independently. This also makes the main menu less tall, and
   less silly.
 - You will of course have noticed an unfamiliar option on this menu as soon
   as you tried it out after you'd read through the bit above - the new
   'Clear' option. Fairly self-explanatory, all it does is asks for
   confirmation, then clears all templates from memory. This is mainly
   useful for loading a new file etc. For example, if you want to pinch the
   save box from Edit, then you would load the templates from Edit, save
   just the one template you wanted, clear the templates then re-load the
   old file, eg from RAM:. This saves either
   - deleting all of the templates in the file 'by hand'; or
   - quitting FormEd and waiting for another copy to load and initialise
     (very slow).
 - The next idea I had was to add a facility for certain 'default' icons,
   rather than the <Untitled> icon as before. This became a thorough
   restructure of the icons menu, to become a more filer-type menu tree.
   Here's how the new 'icons' menu looks:
    Create icon - On its own, this creates the old <Untitled> icon, almost.
                  The submenu has a variety of goodies on offer:
      Text      - Colour 12 bordered text icon   (Click/Drag)
      Sprite    - 'Free-standing' sprite icon    (Click/Drag)
      Arrow     - Colour 12 bordered arrow icon  (Click/Drag)
      Option    - Normal 'Optoff,Opton' icon     (Radio)
      Radio     - Normal 'Radiooff,Radioon' icon (Radio)
      Writeable - Normal text entry icon         (Write/Click/Drag)
      Menu      - Normal menu icon, eg 'OK' box  (Menu)
      Comment   - 'Free-standing' text icon      (Click/Drag)
                  e.g. the 'Name:' icon in a ProgInfo window.
   This is where the similarities to the Filer start. The third choice is
   either 'No Icons' or 'Selected Icons' or 'Icon #0' for example. The
   submenu contains Edit, Copy, Move, Wipe, and Renumber - all as in v2.82.
 - By the way, the 'Button type' menu has been rigged to disallow types 12 &
   13 (reserved) and type 11 is once again referred to as 'Radio'
 - Back to the filer, the next two choices are 'Select All' and 'Deselect
   All'
 - Lastly, 'Tidy Icons' removes any spurious icons that lie wholly outside
   the window's Work Area. Note that this is NOT the same as outside the
   opened window space. For example, in Paint's notorious SaveBox [see
   v2.80, 'Wipe'] the CRAP icon is within the Work Area, but the lack of
   scroll bars on these windows sometimes makes it seem to lie beyond these
   bounds.

NB. When using the default icons on the 'Create' submenu, make sure that you
remember to set the button types of the icons, particularly the arrow icons
(usually Auto-Repeat). The icons default to Click/Drag because they rarely
appear in exactly the right place, so need moving.

Happy templating!!

*****************************************************************************

Updates, Version 2.84 - 07/02/91

Thought for the day:

When I use this - and I do, despite the bugs - I nearly always use the icons
menu rather than the windows menu, but this poses an annoying problem. How
does a lazy programmer (contradiction?) like me delete a window without
using the other menu? Answer: put the 'Delete window' choice on BOTH.
Completely against the idea of separating the two menus, but I don't care.

I was quite stunned when I happened to notice how Acorn handled their icon
indirection workspace - it goes like this.
 - DIM a large block of memory.
 - Set a pointer to the start of this area.
 - Whenever workspace is needed, use the memory at the pointer, and move the
   pointer on.
 - When the pointer reaches the end of the buffer, annoy the user by
   generating errors. This might actually have been 'by crashing without
   explanation' - but if it was, I've already 'corrected' this.

To counteract this problem, the pointer is moved back to the beginning when
the last template is deleted, or if 'Clear' is chosen from the icon bar
menu. Crude, but still better than Acorn.

I've been hassled a lot recently by my friend Anonymous 'Rabbit' (Unknown)
'cos he was getting worked up about the indirection bugs - apparently, when
large, multi-indirected templates are used (waffle) the indirection buggers
up so the icons start to contain bits of the program, i.e. the WRONG BIT of
application workspace. As a result, when you wipe it, bits of your (still
running) program go missing, and crashes ensue.

Alternatively, all the icons are inter-connected, so when you delete the
unwanted bit of one, the other one does spurious things too.

I think I've sussed it though; I looked at the code, changed a few things
and now it seems to work, so to quote the ISV docs, 'Everyone is happy'.

Rabbit was also whining about the way that the files were saved 'backwards'
so that the window stacking is reversed. Big template files have to be kept
tidy in this respect, it was annoying!

I've just done another detail - when a single template was saved before, the
'Original' filename, as appears in the icon bar 'save' box, was changed to
become that of the single template just saved. It was wrong, it's not now.

The other (trivial) bug was that the colours menus did odd things; sometimes
the icon colours menu was in monochrome, and always there were problems with
mobile tick on the currently selected colour - particularly if a menu choice
was made with ADJUST. This is fixed too. Acorn were previously reading the
palette each time the tick moved, to decide which colours contrasted with
which others - this is now, of course, done on the WIMP message which has
something to do with palette changes, and it's faster too.

Typical.

*****************************************************************************

Updates, Version 2.84b  - 01/03/91

Nothing fascinating, as usual: a minor fix to do with 'Icon #nn.Edit.Text',
from where the text sometimes goes walkies. The usual un-recreatable bug
sort of idea, the icon would contain text, but the menu would suggest that
it had a null text string.

Also I added a new choice to the icon bar menu, 'Finish', which is exactly
equivalent to 'Save Templates' then 'Clear Templates'. Some choices, i.e.
'Finish', 'Clear' and 'Save' are now shaded when there are no templates
loaded.

I thought it would be a nice idea to be able to load an application's
'Templates' file by merely dragging the application to FormEd, so it now
attempts to load the file '<app>.Templates', failing if it is not found, or
of the wrong file type (not &FEC 'Templates'). I was right about the nice
idea, it's very convenient! The slight fib is that the normal error 'This
application has no Templates file' occurs even if it exists, but with the
wrong file type. So who cares anyway? Not my problem.

Lastly, the general icons menu now opens such that the pointer is usually
over 'Selected icons', making editing slightly easier. Ta very much Mr WIMP,
see you on the next version of FormEd.

*****************************************************************************

Updates, Version 2.85 - 15/04/91

Back for more, masochist? Even our goody-goody programmer who can't do a
thing wrong otherwise Acorn will slap him on the wrist has taken a copy of
v2.84b-and-a-bit because he got fed up with v1.something by Acorn shite co..

By the way, those who know me - PLEASE - when you find a bug in this, don't
just complain - TELL ME WHAT THE *?#!^& BUG IS!!!! That way I can debug it
faster, n'est-ce pas?

Anyway; I don't like 12-long sprite names, or 12-long text entries for that
matter, when they're not indirected. I've just ironed out some bugs; for
example, I decided I'd had enough of not seeing save icons in xfer_send
windows (ie when the sprite name is indirected) so I took out that
'feature'; so now you can see them, whoopee, hurrah.

I'm not sure exactly what was going on in the way of sprite-area handling
(ie whether sprites are USER or WIMP) but the load and save bits now trap it
all neatly (see the xfer_send job) and the WIMP area is always assumed.

If you get an error (ie of the type with an error box and a line number) be
careful not to choose 'Cancel' as this now quits FormEd without saving.

Those of you (ie most) who've played with v2.85 may have noticed one or two
bigger changes:

 - I took out the crappy sprite editing bits, leaving in just rename, copy,
   delete, load, merge and save. Note now that your own sprite files can be
   merged by SHIFT-dragging to the icon bar; if this worked, and the
   'Sprites' window was NOT open, then a 'beep' tells you that it worked.
   (Actually, any FormEd window that isn't the 'Sprites' one will do.)
 - Select and Deselect icon (from the general icon menu) now have
   sub-wotsit-jobbies. (I suppose I should know their real names, having
   just read the new 'RISC-OS Style Guide', then wondering why I bothered).
 - Choosing [De]Select as normal has the same effect as before.
 - The dialogue boxes enable choices to be made governing which icons are
   (de)selected; other icons are unaffected. Icons of a particular (or
   'any') ESG can be chosen. Icons of a particular (or 'any') Button Type
   can be chosen. An icon's text and/or sprite bit can be tested
   (yes/no/don't care).

*****************************************************************************

Updates, Version 2.86 - 29/04/91

Having played with Impression and found many of the bugs (the rest presumed
to exist only when you're not going to immediately notice) I thought:

'Hey, those shaded icons and the icons that change the pointer shape really
do look crap!'

However, another anonymous accomplice of mine disagreed, but that's just the
way he is, so he adjusted his copy of v2.85 to support this 'Interface'
module he'd just acquired - which does all of the Impression-type junk for
you.

I took one look and said 'NO, NO, NO' a few times, but then took up his idea
of using the MessageTrans module - so now refer to the 'Messages' dir inside
FormEd.

Following that, I decided to support 'Interface' - as a user-configurable
option. Hence on the 'Options' dialogue box you will now see the extra
'Support Interface' and 'Shade user-redrawn templates' icons. (The latter is
present because Interface uses user-redraws to do its icon borders, so
normally you will have one OR the other selected.)

In addition, the country name can be changed so that a different 'Messages'
file is used - it is just the name of a file inside that directory. For demo
purposes, I also include 'Sarcasm' for users with a superiority complex.

There is also a teensy bug fix - your choices in the (de)select dialogue
boxes remain intact. This does not change the effect of choosing (De)Select
without using the dialogue boxes.

*****************************************************************************

Updates, Version 2.87 - 23/06/91

Good grief, it's been a long time since the last one...perhaps I've been
doing some 'real' work for a change...??

No bug fixes, 'cos I haven't found the bugs!!!

Options: A new error message for when you choose a non-existent country. As
before, it chooses 'UK' for you, but it tells you of your error in the
previous language (for continental users rather than for Britons who piss
about).

Menus: The two main menus ('Window' and 'Icons') re-open properly when you
open one, move it and open the other (it used to open where you'd opened the
first one).

Templates: When FormEd loads, a window in the top left called 'Templates'
opens up listing all of the templates loaded. Double-clicking on a template
name toggles its opened/closed state (ie. it will close an opened window and
open a closed one.) SHIFT-double-clicking opens the appropriate window 'on
top'. A menu from this window ( la Filer) allows you further control over
opening/closing, plus facilities for copy, renaming and wiping. By the way,
don't be surprised if 'Copy' doesn't seem to be working correctly - it
SHOULDN'T work, but it seems to!! The 'Templates' submenu from the icon bar
menu tree is now reached from this window too (Create, Clear, Load, Save).
The biggest benefit of this is that the screen does not get so cluttered!!
Rabbit should be pleased, he's got absolutely HUGE template files. NOTE:
closing a template no longer removes it from memory!!!

Handles: A useful utility which displays a small window in the top right of
the screen which tells you which template the pointer is over, and (if any)
what icon number. Most handy for looking over 'imported' templates.

Show: Both 'Templates' and 'Handles' windows can be opened via the icon bar
menu, and the 'Show' submenu.

Work area: The 'set work area' window has an extra option, 'Min'. Choosing
this sets the work area to be equivalent to the visible area. This bypasses
the previous practice of setting the values out of range via the keyboard,
then using the arrows to set the values to their minimum settings.

Mouse fix: Owners of the superb 'Mouse Fixer' module may wish to note that
FormEd now sets the MouseFix variables MinSpeed, Acceleration and FrameCount
to 1, 16 and 4 respectively. This means that delicate mouse control (moving
and resizing) can easily be effected. NOTE: 'FrameCount' is not available in
MouseFix 0.02

Saving: An error number of &1xxC2 is taken to mean 'File Open' - a *Shut is
performed, and a warning is given. The saving process then continues as
before. (If a program Address Excepts, etc. when loading in a template, the
file will be left open.)

*****************************************************************************

Updates, Version 3.00 - 19/12/93 (D. Salt, not a member of The RISC Squad)

To start with, I hope you're using RISC OS 3 (at least!). Just for the
record, this has been under development since February, you know, just a few
days here and there, when some bug or lack of features began to irritate.

FormEd no longer loads the default WIMP sprites; doing so was completely
pointless. Some icons also make use of the InterfaceManager module or RISC
OS 3 to change the pointer shape. I've squashed some of the menus a bit so
that they don't take up inordinate amounts of screen space.

Creation of arrow icons: there is now a choice of types - the pre-RISC OS 3
text arrows, or the new arrow sprites. To implement this, a submenu has been
inserted between the 'Arrow' option and its original arrow direction
submenu. Selection of the arrow type is still done by clicking on the
appropriate direction item.

Icon editing: the font and size currently used is shown when editing either
one icon or the window title. I've also removed a silly but nasty bug which,
when editing selected icons, caused their flag words to be cleared (no text,
no sprite, no border, not filled...) when an attempt to set their background
colours to one of colours 8 to 15. (A case of stupid RISC Squad programmer?)

Icon resizing: there is an extra option 'Resize' in the Icon submenu for
this. It has a submenu which contains two items. Both are coordinate pairs.
The top one is the current size of the icon, measured from the left and
bottom, and is writable. Either value may be omitted, in which case it is
left unchanged, or negated, in which case the icon uses the opposite side as
a baseline, effectively moving it left (x) or down (y) by the specified
amount. If the comma is omitted, the icon is assumed to be square. The
resizing rules are not applied; it is also no longer possible to set the
width or height to zero. The lower menu item is the icon's default size,
which may be clicked on - DON'T assume that this is the best size for it!

Icon positioning: in the 'Icon.Move' submenu, there are two extra options at
the bottom for entering the coordinates of the bottom left corner of the
icon. These are 'Move by' and 'Move to'. You will find when you are moving a
'Selection', 'Move to' is greyed out. Again, the comma must be present, and
either value may be omitted, thus leaving it unchanged.

Icon selection: Shift-MENU to select, Shift-Ctrl-MENU to deselect. The
reason for this is RISC OS 3's icon border types, and the fact that some of
these cause the icon to be selected when clicked on and deselected when
released.

Icon copying between windows: just drag them!

SELECT-dragging icons: Alt-MENU may be used.

ADJUST-dragging icons: Alt-Shift-MENU may be used.

Icon text space is limited only by the amount of free memory. !FormEd will
claim more memory if it needs it. Also, for indirected text (NOT the
validation string...!), entering 0 for the text length defaults to the
actual length plus one, neatly allowing for the terminating character.
Incidentally, this also works on window titles.

Concerning window titles, have you ever allocated, say, 256 bytes for the
title, set the title to something much shorter, saved the template, reloaded
it later, and found that the space you allocated has mysteriously shrunk?
Annoying WASN'T it?

The window flags submenu has been reorganised a bit - out go the old title
and scroll bar flag bits; in come a few new bits for RISC OS 3. You are now
forced to use the 'new format' bits. Translation from old to new formats is
automatic.

You can now have transparent window borders - just set the title ink colour
to 'None'. This, of course, means you can't have a title bar or scroll bars
because no ink colour is defined (think!). You can also have transparent
windows (window paper set to 'None') - setting this will automatically
deselect (and disable) auto redraw.

You'll notice another menu item while you're editing: this is 'Tools'. In
here, we have four items: bring window to front, send to back, toggle size,
and close. Note that 'toggle size' doesn't quite work like the toggle size
icon - it's too much hassle to get it to.

You can grab windows from any application. Just enter a window name in the
submenu for 'Grab' in the template filer menu, then click SELECT or ADJUST
over the window you want. Clicking on 'Grab' won't work (deliberately). You
can't grab the icon bar - this is because, where an icon has indirected
data, that data is in the owning application's workspace.

Window LWA resizing now has a more immediate effect. You can move between
the writable icons now by pressing , , or RETURN. The new size is effected
when 'OK' is clicked on. There is also a 'Max' icon, which will attempt to
set the window to its maximum size. The 'Min' icon now also has an immediate
effect on the window. It should be noted that the effects of the 'Min' and
'Max' icons are not the same as the window's 'Toggle size' icon.

The window menu option 'Work area' now has a submenu containing four items:
'Resize logical' - see the paragraph above; 'Resize physical', which has a
submenu containing one item into which you type the new PWA size as a
coordinate pair; 'Move', which works in the same way as for icons; and
'Scroll', which again works in the same way. You are allowed to move the
window off screen.

A few problems when setting font sizes have been fixed - you can now use
fractional sizes. (FormEd previously crashed if you tried this.) You can
also enter the font height. Try entering an invalid number or zero, you'll
be told, and the font width or height (as applicable) will default to
12.8pt. Also, an extra submenu has been inserted between 'Anti-aliased' and
the font list - this contains three options: 'Font name', 'Font size', and
'Font width'. The latter two only come into effect when a font is actually
selected; also, setting the font size affects the font height. If you're
familiar with the font selection in, say, !Edit, you'll have no problems;
however, clicking on 'Anti-aliased' or 'Anti-aliased.Font name' will select
the system font.

RISC OS 3 users will be happy to know that DragASprite is optionally used
when saving.
 Enable:  SYS "OS_Byte",161,28 TO ,,a%:SYS "OS_Byte",162,28,a% OR 2
 Disable: SYS "OS_Byte",161,28 TO ,,a%:SYS "OS_Byte",162,28,a% AND NOT 2

Saving: you can now save the current window from the icon and window editing
menus. The template filer menu has been extended slightly - from the
template/selection submenu, you can save the selected window(s) in one go -
you previously had to save each window individually, clear the file from
memory, and reload them to save as a complete file. The main save option is
unchanged.

Also, some deleted icons may be removed. For example, in a window with 5
icons, of which numbers 2 and 4 are deleted, only icons 0 to 3 will be
saved. Number 4 doesn't have to be saved as there are no non-deleted icons,
or indeed any icons, with higher numbers.

It is recommended that any window with a toggle size icon is set to its
smaller size, otherwise the icon will not function as expected.

Some use is also made of pointer shape changing via validation strings.

Status: the !FormEd icon displays either 'Waiting', if no templates are
loaded, else 'Editing'.

Loading template files with !FormEd: without CTRL, !FormEd will claim the
file and load it, provided that it has no templates currently loaded. With
CTRL, or if all loaded copies of !FormEd have templates loaded or created,
!FormEd will be reloaded and will load the file.

It is possible to have more than one copy of !FormEd loaded. If the template
file is unclaimed, then the system will attempt to run !FormEd again and
tell it the filename.

FormEd's internal sprite pool no longer exists. It now uses the system
sprite area, giving greater flexibility with large sprite files.
Consequently, sprites cannot be saved.

Loading sprite files with !FormEd: !Paint (or !Edit if SHIFT is pressed)
will grab any files double-clicked on. Therefore, the sprite file must be
dragged to the !FormEd icon (or, preferably, to !SpriteFS if it's running).
If SHIFT or CTRL is pressed, the file will be merged with the system sprite
pool.

The auto-load feature has been extended to cope with sprite files. By
holding down SHIFT or CTRL and dragging the application directory icon to
!FormEd, the sprite file (default '!Sprites') is merged with the system
sprite pool. As yet, there is no way to load both files at once.

CTRL-double-clicking on a template name in the Templates window ensures that
the appropriate window is fully on screen.

Opening the Templates and Handles windows can now be done by clicking ADJUST
on the !FormEd icon.

Some problems in the Templates file have been removed. The windows will not
now grow if they move partly off screen.

*****************************************************************************

Updates, Version 3.01 - 01/3/94 (D. Salt again)

It's just over a year since I got hold of v2.87, and a few weeks since
!NewLook arrived via Arc World.

Fixed the template file and created a NewLook version, which will be used
automatically if !FormEd finds either RISC OS 3.12 (at least) or the
ROMApps3D module. Also some pointer shapes have been removed: the only one
remaining is for window-grabbing.

Updated the 'Create icon' menu tree somewhat:
 Text
  Plain white - white background, black border
  Plain grey  - for sunken-edge box headings. Filled, no border
  Sunken slab - for non-writeable options
  Raised slab - for non-box or raised-edge box headings
  Sunken edge - to group icons together (options)
  Raised edge - to group icons together (?)
   Unless specified, all are black ink on a light grey background.
 Arrow
  Old RO3 - the blue arrow icons
  NewLook - the grey arrow icons, which turn yellow when pressed
   These both lead to a submenu containing the four directions and a new
   option 'Options' - this is either a grey right arrow (old type) or an
   iconised menu (new type). The 'Text' option has been removed. Don't worry
   if the 'wrong' icon is shown - it just means that the 'right' set hasn't
   been loaded or has been replaced (the two sets share the same sprite
   names).
 Writeable
  Plain       - as found in FormEd's 'New template' dialogue box
  Wide border -
 Menu
  Cream (old) - the old type, typically found as the 'OK' icon in save boxes
  Plain       - grey, will slab in when clicked. Is actually 'click/drag'
  Wide border - highlighted version of 'plain', eg. when you close a file
                with unsaved changes, 'Cancel' will be plain, 'Save' will be
                highlighted

Sprite, Option, Radio, and Comment are unchanged.

The example uses may be wrong - I don't have the Style Guide.

Newly-created icons are locked to a medium-resolution mode pixel grid - the
X coordinate is a multiple of 2, the Y coordinate is a multiple of 4...
unlike some of Acorn's icons (eg. Edit's 'Discard' in its NewLook "File
'xxx' has been modified" - just try this in mode 12!).

The Updates file is getting large! (So I squashed it a bit.)

*****************************************************************************

Updates, Version 3.02 - 25/5/94 (D. Salt again)

Now tried on a RISC PC at the yearly (I hope) exhibition at Northumberland
College in Ashington (on 25 May). Thanks must go to Morley Electronics for
turning up with one. As a result, a few minor tweaks to the templates to
cope with automatic outline font use...

Beware grabbing the Pinboard! This is transparent, so it LOOKS like a bug.
If you do, click Menu anywhere above the icon bar and select Tools.Close to
fix it.

*****************************************************************************

Updates, Version 3.50 - 11/8/94 (D. Salt)

Started at the beginning of June and mostly completed by 14 June.

Well, it's time to say goodbye to the old faithful menu structure. Sniff.
I've decided to replace this cumbersome, inflexible and sprawling mess with
a (hopefully not cumbersome, inflexible and sprawling) dialogue box system.
This is something I've had planned for 'the future' for ages, but, as a
result of a few small but significant suggestions from the Man from Morley
(eg. copy by), 'the future' has become 'the next release' - ie this. And
it's not long since v3.02 either...

I suggest you read the !Help file as I don't want to make this file any
longer than I have to. However, I will also mention the main changes here:
 - arrange icons into rows/columns;
 - more flexible selection editing (ie. you don't have to);
 - more flexible resizing (via editing window);
 - improved window & scroll bar positioning;
 - improved LWA resizing;
 - AutoLoad file lists and (for the sprites) *IconSprites-type suffixes;
 - library of common windows and icons.

The tick/template identifier icon in the template file window has been split
into two icons. This ensures that the names don't jump when a template is
opened or closed.

The library is user definable for each territory. It is
  !FormEd.Resources.<territory>.Library.
where <territory> is the appropriate territory name (the default is "UK").
In this directory are some template files - just drag one to any !FormEd
window to merge it with your templates. There are also two text files, one
called "IconDefs", which contains the icon library (found at the top of the
'create icon' menu), and "Readme" which contains some information about
the templates (which icon does what), and also briefly describes the icon
definition format.

You can open the library directory from either the main menu or the template
file menu. The main menu also has an option to reload the icon definitions.

There's a (somewhat arbitrary) limit of 250 of icons in a window. This is
entirely to do with !FormEd's internal memory allocation, and is there as a
safety measure. I would have extended this to check the templates when you
load a file, but it's not possible without completely replacing
Wimp_LoadTemplate - so if it crashes when you've just loaded some huge
templates - not necessarily huge template files - you'll know why.

*****************************************************************************

Updates, Version 3.51 - 28/8/94 (D. Salt)

You can now change the font name, width or height for one or more icons,
while preserving the other information about the font(s) used.

A system variable, Territory$Name, is defined to contain the current
territory name.

*****************************************************************************

Updates, Version 3.52 - 5/9/94 (D. Salt)

Bug fix - CTRL-click on template name now works. (Been there for months and
I've only just noticed it!)

"Size lock" added to font menu - when off, setting the 'size' just sets the
width; when on, it sets the height as well. This setting is saved in the
options file.

*****************************************************************************

Updates, Version 3.53 - 20/10/94 (D. Salt)

Bug fixes - template list window is now updated when renaming a template,
and NewLook arrows don't have <Untitled> plastered across them.

Library templates and icon list updated slightly to try to take account of
the way the RISC PC handles outline fonts in icons. As I have an A3010, I
can't check them.

*****************************************************************************

Updates, Version 3.54 - 20/10/94 (D. Salt)

Another bug fix, and a small compression aid: when two template files are
merged, the templates are kept in the correct order, except where names
clash, in which case (as before) the new one replaces the old one. Also,
when saving, rubbish is removed from non-indirected icons, title bars, and
template names.

*****************************************************************************

Updates, Version 3.55 - 6/11/94 (D. Salt)

New option in the Options window - "Bring editing window to front" - which,
when selected, causes the editing window (and pane) to be brought to the
front whenever Menu is clicked to select a window or icon for editing. It is
also possible to do this by clicking on any unused part of the window or
pane.

Another bug fix: 'Select all' and 'Clear selection' now work again, and the
workspace compaction feature is now working correctly.

*****************************************************************************

Updates, Version 3.56 - 14/2/95 (D. Salt)

'Load' option replaced with 'Sort' option. This sorts the templates by name,
into ascending ASCII order.

3.56a - 12/5/95

Fixed ADJUST-close on template list window.

*****************************************************************************

Updates, Version 3.57 - 17/4/97 (D. Salt)

Added a repeated string packing function to template saving, and a config
option to control this.

*****************************************************************************

Updates, Version 3.59- 4/12/02 (D. Salt)

32-bit compatible.

*****************************************************************************

A very nice feature: if you're told that workspace is running out (and a
scrap file is set), try opening the 'save all templates' window and hold
down SELECT on the file icon until a drag operation is started, then release
it. A scrap file will be saved, immediately reloaded, then deleted, thus
ensuring no gaps in the workspace area. (Until you get a disk error!)

*****************************************************************************

PS. THE RISC SQUAD entirely disowns, disconnects itself from, FA to do with,
etc., Nicholas A. Smith of Bucks., England. - aka 'Nik the Devil'. It most
certainly is NOT a member!!

*****************************************************************************
