Research V7 development
[unix-history] / usr / man / man1 / spell.1
CommitLineData
36e4380f
SJ
1.TH SPELL 1
2.SH NAME
3spell, spellin, spellout \- find spelling errors
4.SH SYNOPSIS
5.B spell
6[ option ] ...
7[ file ] ...
8.PP
9.B /usr/src/cmd/spell/spellin
10[ list ]
11.PP
12.B /usr/src/cmd/spell/spellout
13[
14.B \-d
15] list
16.SH DESCRIPTION
17.I Spell
18collects words from the named documents,
19and looks them up in a spelling list.
20Words that neither occur among nor are derivable
21(by applying certain inflections,
22prefixes or suffixes) from words in the spelling list
23are printed on the standard output.
24If no files are named,
25words are collected from the standard input.
26.PP
27.I Spell
28ignores most
29.I troff,
30.I tbl
31and
32.IR eqn (1)
33constructions.
34.PP
35Under the
36.B \-v
37option, all words not literally in the spelling list are printed,
38and plausible derivations from spelling list words are indicated.
39.PP
40Under the
41.B \-b
42option, British spelling is checked.
43Besides preferring
44.ft I
45centre, colour, speciality, travelled,
46.ft R
47etc.,
48this option insists upon
49.I -ise
50in words like
51.I standardise,
52Fowler and the OED to the contrary
53notwithstanding.
54.PP
55Under the
56.B \-x
57option, every plausible stem is printed with `=' for each word.
58.PP
59The spelling list is based on many sources,
60and while more haphazard than an ordinary
61dictionary, is also more effective in respect to
62proper names and popular technical words.
63Coverage of
64the specialized vocabularies of biology,
65medicine and chemistry is light.
66.PP
67Pertinent auxiliary files may be specified by
68name arguments, indicated below with their
69default settings.
70Copies of all output
71are accumulated in the history file.
72The stop list filters out misspellings (e.g. thier=thy\-y+ier)
73that would otherwise pass.
74.PP
75Two routines help maintain the hash lists used by
76.I spell.
77Both expect a list of words, one per line,
78from the standard input.
79.I Spellin
80adds the words on the standard input to the
81preexisting
82.I list
83and places a new list on the standard output.
84If no
85.I list
86is specified, the new list is created from scratch.
87.I Spellout
88looks up each word in the standard input and prints
89on the standard output
90those that are missing from (or present on, with
91option
92.BR \-d )
93the hash list.
94.SH FILES
95D=/usr/dict/hlist[ab]: hashed spelling lists, American & British
96.br
97S=/usr/dict/hstop: hashed stop list
98.br
99H=/usr/dict/spellhist: history file
100.br
101/usr/lib/spell
102.br
103deroff(1), sort(1), tee(1), sed(1)
104.SH BUGS
105The spelling list's coverage is uneven;
106new installations will probably wish to
107monitor the output for several months to gather
108local additions.
109.br
110British spelling was done by an American.