spell(1)                   DG/UX 4.30                    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 not in the list or words not
          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 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 option, British spelling is checked.  Besides
          preferring centre, colour, programme, speciality, travelled,
          etc., this option insists upon -ise in words like
          standardise.

          Under the -x 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 option, spell will follow the chains of all included
          files.  Under the -i option, spell will ignore all chains of
          included files.

          Under the +local_file 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.  Although it is
          more haphazard than an ordinary dictionary, spell is also



     Licensed material--property of copyright holder(s)         Page 1

     spell(1)                   DG/UX 4.30                    spell(1)



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

          You can specify pertinent auxiliary files 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 spell's hash lists:

          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.


     EXAMPLES
          $ cat spellcheck

          This is a sample file taht can be used to test teh spell comand.
          Obviously there are some speling errers.

          $ spell spellcheck > spellout
          $ cat spellout1

          comand
          errers
          speling
          taht
          teh
          $

          This example shows the contents of a file with some spelling
          errors.  The spell command is used to check the file for
          errors, and the output is sent to a file called spellout1.
          As you can see, all of the mispelled words are in this file.

          $ spell -v spellcheck >spellout2

          $ cat spellout2




     Licensed material--property of copyright holder(s)         Page 2

     spell(1)                   DG/UX 4.30                    spell(1)



          comand
          errers
          speling
          taht
          teh
          +ly  Obviously
          +d   used
          $

          This example uses the -v option.  With this option, the
          mispelled words are listed as well as all of the words not
          literally in the spelling list.  The plausible derivations
          of these words are shown.

     FILES
          D_SPELL=/usr/lib/spell/hlist[ab]   Hashed spelling lists,
                                             American & British.
          S_SPELL=/usr/lib/spell/hstop       Hashed stop list.
          H_SPELL=/usr/lib/spell/spellhist   History file.
          /usr/lib/spell/spellprog           Program.

     SEE ALSO
          sed(1), sort(1), tee(1).  deroff(1), eqn(1), tbl(1),
          troff(1).
          Using the Documenter's Tool Kit on the DG/UX System

     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.























     Licensed material--property of copyright holder(s)         Page 3