home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 5 Edit
/
05-Edit.zip
/
isp31b3.zip
/
ispell
/
00readme.os2
next >
Wrap
Lisp/Scheme
|
1995-07-10
|
7KB
|
180 lines
ispell 3.1.18 to os/2 port using emx09 (fix3)
This ispell-port intends to be as similar as possible to the
unix-ispell - Thus you'll need long filename support and all the gnu
unix-utilities. Furthermore, you'll need the emx runtime package
(see the emx-directory).
If you're not used to unix, you might look for Rick-Papos ispell-port which
is more the os2-way. It comes as dll and with an API !!
(rpapo@conch.aa.msen.com)
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
ispell assumes that you have set the environment-variables HOME,TMP and
TERM. If you don't have so, and you don't know how to do so,please wait
for the next beta relaese which will include a description how to do it.
If you intend, to run ispell without emacs, that is from the
commandline, you'll need the file termcap.dat.
For an example how to run ispell from the command-line, see the provided
examples ispellg.cmd (german dictionarys and umlauts) and ispelle.cmd
(english spelling). Ispell won't run with the DataLogic shell!!!
Ok, here we go:
backup your existing ispell installation !!!!!
Set the env-variable DICTDIR like DICTDIR=d:/dicts -- please no
quotes! A T T E N T I O N : This variable has changed since beta2 !!
Ispell will exit with a return-code of 10 if you haven't set DICTDIR !!
mv your dictionarys and personal wordlist into this directory.
If you previously have used ispell3.009, you need to rebuild your
hash-files!
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 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.
If you'r updating from beta2, no changes are needed.
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!
If you're using emacs with code-page 850, you need to modify
ispell-dictionary-alist.
To use code page 850 instead, create a file `myloadup.el' in
\emacs\19.29\lisp:
----------------------------- cut here
; myloadup.el
(setq ispell-dictionary-alist
'((nil ; default (english.aff)
"[A-Za-z]" "[^A-Za-z]" "[']" nil ("-B") nil)
("english" ; make english explicitly
selectable
"[A-Za-z]" "[^A-Za-z]" "[']" nil ("-B") nil)
("deutsch" ; deutsch.aff
"[a-zA-Z\"]" "[^a-zA-Z\"]" "[']" t ("-C") "~tex")
("deutsch8"
"[a-zA-Z\204\224\201\216\231\232\341]"
"[^a-zA-Z\204\224\201\216\231\232\341]"
"[']" t ("-C" "-d" "deutsch") "~pc")
))
(load "loadup")
----------------------------- cut here
and replace `loadup' in \emacs\19.29\bin\dump.cmd with `myloadup'.
Then, re-dump Emacs.
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, cp
the file local.os2 to source/local.h (maybe you want to edit this file at the
very end), copy the makefile to /source/makefile
get the latest data-logic shell (the emx-version won't work!), apply
the the file patch.os2 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.
Please mail bugs not to ispell-bug, instead mail 'em to me!
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.
BUGS:
Lookup Command needs still the compile-time information where to
find the system-dictionary
A shell-escape command without arguments gives a core-dump
TODO:
A DOS-Version
Better readme ;-)
Convert the man-page docs to ascii.txt
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
10.7.95 beta3, ispell can now be used from the command-line. Ispell will
now find it's dictionarys independent from compile-time options.
The environment variable DICTLIB has changed to DICTDIR.