Below is the original 'Read me' file provided by Andy Armstrong.

The CoolSwitch version in this zip archive is actually 1.06. It's 32-bit
clean and should also be ARMv7 compatible (but I can't check that as I
don't have anything running RISC OS on ARMv7).

Frank de Bruijn
frank@aconet.org

============================================================================

This is the 1.05 version of CoolSwitch, a little utility which came out of a
discussion on comp.sys.acorn.programmer about why there was no utility for
RISC OS which did the same thing as the Windows Alt-Tab task switcher.

I thought about this for a bit and decided that

   a) the Alt-Tab behaviour was fine for Windows, but didn't really have all
      the functionality needed for RISC OS and

   b) it would be nice to have a list of tasks to step through so you could
      see how far you have to go to get to the one you want. I think I heard
      that Windows 95 works like this but I haven't seen it yet (as of late
      June 95, the time of writing).

So here's CoolSwitch. Pressing Alt-Tab presents a list of tasks which have
open document windows, and pressing Ctrl-Tab presents a list of open windows
for the task which owns the topmost window. Beyond that I think things are
pretty predictable. To summarise, keep hitting (Shift-)Tab while the little
CoolSwitch viewer is on screen to step through the tasks / windows. When you
get to the one you want release Alt/Ctrl and that window / task will be
placed at the front of the pile.

Placing a task at the front of the pile involves reopening all its windows
in their same relative stacking order but in front of all other windows.

The initially selected window/task is arranged so that a single
(Alt/Ctrl)-Tab will swap between two recent tasks/windows.

Oh yes; if you want to quit it use the Task Manager menu.

Known bugs:

The caret placing code doesn't work with some task which use multi-pane
document windows. Impression is one such application and there may be
others.

Things to do:

Make it possible to redefine the hot keys. In particular I think Ctrl-Tab
clashes with a few things.

Include the icon bar in the list of tasks.

Technical notes:

There was a lot of discussion on comp.sys.acorn.programmer about whether you
could find out which windows were open, what their titles were, which task
owned them etc. I'm including the (rather messy) source code in this archive
to answer those 'how do you...' questions for the curious.

Please let me know if you like it/hate it or whatever, and in particular I'd
like to get reports of any nasties beyond those which are known.

Andy Armstrong
andy@wonderworks.co.uk
