Bug#922780: hunspell.1: Correct some mistakes in the manual
Package: hunspell
Version: 1.7.0-2
Severity: minor
Tags: patch
Dear Maintainer,
the patch is in the attachment as it contains utf-8 characters.
Input file is hunspell.1
Output from "mandoc -T lint ...":
mandoc: hunspell.1:2:2: ERROR: skipping unknown macro: .LO 1
mandoc: hunspell.1:11:70: STYLE: whitespace at end of input line
mandoc: hunspell.1:89:58: STYLE: whitespace at end of input line
mandoc: hunspell.1:235:2: STYLE: fill mode already enabled, skipping: fi
mandoc: hunspell.1:269:13: STYLE: whitespace at end of input line
mandoc: hunspell.1:271:13: STYLE: whitespace at end of input line
mandoc: hunspell.1:274:62: STYLE: whitespace at end of input line
mandoc: hunspell.1:378:2: WARNING: line scope broken: SH breaks TP
mandoc: hunspell.1:382:11: STYLE: whitespace at end of input line
mandoc: hunspell.1:383:9: STYLE: whitespace at end of input line
mandoc: hunspell.1:389:14: STYLE: whitespace at end of input line
#######
From "test-groff" -ww ...:
<hunspell.1>:330 (macro BR): only 1 argument, but more are expected
<hunspell.1>:397 (macro BI): only 1 argument, but more are expected
<hunspell.1>:400 (macro BI): only 1 argument, but more are expected
<hunspell.1>:404 (macro BI): only 1 argument, but more are expected
#####
Reduce space between words.
191:changed; the '+' command must be used to change the formatter.
327:or the
#####
Use the correct macro for the font change of a single argument.
330:.BR $HOME/.hunspell_dicname
397:.BI /usr/share/myspell/default.aff
400:.BI /usr/share/myspell/default.dic
#####
Use the word (in)valid instead of (il)legal if not related to legal matters.
See "www.gnu.org/prep/standards".
105:word unless such capitalization is illegal;
#####
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
18:$ hunspell -d en_US
146:without -a, too).
374:.B hunspell -p unrecognized_but_good *.odt
#####
Wrong distance between sentences or protect the indicator.
a) Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) [package "manpages"] and "info groff".
Or
b) Adjust space between sentences (two spaces),
c) or protect the indicator by adding "\&" after it.
The "indicator" is an "end-of-sentence character" (.!?).
The amount of space in the output can then be controlled with the
".ss" request.
41:suggested words. Commands are single characters as follows
275:without affix file. Special dictionaries are optional extension
277:terms. There is no naming convention for special dictionaries,
280:order of the parameter list needs for good suggestions). First
304:morphological analysis). Without dictionary morphological data,
320:The default dictionary depends on the locale settings. The
322:LC_MESSAGES, and LANG. If none are set then the default personal
337:stemming). It depends from the dictionary data.
392:The default dictionary depends on the locale settings. The
394:LC_MESSAGES, and LANG. If none are set then the following
398:Path of default affix file. See hunspell(5).
412:This manual based on Ispell's manual. See ispell(1).
#####
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks
hunspell.1: line 6 length 211
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)]
hunspell.1: line 32 length 82
will display each word of the files which does not appear in the dictionary at the
#####
Split a punctuation mark from a single argument for a two-fonts marco
404:.BI $HOME/.hunspell_default.
#####
The name of a man page is set in bold and the section in roman (see
man-pages(7).
258:(see WORDCHARS, ICONV and OCONV in hunspell(5)).
303:Analyze the words of the input text (see also hunspell(5) about
336:Stem the words of the input text (see also hunspell(5) about
346:Print ispell(1) compatible version number.
398:Path of default affix file. See hunspell(5).
402:See hunspell(5).
407:.B hunspell (3), hunspell(5)
410:see hunspell(3).
412:This manual based on Ispell's manual. See ispell(1).
#####
-- System Information:
Debian Release: buster/sid
APT prefers testing
APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.144-1 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages hunspell depends on:
ii hunspell-de-de [hunspell-dictionary] 20161207-7
ii hunspell-en-us [hunspell-dictionary] 1:2018.04.16-1
ii hunspell-is [hunspell-dictionary] 1:6.2.0~rc2-1
ii libc6 2.28-7
ii libgcc1 1:8.2.0-20
ii libhunspell-1.7-0 1.7.0-2
ii libncursesw6 6.1+20181013-1
ii libreadline7 7.0-5
ii libstdc++6 8.2.0-20
ii libtinfo6 6.1+20181013-1
hunspell recommends no packages.
Versions of packages hunspell suggests:
ii unzip 6.0-22
-- no debconf information
--
Bjarni I. Gislason
--- hunspell.1 2018-11-28 20:05:37.000000000 +0000
+++ hunspell.1.new 2019-02-19 18:10:40.000000000 +0000
@@ -1,21 +1,25 @@
.TH hunspell 1 "2014-05-27"
-.LO 1
+.\".LO 1 \" Unknown macro
.SH NAME
hunspell \- spell checker, stemmer and morphological analyzer
.SH 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)]
+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)]
+
.SH DESCRIPTION
.I Hunspell
is fashioned after the
.I Ispell
-program. The most common usage is "hunspell" or "hunspell filename".
+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:
.PP
.RS
.nf
-$ hunspell -d en_US
+$ hunspell \-d en_US
Hunspell 1.2.3
*
& exsample 4 0: example, examples, ex sample, ex-sample
@@ -29,7 +33,8 @@ Ctrl-Z Enter or Ctrl-C on Windows.)
.PP
With filename parameters,
.I hunspell
-will display each word of the files which does not appear in the dictionary at the
+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.
@@ -38,7 +43,7 @@ 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
+suggested words. Commands are single characters as follows
(case is ignored):
.PP
.RS
@@ -86,7 +91,7 @@ a single line is written to the standard
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.
+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 '\-'.
.IP ""
@@ -102,7 +107,7 @@ misses separated by
commas and spaces.
.IP ""
Also, each near miss or guess is capitalized the same as the input
-word unless such capitalization is illegal;
+word unless such capitalization is invalid;
in the latter case each near miss is capitalized correctly
according to the dictionary.
.IP ""
@@ -143,7 +148,7 @@ command "echo 'frqy refries | hunspell \
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).
+without \-a, too).
.IP ""
When in the
.B \-a
@@ -188,7 +193,7 @@ Instead of a file name or suffix, a uniq
affix file, may be specified.)
However, the formatter parsing is
.I not
-changed; the '+' command must be used to change the formatter.
+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
@@ -232,7 +237,6 @@ Exit terse mode
Enter verbose-correction mode
.IP ^
Spell-check rest of line
-.fi
.RE
.IP ""
In
@@ -255,7 +259,8 @@ interaction for some programs.
.IP \fB\-\-check\-apostrophe\fR
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)).
+(see WORDCHARS, ICONV and OCONV in
+.BR hunspell (5)).
.IP \fB\-\-check\-url\fR
Check URLs, e-mail addresses and directory paths.
@@ -266,19 +271,19 @@ search path and the available dictionari
.IP \fB\-d\ dict,dict2,...\fR
Set dictionaries by their base names with or without paths.
Example of the syntax:
-.PP
+.PP
\-d en_US,en_geo,en_med,de_DE,de_med
-.PP
+.PP
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,
+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.
+order of the parameter list needs for good suggestions).
+First item of \-d parameter list must be a base dictionary.
.IP \fB\-G\fR
Print only correct words or lines.
@@ -300,8 +305,9 @@ The "list" option
is used to produce a list of misspelled words from the standard input.
.IP \fB\-m\fR
-Analyze the words of the input text (see also hunspell(5) about
-morphological analysis). Without dictionary morphological data,
+Analyze the words of the input text (see also
+.BR hunspell (5)
+about morphological analysis). Without dictionary morphological data,
signs the flags of the affixes of the word forms for dictionary
developers.
@@ -317,24 +323,26 @@ Set password for encrypted dictionaries.
.IP \fB\-p\ dict\fR
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
+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
.I \-d
-or the
+or the
.I DICTIONARY
environmental variable, personal dictionary will be
-.BR $HOME/.hunspell_dicname
+.B $HOME/.hunspell_dicname
.IP \fB\-r\fR
Warn of the rare words, which are also potential spelling mistakes.
.IP \fB\-s\fR
-Stem the words of the input text (see also hunspell(5) about
-stemming). It depends from the dictionary data.
+Stem the words of the input text (see also
+.BR hunspell (5)
+about stemming).
+It depends from the dictionary data.
.IP \fB\-t\fR
The input file is in TeX or LaTeX format.
@@ -343,7 +351,9 @@ The input file is in TeX or LaTeX format
Print version number.
.IP \fB\-vv\fR
-Print ispell(1) compatible version number.
+Print
+.BR ispell (1)
+compatible version number.
.IP \fB\-w\fR
Print misspelled words (= lines) from one word/line input.
@@ -371,42 +381,46 @@ List bad words of ODF documents
.B hunspell \-l *.odt | sort | uniq >unrecognized
Saving unrecognized words of ODF documents (filtering duplications).
.TP
-.B hunspell -p unrecognized_but_good *.odt
+.B 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.
-.TP
.SH ENVIRONMENT
.TP
.B DICTIONARY
-Similar to
-.I \-d.
+Similar to
+.I \-d.
.TP
.B DICPATH
Dictionary path.
.TP
.B WORDLIST
-Equivalent to
+Equivalent to
.I \-p.
.SH 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
+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:
-.BI /usr/share/myspell/default.aff
-Path of default affix file. See hunspell(5).
+.B /usr/share/myspell/default.aff
+Path of default affix file. See
+.BR hunspell (5).
.PP
-.BI /usr/share/myspell/default.dic
+.B /usr/share/myspell/default.dic
Path of default dictionary file.
-See hunspell(5).
+See
+.BR hunspell (5).
.PP
-.BI $HOME/.hunspell_default.
+.BR $HOME/.hunspell_default .
Default path to personal dictionary.
.SH SEE ALSO
-.B hunspell (3), hunspell(5)
+.BR hunspell "(3), " hunspell (5)
.SH AUTHOR
-Author of Hunspell executable is László Németh. For Hunspell library,
-see hunspell(3).
+Author of Hunspell executable is László Németh. For Hunspell library,
+see
+.BR hunspell (3).
.PP
-This manual based on Ispell's manual. See ispell(1).
+This manual based on Ispell's manual.
+See
+.BR ispell (1).
Reply to: