Speaktime 1.2 - Commodity version.
by Gary Walker, 323a Annesbrook Dr., Nelson, New Zealand.
You can contact me on Bitstream BBS as Gary Walker,
on BIX as REL, or email me rel@bix.com

Compiled with SAS/C Version 6.51.

History:
V1.0: First release, non-commodity version.

V1.1: First Commodity version, slightly improved pronunciation of
some syllables.

V1.2: This release; eliminated some unused commodity code to slightly
reduce the size of the executable. Added docs on Hotkey ToolType.

About this program:

This program came about because I hate depth-arranging screens just to find
out what the time is.
The first version of the program I developed just spoke the time when called
by the icon (or when typed from the CLI), and exited. This is fine so long
as you can get to a CLI or the WorkBench screen.
I also wrote the program to learn more about commodities programs, and to
further my knowledge of the C language.

System requirements:

This program requires AmigaDos 2.04 or later, plus the narrator.device
in DEVS: and the traslator.library in LIBS:
This particularly applies to AmigaDos 3.x users, as they do not have
these files. Please try and use the WB2.04 (V37.1) versions if possible, 
as they are the ones used to develop the program. They are available on
the WorkBench 2.04 distribution disks.

How to install it:

Just drag the icon into your WBStartup drawer, and the program will be
active from the next reboot.

How to use it:

Once the commodity is active (there are no telltale signs except a small
dip in available memory), just press alt-z and it will speak the current
setting of your system clock. Either alt key will work.
If you haven't set your clock correctly, don't blame me if it tells you
the wrong time :)
Because it is a commodity, alt-z at any screen will initiate the speech.
You can force use of one or the other alt-keys instead of both by
specifiying the tooltype like this:
QUALIFIER=LEFT_ALT
That example will force the program to recognise only Left-Alt-z.
You can do the same for Right-alt by altering the Qualifier Tooltype.
The default is use of either alt-key.
You can also add the Tooltype:
HOTKEY=whatever else
where whatever else could be ctrl alt b for example.
This will force Speaktime_Cx to use your combination of hotkeys to
activate.

How to remove it from memory:

To remove the commodity from memory, just double-click its icon or run
it again from the CLI.
Once again, there will be no visible sign that it has gone, except that
your free memory will increase again. It will not free ALL memory, as
the libraries will stay resident, unless you do an 'avail flush' from
the CLI.

What to do if it doesn't work or crashes your machine:

Do you have the volume up loud enough to hear it?
Check that you have the correct versions of narrator.device and
translator.library installed. These MUST be AmigaDos 2.04 or
later.
Remember that this program swallows the hotkey combo and doesn't give 
it back, so any other program that needs alt-z will never get it. 
If you need alt-z for another program, use another hotkey.
Don't flame me! I ran this program billions and billions and billions
of times on my two machines, and it works fine for me.

If all else fails, send me a message on Bitstream and I'll see if I can
help you out. If you do, please let me know your machine type and
memory, your Kickstart/WorkBench versions, plus any other programs
started before SpeakTime.

Above all: Don't Panic!

Copyright:

This program is copyright (c) 1994 Gary Walker.
I place this program, and its sourcecode into the public domain.
Permission is hereby granted to distribute this archive so long as
all files within it remain unaltered, and this readme.cx file
remains with the original program.
You may do what you wish with this program, except claim that it
is your own or charge money for it. An exception is made for
Fred Fish to include it in his archives, and to charge his
normal fees for distribution.


Suggestions:

If you have any suggestions (or food or money or cars or private-
jets) please send them to me. I'll make very good use of them :)

Have fun.