
                 -----------------------------
                 Source for Ispell (Release 3)
                 -----------------------------

            (*ispell 3.1.07 [Arc1.1] / !Ispell 1.3)



(Re)compiling *ispell 3.1.07 [Arc1.1]
-------------------------------------

IMPORTANT:

  You will need a version of bison to compile BuildHash.  You can
  obtain bison via FTP or HTTP from `micros.hensa.ac.uk'.

Simply run amu with a target of "all" to make all the binaries and
the hash dictionary.  Running amu with a target of "install"
should do the above and also place the binaries and dictionary in
their correct places, with appropriate access and type.  But just
make sure that Ispell has been seen, i.e. !Ispell.!Boot has been
run at some point in the past.  

NOTE:

  If you do not have the DDEUtils module you will need to change
  the definition of INSTALL and CD in the make file to use the CSD
  symbol (@), rather than <Prefix$Dir>, and ensure that your CSD
  is set up corretly.

If it just won't work, even with your best endeavours, then
contact me at the address below with a detailed and accurate
description of the problem and I'll try to solve it.  There's
nothing worse than a Makefile that just doesn't make.



(Re)building a base dictionary
------------------------------

The lexicon fragment files provided with in this distribution are:

     English.0
     English.1
     English.2
     English.3
     British.0
     British.1
     British.2
     American.0
     American.1
     American.2
     Altamer.0
     Altamer.1
     Altamer.2

The higher the number of the file's suffix the less common the
words it contains are.  The English lexicons contain a core of
spellings common between both Standard English and American
English.  The British and American lexicons contain spellings for
the two respective countries.  The Altamer lexicon contains the
alternative American spellings mentioned above.  The dictionary
provided in the binary only distribution was built using the
English, British and American files with suffixes of 0 and 1.

To make the medium British dictionary go to the directory
!Ispell.Source.Languages.English and at the CLI use,

     Run Ispell:Library.Merge Temp British.0 British.1 English.0 English.1

followed by,     
    
     Run Ispell:Library.BuildHash Temp English.aff Ispell:Resources.British
  
The syntax of BuildHash is

     BuildHash [-s] plain_text_file affix_table base_dictionary

BuildHash only accepts a single plain text file so the plain text
files must be collated using Merge.  The syntax of Merge is

     Merge outfile infile1 infile2 ...
     
BuildHash requires an affix table.  For English this will normally
be the file `!Ispell.Source.Languages.English.English.aff'. 
Finally, if you place the resultant base dictionary in the
directory `Ispell:Resources' you can simply given the leaf name of
the file to *ispell, either on the command line or via !Ispell.
     



David Bryan
37 Mill Dale Road
Kettering
Northants
NN15 6QD
England
