hunspell(1)
NAME
hunspell - spell checker, stemmer and morphological analyzer
SYNOPSIS
hunspell [-1aDGHhLlmnOrstvwX] [--check-url] [--check-apostrophe] [-d dict[,dict2,...]] [--help] [-i enc] [-p dict] [-vv] [--version] [text/OpenDocument/TeX/LaTeX/HTML/SGML/XML/nroff/troff file(s)]
DESCRIPTION
Hunspell is fashioned after the Ispell program. The most common usage
is "hunspell" or "hunspell filename". Without filename parameter,
hunspell checks the standard input. Typing "cat" and "exsample" in two
input lines, results an asterisk (it means "cat" is a correct word) and
a line with corrections:
$ hunspell -d en_US
Hunspell 1.2.3
*
& exsample 4 0: example, examples, ex sample, ex-sample
Correct words signed with an '*', '+' or '-', unrecognized words signed
with '#' or '&' in output lines (see later). (Close the standard input
with Ctrl-d on Unix/Linux and Ctrl-Z Enter or Ctrl-C on Windows.)
With filename parameters, hunspell will display each word of the files
which does not appear in the dictionary at the top of the screen and
allow you to change it. If there are "near misses" in the dictionary,
then they are also displayed on following lines. Finally, the line
containing the word and the previous line are printed at the bottom of
the screen. If your terminal can display in reverse video, the word
itself is highlighted. You have the option of replacing the word
completely, or choosing one of the suggested words. Commands are single
characters as follows (case is ignored):
R Replace the misspelled word completely.
Space Accept the word this time only.
A Accept the word for the rest of this hunspell session.
I Accept the word, capitalized as it is in the file, and
update private dictionary.
U Accept the word, and add an uncapitalized (actually, all
lower-case) version to the private dictionary.
S Ask a stem and a model word and store them in the private
dictionary. The stem will be accepted also with the
affixes of the model word.
0-n Replace with one of the suggested words.
X Write the rest of this file, ignoring misspellings, and
start next file.
Q Exit immediately and leave the file unchanged.
^Z Suspend hunspell.
? Give help screen.
OPTIONS
-1 Check only first field in lines (delimiter = tabulator).
-a The -a option is intended to be used from other programs through
a pipe. In this mode, hunspell prints a one-line version
identification message, and then begins reading lines of input.
For each input line, a single line is written to the standard
output for each word checked for spelling on the line. If the
word was found in the main dictionary, or your personal
dictionary, then the line contains only a '*'. If the word was
found through affix removal, then the line contains a '+', a
space, and the root word. If the word was found through
compound formation (concatenation of two words, then the line
contains only a '-'.
If the word is not in the dictionary, but there are near misses,
then the line contains an '&', a space, the misspelled word, a
space, the number of near misses, the number of characters
between the beginning of the line and the beginning of the
misspelled word, a colon, another space, and a list of the near
misses separated by commas and spaces.
Also, each near miss or guess is capitalized the same as the
input word unless such capitalization is illegal; in the latter
case each near miss is capitalized correctly according to the
dictionary.
Finally, if the word does not appear in the dictionary, and
there are no near misses, then the line contains a '#', a space,
the misspelled word, a space, and the character offset from the
beginning of the line. Each sentence of text input is
terminated with an additional blank line, indicating that
hunspell has completed processing the input line.
These output lines can be summarized as follows:
OK: *
Root: + <root>
Compound:
-
Miss: & <original> <count> <offset>: <miss>, <miss>, ...
None: # <original> <offset>
For example, a dummy dictionary containing the words "fray",
"Frey", "fry", and "refried" might produce the following
response to the command "echo 'frqy refries | hunspell -a":
(#) Hunspell 0.4.1 (beta), 2005-05-26
& frqy 3 0: fray, Frey, fry
& refries 1 5: refried
This mode is also suitable for interactive use when you want to
figure out the spelling of a single word (but this is the
default behavior of hunspell without -a, too).
When in the -a mode, hunspell will also accept lines of single
words prefixed with any of '*', '&', '@', '+', '-', '~', '#',
'!', '%', '`', or '^'. A line starting with '*' tells hunspell
to insert the word into the user's dictionary (similar to the I
command). A line starting with '&' tells hunspell to insert an
all-lowercase version of the word into the user's dictionary
(similar to the U command). A line starting with '@' causes
hunspell to accept this word in the future (similar to the A
command). A line starting with '+', followed immediately by tex
or nroff will cause hunspell to parse future input according the
syntax of that formatter. A line consisting solely of a '+'
will place hunspell in TeX/LaTeX mode (similar to the -t option)
and '-' returns hunspell to nroff/troff mode (but these commands
are obsolete). However, the string character type is not
changed; the '~' command must be used to do this. A line
starting with '~' causes hunspell to set internal parameters (in
particular, the default string character type) based on the
filename given in the rest of the line. (A file suffix is
sufficient, but the period must be included. Instead of a file
name or suffix, a unique name, as listed in the language affix
file, may be specified.) However, the formatter parsing is not
changed; the '+' command must be used to change the formatter.
A line prefixed with '#' will cause the personal dictionary to
be saved. A line prefixed with '!' will turn on terse mode (see
below), and a line prefixed with '%' will return hunspell to
normal (non-terse) mode. A line prefixed with '`' will turn on
verbose-correction mode (see below); this mode can only be
disabled by turning on terse mode with '%'.
Any input following the prefix characters '+', '-', '#', '!',
'%', or '`' is ignored, as is any input following the filename
on a '~' line. To allow spell-checking of lines beginning with
these characters, a line starting with '^' has that character
removed before it is passed to the spell-checking code. It is
recommended that programmatic interfaces prefix every data line
with an uparrow to protect themselves against future changes in
hunspell.
To summarize these:
* Add to personal dictionary
@ Accept word, but leave out of dictionary
# Save current personal dictionary
~ Set parameters based on filename
+ Enter TeX mode
- Exit TeX mode
! Enter terse mode
% Exit terse mode
` Enter verbose-correction mode
^ Spell-check rest of line
In terse mode, hunspell will not print lines beginning with '*',
'+', or '-', all of which indicate correct words. This
significantly improves running speed when the driving program is
going to ignore correct words anyway.
In verbose-correction mode, hunspell includes the original word
immediately after the indicator character in output lines
beginning with '*', '+', and '-', which simplifies interaction
for some programs.
--check-apostrophe
Check and force Unicode apostrophes (U+2019), if one of the
ASCII or Unicode apostrophes is specified by the spelling
dictionary, as a word character (see WORDCHARS, ICONV and OCONV
in hunspell(5)).
--check-url
Check URLs, e-mail addresses and directory paths.
-D Show detected path of the loaded dictionary, and list of the
search path and the available dictionaries.
-d dict,dict2,...
Set dictionaries by their base names with or without paths.
Example of the syntax:
-d en_US,en_geo,en_med,de_DE,de_med
en_US and de_DE are base dictionaries, they consist of aff and dic file
pairs: en_US.aff, en_US.dic and de_DE.aff, de_DE.dic. En_geo, en_med,
de_med are special dictionaries: dictionaries without affix file.
Special dictionaries are optional extension of the base dictionaries
usually with special (medical, law etc.) terms. There is no naming
convention for special dictionaries, only the ".dic" extension:
dictionaries without affix file will be an extension of the preceding
base dictionary (right order of the parameter list needs for good
suggestions). First item of -d parameter list must be a base
dictionary.
-G Print only correct words or lines.
-H The input file is in SGML/HTML format.
-h, --help
Short help.
-i enc Set input encoding.
-L Print lines with misspelled words.
-l The "list" option is used to produce a list of misspelled words
from the standard input.
-m Analyze the words of the input text (see also hunspell(5) about
morphological analysis). Without dictionary morphological data,
signs the flags of the affixes of the word forms for dictionary
developers.
-n The input file is in nroff/troff format.
-O The input file is in OpenDocument (ODF or Flat ODF) format. If
unzip program is not installed, install it before using this
option.
-P password
Set password for encrypted dictionaries.
-p dict
Set path of personal dictionary. The default dictionary depends
on the locale settings. The following environment variables are
searched: LC_ALL, LC_MESSAGES, and LANG. If none are set then
the default personal dictionary is $HOME/.hunspell_default.
Setting -d or the DICTIONARY environmental variable, personal
dictionary will be $HOME/.hunspell_dicname
-r Warn of the rare words, wich are also potential spelling
mistakes.
-s Stem the words of the input text (see also hunspell(5) about
stemming). It depends from the dictionary data.
-t The input file is in TeX or LaTeX format.
-v, --version
Print version number.
-vv Print ispell(1) compatible version number.
-w Print misspelled words (= lines) from one word/line input.
-X The input file is in XML format.
EXAMPLES
hunspell example.html
Interactive spell checking of an HTML file with the default
dictionary.
hunspell -d en_US example.html
Interactive spell checking of an HTML file with the en_US
dictionary.
hunspell -d en_US,en_US_med medical.txt
Interactive spell checking with multiple dictionaries.
hunspell *.odt
Interactive spell checking of ODF documents.
hunspell -l *.odt
List bad words of ODF documents
hunspell -l *.odt | sort | uniq >unrecognized
Saving unrecognized words of ODF documents (filtering
duplications).
hunspell -p unrecognized_but_good *.odt
Interactive spell checking of ODF documents, using the
previously saved and reduced word list, as a personal
dictionary, to speed up spell checking.
ENVIRONMENT
DICTIONARY
Similar to -d.
DICPATH
Dictionary path.
WORDLIST
Equivalent to -p.
FILES
The default dictionary depends on the locale settings. The following environment variables are searched: LC_ALL, LC_MESSAGES, and LANG. If none are set then the following fallbacks are used: /usr/share/myspell/default.aff Path of default affix file. See hunspell(5). /usr/share/myspell/default.dic Path of default dictionary file. See hunspell(5). $HOME/.hunspell_default. Default path to personal dictionary.
SEE ALSO
hunspell (3), hunspell(5)
AUTHOR
Author of Hunspell executable is Lszl Nmeth. For Hunspell library, see hunspell(3). This manual based on Ispell's manual. See ispell(1). 2014-05-27 hunspell(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
