This is a DJGPP port of Ispell 3.2.06

Installation
============

1. Unzip the package from the root of your DJGPP installation tree,
   preserving the directory structure (use -d switch if you unzip with
   PKUNZIP).  This will put the binaries inside the bin/ subdirectory, the
   dictionaries inside lib/ and the docs inside info/.

   (Note that the zip file is LFN-clean, i.e. it lists the long names
   of all the files, so if you work on Windows 9X, you should unzip it
   with a program which supports long filenames.)

2. That's all!  You can now invoke Ispell like so:

	  ispell file

   where <file> is the name of the file you want to spell-check.  To
   use the British spelling of words, say "ispell -d british file".

   The auxiliary programs defmt-c.exe and defmt-sh.exe are simple
   deformatters for spell-checking comments and strings in C/C++
   sources and Unix shell scripts.  For more about their usage, see
   the documentation of the -F command-line option to Ispell in the
   ispell.1 man page.

   The shell scripts (findaffix, munchlist and tryaffix) require a port of
   Unix shell and other Unix utilities to run them.  If you need to run
   them (it is only required when you have to create a dictionary of your
   own), install the ports of Bash, Fileutils, Textutils, Sh-utils, Gawk
   and Grep, and invoke the scripts like so:

		 sh munchlist ...



Environment variables
=====================

These are your primary means of customizing Ispell.  The standard
variables supported by Ispell on all platforms are documented in the
ispell.1 man page; the DOS-specific variables are described below:

	ISPELL_OPTIONS - the default options to pass to Ispell.  These
			 are passed to Ispell as if they were typed by
			 you before all the options you actually
			 mentioned on the Ispell command line.  Since
			 Ispell parses options left to right,
			 options from the command line may override
			 those in `ISPELL_OPTIONS' variable.

	ISPELL_DICTDIR - the directory where Ispell will look for the
			 alternate hashed dictionary file.  The
			 default dictionary pathname is built into
			 Ispell when it is compiled (in this case,
			 /dev/env/DJDIR/lib/englishx.hash), but you
			 can set this variable which will allow you to
			 name alternate dictionaries relative to the
			 directory named by it, avoiding a long
			 pathname.

	ISPELL_HOME    - replaces HOME on Unix systems.  This is where
			 Ispell looks for a personal dictionary if it
			 is given as a relative pathname.

	ISPELL_COLORS -  the colors which will be used by Ispell for
			 the normal and "standout" text.  By default,
			 these are the normal and inverse video
			 colors, but you may set them to any colors
			 you like.  The color descriptor is a pair of
			 numbers separated by a dot; the first number
			 is the color text attribute which will be set
			 for the normal text, and the second is the
			 attribute for the "standout" text (the
			 misspelled words).  The text color attributes
			 are the usual PC background/foreground
			 definitions.  My favorite setting is this:

			    set ISPELL_COLORS=0x1e.0x74

			 which sets the normal colors to yellow on
			 blue and the "standout" colors to red on
			 white.  The color descriptor is parsed by a
			 call to `strtoul' library function, so you
			 can use octal and hex numbers as well as
			 decimal ones.

	LINES	      -  the size of the screen to be used by Ispell.
			 Although this is not a DOS-specific variable,
			 it does have a DOS-specific effect on the
			 DJGPP port of Ispell: if the value of this
			 variable is different from the current screen
			 size, Ispell will set the screen size to the
			 size given by LINES (and restore the original
			 size when it exits or shells out to DOS).
			 The following sizes are supported by the
			 DJGPP port on a standard VGA display: 25, 28,
			 35, 40, 43 and 50 lines.  If you want to run
			 Ispell in some other non-standard screen
			 size, set the display to that size before
			 running Ispell and set LINES to that size.




Dictionaries
============

The pre-compiled binaries come with a medium-plus version of the
American dictionary (lib/englishx.hash) and a medium version of the
British dictionary.  If you need other dictionaries, you will need to
download the Ispell source distribution (ispNNNNs.zip from the same
place you got the binaries) and build them yourself.  American and
British dictionaries come with the source distribution, so just
editing pc/local.djgpp and rebuilding will do.  For other languages,
consult the file "languages/Where", which lists everything the Ispell
maintainer knows about.  You can also check the ispell home page:

	http://fmg-www.cs.ucla.edu/geoff/ispell-dictionaries.html

which contains pointers to all known dictionaries.


Enjoy,
                                   Eli Zaretskii <eliz@is.elta.co.il>
