ispell 3.1.18 to os/2 port  using emx09 (fix3)

You will need the emx runtime libraries and this port will not run
on DOS and I don't know if on it runs on FAT drives, sorry.

This ispell comes with German/English dictionarys. Before deleting one
of those sub-dirs, check your existing affix-files (see below) !!!  If you
don't intend to recompile ispell yourself, you may also delete the
sources-dir.
Please read the the file README and the additional docs within the
subdirs.

The docs are provided in man-page and texinfo format.


INSTALLATION 

backup your existing ispell installation, then mv all files into
\usr\ispell (this is a must! - sorry, If you don't like ist you have
to recompile it).
 
Set the env-variable DICTLIB like DICTLIB=d:/dicts -- please no
quotes!  mv your personal-dicts into this dir.  rebuild your
hash-tables. The affix-files from 3.009 are no longer valid please use
the affix-files for 3.1. E.g.:

    buildhash your-dictfile new-aff-file hash-file

The resulting hash-files may need to have the extension xxxx.hash
in order to run with this ispell-version --> edit your emacs-ispell-
section in .emacs or site-start.el accordingly.

Add in your .emacs or site-start.el file the following line to your
existing ispell-init-code:

(defvar ispell-personal-dictionary "d:/usr/ispell/pers.dict") 

This should be your default personal-dict (e.g. english) __not__ the
one which is called by some language-hook. Language specific dicts
should instead be set by buffer-local variables. As for example:

(TeX-add-style-hook "german"
 (function (lambda ()
   (setq ispell-local-pdict "d:/usr/ispell/german.wrd")
   (ispell-change-dictionary "german")
   (run-hooks 'TeX-language-de-hook))))

This can be done conveniently by the language specific hooks of
auctex, or manually at the end of the buffer (see ispell.el for
details).
Specifying the local-dict by ispell-dictionary-alist will not work!

backup your existing ispell.el delete ispell.elc and replace it with 
the new ispell.el (byte compile it!)

If your personal.dict contains character-codes > 127 ispell will complain.
Just retry and they will be converted automatically. Other than this, ispell
works fine with german umlauts. 

From time to time it might be handy to simplify your personal
dictionary (especially with all these german-compound words). This can
be accomplished with the munchlist script. You will need the bash
shell, some cmd-files & REXX support (they are in the munchlist
directory) and the gnu file & text utilities.

Install the cmd-file somewhere in your path, create a directory with
the name /usr/tmp and try within your ispell-dir

	munchlist.sh -l affix-file personal-dict > munched-dict

Depending on the size of your file this step may take several hours.
/usr/tmp/ should have a lot of empty space (at least 10 times the size
of your personal-dict). Right now there are two different bash-shell
ports around. If you have any troubles, try the other one.

If you need to recompile it yourself, go into the sources-dir, move
the file local.os2 to local.h (maybe you want to edit this file at the
very end), replace in every makefile the shell statement with sh.exe,
get the latest data-logic shell (the emx-version won't work!), apply
the the file patch.os2 to ispell.c and type make programs. The process
will fail if you try to build the dicts.  This is due to my lack of
understanding shell-scripts and due to apparent limitations of the
existing sh, ksh and bash ports for os2.

Building the munchlist script:

	make munchlist

mv munchlist munchlist.sh. Exchange all /bin/rm statements with rm and
edit the first line to use bash.exe instead of sh.exe.

Have fun

Uli

	uli@homer.geol.tu-muenchen.de


PROBLEMS:

The variable ispell-local-pdict (like "d:/usr/ispell/german.wrd") is
not reset when one changes into a buffer written in the default language.

Setting  ispell-local-pdict in a non-default-language buffer does not
update ispell-pdict-keyword, this has to be done explicitly by
ispell-change-dictionary.


HISTORY:

19.5.95 alpha release

23.5.95 added sources, german and english dicts, recompiled with -O3 and using 
	8Bit, added a modified munchlist and the needed cmd-files.

32.5.95 beta2, added support for systems with multiple partitions,
	needs now the env-var DICTLIB

