Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ spell(1) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                 spell(1)



        _________________________________________________________________
        spell, hashmake, spellin, hashcheck                       Command
        find spelling errors
        _________________________________________________________________


        SYNTAX

        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



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                 spell(1)



        each job.

        The spelling list is based on many sources.  Although it is more
        haphazard than an ordinary dictionary, spell is also 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,



        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)





                                                                 spell(1)



        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

        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) in
        the Document Formatting Guide for the MV/UX and DG/UX Systems


        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.










        DG/UX 4.00                                                 Page 3
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026