NAME
tmispell.conf - configuration file for tmispell
DESCRIPTION
This manual page describes the configuration file for tmispell(1).
FILES
/etc/tmispell.conf
The configuration file that contains spell-checker entries and
options.
Syntax of configuration file
option=value
The value string, if enclosed between quotes, may span multiple
lines; “#” is a comment character and everything on a line after
it is ignored.
Options
ispell The location of the Ispell executable to be called as a
fall-back. The full path to the Ispell executable must be
given. This option is mandatory.
tex-command-filter
A list of TeX commands and their parameter lists to use
when filtering TeX input. The syntax is
"cmdname oOpP, ...", where oOpP is a string of characters
denoting the type of command’s parameters. Uppercase
letter means that a parameter should be spell-checked,
lowercase that it should not. O and o denote optional
parameters, P and p normal parameters.
tex-environment-filter
A list of environments to skip when filtering TeX input.
sgml-attributes-to-check
A list of SGML or HTML tag attributes to spell-check.
The spell-checker module specification consists of seven strings
on the same line, separated by whitespace(s) (i.e. space or tab)
and possibly enclosed in double (") or single (') quotes.
Backslash (\) can be used to escape quote characters inside
quotes. The meanings of the strings are:
1. The name by which the dictionary is known, similar to the
name of an Ispell hash file name without the extension
.hash. This is mandatory.
2. This option is not used in current version of Tmispell.
3. This option is not used in current version of Tmispell.
4. The input encoding this module uses (e.g. UTF-8). This is
mandatory.
5. The value of the locale variable LC_CTYPE that should be
used with this module. This determines the default set of
characters that are considered to belong to a word. If
empty or not given, the value of a suitable environment
variable is used.
6. The set of additional word characters not specified by
the locale. If not given, no additional word characters
are assumed.
7. The set of word boundary characters. They are considered
to be a part of a word only when occurring inside one. If
not given, no boundary characters are assumed.
EXAMPLES
Example configuration file
ispell=/usr/bin/ispell.real
suomi "/dev/null" "/dev/null" "UTF-8" "fi_FI.UTF-8" ".-" "':"
tex-command-filter="begin po, end p, usepackage op, newcommand
poOP"
tex-environment-filter="equation $ eqnarray displaymath math"
The first line specifies the location of the fall-back ispell program
to use.
The second line defines spell-checking settings for Finnish language.
Language is identified by the name “suomi”. Following two options are
not used in the current version of Tmispell. The input encoding to use
is UTF-8. Only the letters specified by the locale fi_FI.UTF-8 as well
as period (.) and dash (-) are considered word characters. Boundary
characters are ASCII apostrophe (') and colon (:).
Every time Tmispell is invoked with “-d suomi” or “-d
/usr/lib/ispell/suomi.hash” as arguments, the Voikko spell-checking
system is used for spell-checking. Otherwise the real Ispell is
started.
The third line specifies that in TeX filter mode the parameters to
commands begin{}, end{} and usepackage{} should not be spell-checked,
whereas the second optional and second obligatory parameters to
“newcommand” should.
The fourth line specifies that in TeX filter mode no math environment
should be spell-checked.
AUTHORS
The original Tmispell was programmed by Pauli Virtanen
<pauli.virtanen@hut.fi>.
Modifications and integration with Voikko spell-checking system by Har‐
ri Pitkänen <hatapitk@iki.fi>.
SEE ALSO
tmispell(1), ispell(1)
Voikko homepage: http://voikko.sourceforge.net/
2006-07-30