1
# -*- readme-debian -*-
3
Using aspell with ispell.el
4
---------------------------
6
Ispell.el assumes you use ispell, if you use aspell write
8
(setq ispell-program-name "aspell")
10
in your {x}emacs configuration file.
12
ispell.el loading at startup
13
----------------------------
15
Emacs comes dumped with an ispell-menu-map containing a set of
16
dictionaries that won't be what's actually present. To make it match the
17
actually installed dictionaries some magic is done in the
19
/etc/emacs/site-start.d/50dictionaries-common.el
21
file, but that will force loading of ispell.el even if you do not intend
22
to use it at all. If you do not like that behavior, (lisp) comment the
25
(setq ispell-menu-xemacs nil)
26
(ispell-change-dictionary nil)
28
in that file. Since that is a conffile your changes will be preserved if
29
you choose that at package upgrade.
31
Adding customized entries for emacs
32
-----------------------------------
34
You can currently do this in two ways in your {x}emacs configuration file,
36
The classical one, e.g.,
38
(setq ispell-dictionary-alist
39
(append ispell-dictionary-alist
40
'(("british+accs" ; British version
41
"[A-Z\321\324a-z\361\364]"
42
"[^A-Z\321\324a-z\361\364]"
45
("-B" "-d" "british-w_accents")
49
where some dummy accented characters have been added. You will lose this
50
entry if ispell.el is reloaded.
52
You can also use the debian-ispell.el provided function
53
'debian-ispell-add-dictionary-entry'
55
; --------------------
56
(if (fboundp 'debian-ispell-add-dictionary-entry)
58
(debian-ispell-add-dictionary-entry ... )
59
(debian-ispell-add-dictionary-entry ... )
62
(setq ispell-dictionary-alist debian-ispell-dictionary-alist)
63
; --------------------
65
where each of the calls to 'debian-ispell-add-dictionary-entry' is
68
; --------------------
69
(debian-ispell-add-dictionary-entry
71
"[A-Z\321\324a-z\361\364]"
72
"[^A-Z\321\324a-z\361\364]"
75
("-B" "-d" "british-w_accents")
79
; --------------------
81
Remember to reset ispell-dictionary-list after this, as shown above. Also
82
better use as above the octal codes for the accented characters rather
83
than the character itself. This will save you some problems with editors
84
and with emacs itself.
86
The trailing "aspell" is currently not used, but is intended to mean
87
that the dict is available for aspell only. In the future it is possible
88
that, for systems where both ispell and aspell are installed, can be
89
implemented an automatic selection of the spellchecker program based on
90
the value of 'ispell-program-name' and dict availability for that entry
91
and spellchecker. But this is currently just smoke.
93
Using ispell-local-dictionary-alist does not currently work, but it
96
----------------------------------
97
-- Agustin Martin Domingo <agmartin@debian.org>, Fri Apr 8 12:23:01 2005
99
LocalWords: debian debconf usr alioth org wordlists wordlist debhelper http
100
LocalWords: iamerican wspanish miscfiles xemacs wbritish var html dpkg