home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Programming / MUI / MCC_TextEditor / iSpell / Help / iSpell_Setup.TXT next >
Encoding:
Text File  |  1999-08-20  |  8.9 KB  |  233 lines
  1. Hello YAMmer's,
  2.  
  3. Here is my 2ยข worth on "How best to use iSpell_3.1.18p4 with YAM_2.0"...
  4.  
  5. I have successfully installed and used both AlphaSpell_6.2 and iSpell_3.1
  6. .18p4 with YAM_2.0
  7.  
  8. I initially used ASpell but switched to iSpell because it is more versatile.
  9.  
  10. This is what you need to do to get iSpell functioning with YAM_2.0
  11.  
  12. Steps:
  13. ------
  14.  
  15. 1. D/L Aminet util/gnu ispell31p4bin.lha 660k (Do NOT use any other version!)
  16.    D/L Aminet util/libs ixemul-xxxx.lha (For your CPU!) Required by iSpell!
  17.  
  18. 2. Install iSpell_3.1.18p4 as follows:
  19.    After decompressing the .lha, rename the "ispell-3.1.18bin" directory to
  20.    "iSpell", then copy it to where ever you want it to reside...  Ensure
  21.    that the "iSpell" sub-directories "bin" and "lib" and their contents are
  22.    retained inside the "iSpell" directory so that the attached iSpell .rexx
  23.    scripts can locate the iSpell Rexx Server and the iSpell dictionaries as
  24.    needed...
  25.  
  26.    Copy (For your CPU!) ixemul.library and ixnet.library to LIBS:
  27.  
  28. 3. Ensure that iSpell is assigned in your S:User-Startup or some other
  29.    location for your assigns!  eg. Assign iSpell: DH0:Read-Edit/iSpell
  30.  
  31. 4. Copy these attached MUI iSpell .rexx scripts to:
  32.    iSpellSuggest.rexx to MUI:Rexx
  33.    iSpellLookup.rexx to MUI:Rexx
  34.  
  35.    *** and ***
  36.  
  37.    Set up SYS:MUI/TextEditor *** OR *** YAM:MUI/TextEditor as follows:
  38.  
  39.    Note: Since these iSpell .rexx scripts can be used for *any* program that
  40.    utilizes the MUI:TextEditor.mcc, I recommend SYS:MUI/TextEditor...
  41.    YAM will use the SYS:MUI/TextEditor settings unless you use a different
  42.    set up in the YAM:MUI/TextEditor settings...
  43.  
  44.    Spell checker:
  45.                   Lookup command: [ARexx] MUI:Rexx/iSpellLookup.rexx %s
  46.                  Suggest command: [ARexx] MUI:Rexx/iSpellSuggest.rexx %s
  47.  
  48.                           Spell check as you type? = Checked (Recommended)
  49.                     Lookup word before suggesting? = UnChecked (Automatic)
  50.  
  51.  
  52. 5. Copy these attached YAM iSpell .rexx scripts to:
  53.    iSpellAll.rexx to YAM:Rexx
  54.    iSpellExit.rexx to YAM:Rexx
  55.  
  56.    *** and ***
  57.  
  58.    Set up (2) of your YAM Config/ARexx 'Scripts' menu entries (0-9) to use:
  59.    YAM:Rexx [ARexx] iSpellAll.rexx  (Do Not select "Open console window")
  60.                                     (Do Not select "Wait for termination")
  61.  
  62.    YAM:Rexx [ARexx] iSpellExit.rexx (Do Not select "Open console window")
  63.                                     (Select "Wait for termination")
  64.  
  65.    *** and ***
  66.  
  67.    Set up YAM Config/ARexx 'Program Startup' to use:
  68.    YAM:Rexx [AmigaDOS] iSpell:bin/iSpell -r > NIL: < NIL:
  69.                                     (Do Not select "Open console window")
  70.                                     (Do Not select "Wait for termination")
  71.             (This starts the iSpell Rexx Server when YAM is started.)
  72.  
  73.    Set up YAM Config/ARexx 'Program Termination' to use:
  74.    YAM:Rexx [ARexx] iSpellExit.rexx (Do Not select "Open console window")
  75.                                     (Select "Wait for termination")
  76.             (This quits the iSpell Rexx Server when YAM is quit.)
  77.  
  78.  
  79. With this setup:
  80. ----------------
  81.  
  82. 1. When you type a word that the iSpell:lib/dictionaries do not recognize
  83.    you will get a System Alert (per your SYS:Prefs/Sound preferences).
  84.  
  85. 2. You can select (Double Click) a word and press 'RShift Help' and a list
  86.    of suggestions will pop up and you can select the appropriate one.
  87.  
  88. 3. You can Spell check ALL text in the "TextEditor" YAM Write message
  89.    window by selecting the iSpellAll.rexx script you included in step 5.
  90.  
  91. 4. You can QUIT the iSpell Rexx Server anytime by selecting the
  92.    iSpellExit.rexx script you included in step 5.
  93.  
  94.  
  95. iSpell .rexx scripts purpose:
  96. -----------------------------
  97.  
  98. 1. iSpellAll.rexx is for spell checking ALL text in the "TextEditor".
  99.    iSpellAll.rexx can be used to conveniently ADD words to the iSpell:lib/
  100.    .ispell_xxxx (User Dictionary)
  101.  
  102. 2. iSpellLookup.rexx is for spell checking each word (Spell-As-You-Type)
  103.    in the "TextEditor".
  104.  
  105. 3. iSpellSuggest.rexx is for spell checking a selected word using 'RShift
  106.    Help' in the "TextEditor".
  107.  
  108. 4. iSpellExit.rexx is to QUIT the iSpell Rexx Server.
  109.  
  110.  
  111. Notes:
  112. ------
  113. I have attached (6) .IFF images to help you with the Set up instructions for
  114. Steps: 4 & 5, and to change the MUI:TextEditor Keybindings if desired... 
  115.  
  116. I changed the MUI:TextEditor Keybindings default of 'Help = Suggest spelling'
  117. to 'RShift Help = Suggest spelling'...  That fixed a problem I was having
  118. whenever I used 'Help = Suggest spelling' which caused the YAM.guide to
  119. pop-up instead of the Spell checker window with a list of suggestions...
  120.  
  121. If you select a word to Spell check using 'RShift Help' in the "TextEditor":
  122.  
  123.  1. If the word is recognized, you will get a message "Word is correct".
  124.     This indicates that iSpell found a word spelled exactly the same way
  125.     you spelled it in the iSpell:lib/Main or User dictionary...
  126.  
  127.  2. If the word is NOT recognized, you will get a list of suggestions with
  128.     words to select from unless iSpell does not have a suggestion in which
  129.     case you will get a message "No suggestions".  This indicates that
  130.     iSpell could NOT find any word spelled exactly the same way you spelled
  131.     it in the iSpell:lib/Main or User dictionary...
  132.  
  133.     (Words are CASE sensitive in the Main and User dictionaries)
  134.  
  135.  
  136. It appears that iSpell has difficulty with Upper Case characters and will
  137. display a spelling error because of this eg. Arexx | arexx | ARexx | aRexx
  138. iSpell will accept Arexx and arexx but will NOT accept ARexx or aRexx even
  139. though they are ALL spelled the same...  iSpell will accept the Case of the
  140. first character (Capitalization rules) but will not accept any additional
  141. characters that are in Upper Case unless ADDed to the User dictionary.
  142. So, using this example you would need to ADD ARexx and aRexx to the User
  143. dictionary if you wanted iSpell to accept those Case differences...
  144. This is not a problem for common words, but some Amiga filenames use a
  145. mixture of Case...
  146.  
  147. This text contains eg. TextEditor | AlphaSpell | AmigaDOS | StopSpell |
  148. iSpell | YAM | ASpell | MUI etc. that will not be accepted unless ADDed to
  149. the User dictionary and spelled with the exact Case per these examples...
  150.  
  151. There is also a problem with (.) periods inside names eg. mmikee@cts.com
  152. Some other special characters cause problems for iSpell eg. (-) Hyphen and
  153. (_) Underscore and probably others that I have yet to discover...
  154.  
  155. You may experience some YAM crashes when switching between the various
  156. iSpell .rexx scripts...  Therefore, SAVE SAVE SAVE...
  157.  
  158. I have included iSpell .rexx scripts and set up procedures to provide the
  159. least amount of iSpell Rexx Server starts and restarts that I'm aware of...
  160.  
  161. The iSpell Rexx Server may cause your Virus checker program to show an
  162. alert (Memory Vectors) since it is copied to RAM...
  163.  
  164.  
  165. Troubleshooting:
  166. ----------------
  167. If you were previously using AlphaSpell, ensure that you recheck ALL of the
  168. SYS:MUI/TextEditor settings and MUI:YAM/TextEditor settings as well as the
  169. YAM ARexx 'Scripts' menus etc. for proper scripts, paths and actions...
  170.  
  171. AlphaSpell uses AmigaDOS scripts as the Spell and StopSpell scripts...
  172. This requires MUI/TextEditor Spell check Lookup and Suggest commands to
  173. be QUOTED " "...  YAM ARexx 'Scripts' menu entries to be [AmigaDOS]
  174.  
  175. iSpell uses ARexx scripts for ALL of the iSpell .rexx scripts...
  176. This requires MUI/TextEditor Spell check Lookup and Suggest commands to
  177. be UnQUOTED...    YAM ARexx 'Scripts' menu entries to be [ARexx]
  178.  
  179. Make sure that your iSpell:lib/.ispell_xxxx (User Dictionary) is not
  180. corrupted...
  181.  
  182. Check if your MUI:TextEditor "Spell check" Keybinding is being used by
  183. another ACTIVE Amiga program which could create a conflict?
  184.  
  185. Check SYS:MUI/TextEditor settings *** vs *** MUI:YAM/TextEditor settings
  186. for a conflict in the Spell checker and Keybindings sections...
  187.  
  188. Maybe you are using some patch or hack that is interfering...
  189.  
  190.  
  191. I hope this helps you get iSpell and YAM functioning...   I LIKE IT!
  192. iSpell is very useful and I find it saves much time and embarrassment...
  193.  
  194.  
  195. There are (4) YAM ARexx programmers (that I'm aware of) who collectively,
  196. have been able to get iSpell and YAM functioning reasonably well together...
  197.  
  198. 1. Brecht Machiels <darklite@flashmail.com>
  199. 2. Lorens Johansson <SnorsleX@SoftHome.net>
  200. 3. Roger "Ben" Bennett <bennett@net.ntl.com>
  201. 4. Markus Maier <mkm@gmx.de>
  202.  
  203. DO NOT USE: iSpell_3.3ljr or iSpell_3.1.20  They do not work with this setup!
  204.  
  205.  
  206. While using iSpell with YAM, PLEASE keep track of any problems that you
  207. encounter and report them to the YAM.ML and hopefully some more of them
  208. will get resolved...
  209.  
  210.  
  211. Thanks To:
  212.  
  213. 1. Marcel Beck (YAM_2.0)
  214. 2. Jesper Skov (iSpell_3.1.18p4)
  215. 3. Brecht, Lorens, Ben and Markus (ARexx programming of iSpell .rexx scripts)
  216. 4. Allan Odgaard (MUI:TextEditor etc.)
  217.  
  218.  
  219. Later,
  220. Mike
  221. --
  222.  
  223.   Mike Hendren              C64 - C128 - Amiga
  224.  
  225.              Commodore Connection
  226.  
  227.       Hardware/Software  Repair/Service
  228.  
  229.                E-mail: mmikee@cts.com
  230.            Snail-mail: 1118 Old Stage Road
  231.                        Fallbrook, CA 92028
  232.                 Phone: (760) 731-0924
  233.