spell(1)                                                 spell(1)



     NAME
          spell, hashmake, spellin, hashcheck - find spelling errors

     SYNOPSIS
          spell [-v] [-b] [-x] [-l] [-i] +local_file [files]

          /usr/lib/spell/hashmake

          /usr/lib/spell/spellin n

          /usr/lib/spell/hashcheck spelling_list

     DESCRIPTION
          spell collects words from the named files and looks them up
          in a spelling list.  Words that neither occur among nor are
          derivable (by applying certain inflections, prefixes, and/or
          suffixes) from words in the spelling list are printed on the
          standard output.  If no files are named, words are collected
          from the standard input.

          spell ignores most troff(1), tbl(1), and eqn(1)
          constructions.

          Under the -v flag option, all words not literally in the
          spelling list are printed, and plausible derivations from
          the words in the spelling list are indicated.

          Under the -b flag option, British spelling is checked.
          Besides preferring centre, colour, programme, speciality,
          travelled, etc., this flag option insists upon -ise in words
          like standardise, Fowler and the OED to the contrary
          notwithstanding.

          Under the -x flag option, every plausible stem is printed
          with = for each word.

          By default, spell (like deroff(1)) follows chains of
          included files (.so and .nx troff(1) requests), unless the
          names of such included files begin with /usr/lib.  Under the
          -l flag option, spell will follow the chains of all included
          files.  Under the -i flag option, spell will ignore all
          chains of included files.

          Under the +local_file flag option, words found in local_file
          are removed from spell's output.  local_file is the name of
          a user-provided file that contains a sorted list of words,
          one per line.  With this option, the user can specify a set
          of words that are correct spellings (in addition to spell's
          own spelling list) for each job.

          The spelling list is based on many sources, and while more
          haphazard than an ordinary dictionary, is also more



     Page 1                                        (last mod. 1/16/87)

     spell(1)                                                 spell(1)



          effective with respect to proper names and popular technical
          words.  Coverage of the specialized vocabularies of biology,
          medicine, and chemistry is light.

          Pertinent auxiliary files may be specified by name
          arguments, indicated below with their default settings (see
          FILES).  Copies of all output are accumulated in the history
          file.  The stop list filters out misspellings (e.g.,
          thier=thy-y+ier) that would otherwise pass.

          Three routines help maintain and check the hash lists used
          by spell:

          hashmake    Reads a list of words from the standard input
                      and writes the corresponding nine-digit hash
                      code on the standard output.

          spellin n   Reads n hash codes from the standard input and
                      writes a compressed spelling list on the
                      standard output.  Information about the hash
                      coding is printed on standard error.

          hashcheck   Reads a compressed spelling_list and recreates
                      the nine-digit hash codes for all the words in
                      it; it writes these codes on the standard
                      output.

     EXAMPLE
               spell filea fileb filec > mistakes

          would put a list of the words from filea, fileb,
          andfilecthat were not part of the on-line dictionary into
          file mistakes.

          The following example creates the hashed spell list hlist
          and checks the result by comparing the two temporary files;
          they should be equal.

          cat goodwds | /usr/lib/spell/hashmake | sort -u >tmp1
          cat tmp1 | /usr/lib/spell/spellin `cat tmp1 | wc -l` >hlist
          cat hlist | /usr/lib/spell/hashcheck >tmp2
          diff tmp1 tmp2
          The on-line dictionary rejects technical terms and proper
          names it does not know and treats them as misspellings.

     FILES
          /bin/spell
          /usr/lib/spell/spell
          /usr/lib/spell/spellin
          /usr/lib/spell/hashcheck
          /usr/lib/spell/hashmake
          DSPELL=/usr/lib/spell/hlist[ab]



     Page 2                                        (last mod. 1/16/87)

     spell(1)                                                 spell(1)



               hashed spelling lists, American & British
          SSPELL=/usr/lib/spell/hstop
               hashed stop list
          HSPELL=/usr/lib/spell/spellhist
               history file
          /usr/lib/spell/spellprog
               program

     SEE ALSO
          deroff(1), eqn(1), sed(1), sort(1), tbl(1), tee(1),
          troff(1).

     BUGS
          The spelling list's coverage is uneven; new installations
          will probably wish to monitor the output for several months
          to gather local additions; typically, these are kept in a
          separate local file that is added to the hashed
          spelling_list via spellin.
          The British spelling feature was done by an American.




































     Page 3                                        (last mod. 1/16/87)