Short:        YAM: spell checking while typing
Author:       Rofdolfo Ignazi rodign@inwind.it or rodign@tiscali.it
Uploader:     chris unsatisfactorysoftware co uk (Chris Young)
Type:         comm/mail
Version:      0.5.0_OS4_5 (11.11.2007)
Architecture: generic

This is a fixed version of the iSpell_YamEdit script that works with the OS4
version of iSpell and latest YAM/texteditor.mcc -- Chris

Premise:
    It don't use MuiRexx.

Installation:

    Open a new Shell window, and type (replacing <language> with the
    iSpell dictionary you want to use):
    SETENV SAVE ISPELLYAM <language>

    Assuming the path you place the script is "Internet:YAM/Rexx/"
    directory:

    In YAM setting menu choose -> MUI:
    In MUI setting window choose ->TextEditor:
    Click on "Spell checker",
    find "Lookup command" string gadget then type on it as follow:

 ->  Run >nil: <nil: SYS:Rexxc/RX Internet:YAM/Rexx/iSpell_YamEdit.rx %s

    I suggest to make the RX command resident, in this case the launch
    line would be like this:

 ->  Run >nil: <nil: RX Internet:YAM/Rexx/iSpell_YamEdit.rx %s

    Then choose CLI in the lookup gadget: "Lookup command [CLI]"

    Leave both
     "Spell check as you type?"
     "Lookup word before suggesting?"
    buttons unchecked.
    Save.

Note:
It's important to type the command exactly as shown above otherwise any
Yam activity may be suspended.

Usage:

In Yam Editor go to the "Edit" menu select "Type and spell" and check it.
Now,
while you are typing your text in Yam editor your words will be checked
one by one and when a word is not recognised by iSpell a requester will
pop up with the suitable suggestions for that word.
If you click upon one of the suggestions the new word will replace the
wrong one under the cursor.
If iSpell has no suggestion it appears a different requester informing you.
In both requesters you'll have the options to `Add' your word to the iSpell
user dictionary or to `Accept' the word until Ispell is running or "Cancel"
to exit and do nothing.

If you are a very, very fast typewriter it may happen that you move the
cursor before the script takes control so, this may cause the new word not
to be placed in the exact place as the old one, leaving some spurious
character before and after it.

Note that in the replace requester the words `Add', `Accept' and `Cancel'
are been truncated, this is to reduce the cases where MUI switches to the
smallest font when very long strings are sent to the requester (the string
sent to this requester may be very variable).
(Strings that exceeds 140 characters are not accepted by the YAM requester,
 in these cases you will have the standard Amiga error signal: the flashing
 of the screen or/and the beep).

If iSpell has not been started before, you will note it to start in the
very first word you type.

NOTE:
   iSpell_lang.rx,  iSpell_exit.rx and  iSpell_all.rx
   by Brecht Machiels, Lorens Johansson, Roger 'Ben' Bennett
   (Thank to them for the idea and the grabbing of some code)
   are still in use as I did not make any replacement for
   those scripts.

IMPORTANT:
   Before first use, you must issue the following command, replacing
   <language> with the name of the iSpell dictionary you want to use:
   SETENV SAVE ISPELLYAM <language>

To correct some possible errors in the iSpell user dictionary edit the file
"ispell:lib/.ispell_english" (or the language you are using).
I experienced that the first line should be left blank.

Furthermore iSpell seems to ignore some often used English contractions.
The following example explains you how to make them acceptable.
E.g. for "shouldn't":
When you type shouldn't, on typing the apostrophe  (')
the requester pops up, with the word "shouldn", click on [Add] then
click Yes on the second requester, and from now on "shouldn't" will
be accepted.

Last but not the least a big thank to my friend Allan Rasmussen, who
kindly tested it and gave me very useful suggestions and bug fixes
indications.


-----BEGIN PGP MESSAGE-----
Version: 2.6.3in

iQB7AwUARzbqarO1+24s2ZO5AQGWkAMpAXIhB4gIm7xw8R2NYXuVQ9sSJGvWjzLU
IpX7pOsbHWhDqjql/PuxjKuLUDbID/96jwuKdVqy2GCsJHjIGA8KCchH7mMSy88L
O463ltSMzu+4oTKsH7XW6c90iEg6BEKuok7Xke0x
=FkcP
-----END PGP MESSAGE-----