spell, spellin, spellout(1,C) spell, spellin, spellout(1,C) ------------------------------------------------------------------------------- spell, spellin, spellout PURPOSE Finds spelling errors. SYNTAX +-----------+ +------------+ +------------+ spell ---| +-------+ |---| |---| |---> +-| -b -v |-+ +- -d hlist -+ +- -s hstop -+ ^| -i -x || || -l || |+-------+| +---------+ +----------------+ +-------------+ +--------+ >---| |---| |---| |---| +- -h spellhist -+ +- +wordlist -+ ^ +- file -+ | +------------+ +------------------+ spellin ---| +--------------+ |---| +-| spellinglist |-+ ^| num || |+--------------+| +----------------+ +------+ spellout ---| |--- list ---| +- -d -+ Note: This command does not have MBCS support. DESCRIPTION The spell command reads words in file and compares them to those in a spelling list. Words that cannot be matched in the spelling list or derived from words in the spelling list (by applying certain inflections, prefixes, and/or suffixes) are written to standard output. If you do not specify a file to read, spell reads standard input. The spell command ignores the same troff, tbl, and eqn constructs as the deroff command. The coverage of the spelling list is uneven. You should create your own dictionary of special words used in your files. Processed Dec. 9, 1991 spell, spellin, spellout(1,C) 1 spell, spellin, spellout(1,C) spell, spellin, spellout(1,C) Certain auxiliary files can be specified by file name parameters; see "Files" Copies of all output are accumulated in the history file. The spellin command combines the words from the standard input and the prexisting list file and places a new list on the standard output. If no list file is specified, the new list is created from scratch. The spellout command looks up each word from the standard input and prints on the standard output those that are missing from the hashed list file. Option -d reverses this, printing those that are present in the hashed list file. Note: The hash tables created by spellin are binary files and are machine-dependant. If you are running spell in a heterogeneous TCF cluster, you must run spell and spellout on the same type of machine on which you ran spellin. Three routines help maintain and check the hash lists used by spell. /usr/lib/spell/hashmake Reads a list of words from standard input and writes the corresponding nine-digit hash code to standard output. /usr/lib/spell/spellin num Reads num hash codes from standard input and writes a compressed spelling list to standard output. /usr/lib/spell/hashcheck spellinglist Reads a compressed spellinglist and recreates the nine-digit hash codes for all the words in it; it writes these codes to standard output. FLAGS -b Checks British spelling. -d hlist Specify filename hlist as the alternate spelling list. The default is /usr/lib/spell/hlist [ab]. -hspellhist Specify filename spellhist as the alternate history list which is used to accumlate all output. The default is /usr/lib/spell/spellhist. -i Suppresses processing of include files. -l Follows the chain of all included files (.so and .nx formatting commands). Without this flag, spell follows chains of all included files except for those beginning with /usr/lib. Processed Dec. 9, 1991 spell, spellin, spellout(1,C) 2 spell, spellin, spellout(1,C) spell, spellin, spellout(1,C) -s hstop Specify filename hstop as the alternate stop list which is used to filter out misspellings (for example thy-y+ier) that would otherwise pass. The default is /usr/lib/spell/hstop. -v Displays all words not literally in the spelling list and indicates plausible derivations from the words. -x Displays every plausible word stem with an = (equal sign). +wordlist Checks wordlist for additional word spellings. wordlist is the name of a file you provide that contains a sorted list of words one per line. With this flag, you can specify a set of correctly spelled words (in addition to spell's own spelling list) for each job. EXAMPLES 1. To check your spelling: spell chap1 > mistakes This creates a file named "mistakes" containing all the words found in "chap1" that are not in the system spelling dictionary. Some of these may be correctly spelled words that spell does not know about. It is a good idea to save the output of spell in a file because the word list may be long. 2. To check British spelling: spell -b chap1 > mistakes This checks "chap1" against the British dictionary and writes the questionable words in "mistakes". 3. To see how spell derives words: spell -v chap1 > deriv This lists the words that are not found literally in the dictionary, but are derived forms of dictionary words. The prefixes and suffixes used to form the derivative are indicated for each word. Words that do not appear in the dictionary at all are also listed. 4. To check your spelling against an additional word list: spell +newwords chap1 and against "newwords". The file "newwords" lists words in sorted order (upper case in alphabetical order, then lower case in alphabetical order), one per line. You can create this file with a text editor, such as ed, and alphabetize it with the sort command. Processed Dec. 9, 1991 spell, spellin, spellout(1,C) 3 spell, spellin, spellout(1,C) spell, spellin, spellout(1,C) 5. To add a word to your spelling list: echo hookey | spellout /usr/dict/hlista echo hookey | spellin /usr/disct/hslista > myhlist spell -d myhlist huckfinn This example verifies that hookey is not on the default spelling list, adds it to the user's private list, and then uses it with spell. An alternative way is to place hookey into the sorted file newwords as in Example 4. FILES D_SPELL=/usr/lib/spell/hlist[ab] Hashed spelling lists, American and British. S_SPELL=/usr/lib/spell/hstop Hashed stop list. H_SPELL=/usr/lib/spell/spellhist History file. /usr/lib/compress Executable shell program to compress the history file. /usr/lib/spell/spellprog Program. RELATED INFORMATION See the following commands: "deroff," "eqn, neqn, checkeq," "sed," "sort," "tbl," "tee," and "troff." Processed Dec. 9, 1991 spell, spellin, spellout(1,C) 4