DESCRIPTION:

This is an updated version of AmIRSay.amirx, with added WookieSay.rexx,
a WookieChat adaptation.

It's based on version 5.6* of the script and has been bumped to 6.1 in
order to match the latest AmIRSayPrefs version.

*note: I'm not sure where my v5.6 script came from -- the latest main
       archive contains V5.0b -- but v5.6 has localization disabled and
       a few changes related to the prefs.
       It shouldn't be too difficult to re-enable localization so I'll
       do that if there's enough demand for it.


BUG? FEATURE!

My original intent was to add speech to WookieChat as its new AREXX port
made it possible, but in the process I stumbled upon bugs in both the
AmIRSay script and the AmIRSayPref binary which caused crashes in OS4.

I've taken care of the problems in the script, it was calling functions
which OS4 doesn't seem to like inside a forbid/permit pair.

However I didn't fix AmIRSayPrefs as it is written in 'E' and I neither
have time to learn 'E' and setup an 'E' compiler, nor port it to 'C'.
If you feel like fixing and/or porting AmIRSayPrefs, the .e sources can
be found in the amirsay.lha archive on Aminet.

The bug in AmiIRSayPrefs is that it writes a pair of extra chars in front
of the 'Default' line of the [VOICES] section when saving the prefs,
causing a hit the next time it loads the prefs and reads that line.

The workaround is to delete the two extra chars after saving the prefs.
I've provided an AmIRSayPrefs wrapper script which does just that.


INSTALLATION:

- Copy AmIRSay.amirx to the AMIRC/Rexx drawer and/or copy WookieSay.rexx
  to WookieChat/arexx_scripts drawer.

- Copy AmIRSAY.cfg to S:

- Make sure you have the "Say" command in C:, :System, or :Utilities.

The script should then appear in the Arexx menu the next time you launch
the IRC client and be ready to use.

I also recommend downloading the original AmIRSay archive from
http://aminet.net/comm/irc/amirsay.lha

The archive contains some helpful documentation, and the AmIRSayPrefs GUI
which makes it easier to configure the voices.


OS4-SPECIFIC NOTES:

If you wish to install the original AmIRSayPrefs, copy it to your AmIRC
and/or WookieChat drawer, and rename it to "AmIRSayPrefsX", then copy
the AmIRSayPrefs from this archive to the same location.
This replacement AmIRSayPrefs is a wrapper script which launches the
real prefs and then fixes the typo in the config file.
That way you can safely launch the prefs from its icon or the IRC client
without causing a Grim Reaper.
Consequently, do not launch AmIRSayPrefsX directly and save the settings
or the unfixed typo will cause it to crash the next time it is launched!

Since update 3 or 4 of OS4 "Say" crashes on exit. The reason seems to be
that it tries to flush narrator.device, which doesn't flush too nicely.
The only way to prevent it from flushing is to keep the device's open
count above 0, and the easiest way to do that is to mount SPEAK: before
using "Say", but make sure the SPEAK.info tooltypes have the line
"activate=1" set or the open count won't stay above 0.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 4405    5061  87.0% -lh5- 581f Oct  2 14:12 AmIRSayUpdate.info
[generic]                 5985   16279  36.8% -lh5- bae0 Oct  2 00:28 AmIRSayUpdate/AmIRSay.amirx
[generic]                 7462    9294  80.3% -lh5- 78ba Oct  2 14:12 AmIRSayUpdate/AmIRSay.amirx.info
[generic]                  271     347  78.1% -lh5- c8bc Oct  1 22:48 AmIRSayUpdate/AmirSay.cfg
[generic]                 7258    9284  78.2% -lh5- 6210 Oct  2 14:12 AmIRSayUpdate/AmirSay.cfg.info
[generic]                  800    1759  45.5% -lh5- c3e2 Oct  2 14:10 AmIRSayUpdate/AmIRSayPrefs
[generic]                 5105    5607  91.0% -lh5- 2917 Oct  2 14:12 AmIRSayUpdate/AmIRSayPrefs.info
[generic]                 1657    3355  49.4% -lh5- e6b5 Oct  2 14:25 AmIRSayUpdate/README
[generic]                 4119    4908  83.9% -lh5- 5678 Oct  2 14:12 AmIRSayUpdate/README.info
[generic]                 6046   16554  36.5% -lh5- 8412 Oct  2 00:27 AmIRSayUpdate/WookieSay.rexx
[generic]                 4278    4900  87.3% -lh5- 5a77 Oct  2 14:12 AmIRSayUpdate/WookieSay.rexx.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files   47386   77348  61.3%            Oct  2 17:38