Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / dict

Annotation of 43BSDReno/share/dict/README, revision 1.1

1.1     ! root        1: Copyright (c) 1987 Regents of the University of California.
        !             2: All rights reserved.  The Berkeley software License Agreement
        !             3: specifies the terms and conditions for redistribution.
        !             4: 
        !             5:        @(#)README      1.5 (Berkeley) 6/24/90
        !             6: 
        !             7: All files and subdirectories of /usr/share/dict are recommended for
        !             8: rdisting except web2 and web2a (because of their size), and some of
        !             9: the files  hlist*  depending on needs of your machine (details below).
        !            10: Descriptions of most of these files are given under FILES below.
        !            11: 
        !            12: The new subdirectory "special" contains lists of words in specialized
        !            13: fields, which may be hashed in with the regular lists on machines having
        !            14: many users working in these fields.  As of this writing, there are two
        !            15: such specialized wordlists.
        !            16: 
        !            17: It is advised that system managers also create a directory
        !            18: /usr/local/dict. This can be used to maintain files of particular
        !            19: interest to users of each machine (e.g., surnames of members of the
        !            20: department on a departmental machine).
        !            21: 
        !            22: The hashed wordlists hlista and hlistb in this distribution include
        !            23: the words in the file special/4bsd, comprising current 4bsd
        !            24: commands, system calls, etc. (from "abs" to "zcat").  Machines
        !            25: whose primary users are programmers should take these files by
        !            26: rdist.  For machines with other user populations, a file "hlist" is
        !            27: provided which only contains the contents of /usr/dict/words.  Managers
        !            28: of such machines should rdist this file, and use "spellin" to produce
        !            29: files hlist{a,b} which contain the words from
        !            30: /usr/share/dict/{american,british} respectively, plus any other files
        !            31: appropriate to the needs of the majority of their users.  (Some basic
        !            32: unix commands and terms that general users are likely to encounter,
        !            33: e.g. troff, emacs, tty, have been included in /usr/share/dict/words.
        !            34: More may be added as suggestions are received.)  Here, for instance is a
        !            35: script that might be used to create the hashlists on a particular
        !            36: machine, so as to include the words in /usr/share/dict/special/math, as well
        !            37: as two local lists which we will assume are called
        !            38: /usr/local/dict/surnames and /usr/local/dict/acronyms.
        !            39: 
        !            40:        #
        !            41:        cd /usr/share/dict
        !            42:        cat american special/math /usr/local/dict/{surnames,acronyms} | \
        !            43:                spellin hlist > hlista
        !            44:        cat british  special/math /usr/local/dict/{surnames,acronyms} | \
        !            45:                spellin hlist > hlistb
        !            46: 
        !            47:      Hashlists can also be created from scratch using
        !            48: /usr/src/usr.bin/spell/Makefile.  This is now written so that if "make"
        !            49: is run with no options it will produce the hashed files as presently
        !            50: distributed, but so that the extra wordlists used can be controlled with
        !            51: variables LOCAL and SPECIAL.  For instance, the results given by the
        !            52: above script can be obtained by doing:
        !            53: 
        !            54:        cd /usr/src/usr.bin/spell
        !            55:        make LOCAL='/usr/local/dict/surnames /usr/local/dict/acronyms' \
        !            56:                SPECIAL=special.math 
        !            57:        make install
        !            58: 
        !            59:      Returning to the subject of the wordlists in /usr/dict, these are,
        !            60: in general, ordered as in  sort -df.  This makes no difference for
        !            61: spell's hashing process, but makes a difference for other commands,
        !            62: such as "look", that perform binary searches on the unhashed lists.
        !            63: 
        !            64: Complaints, and any additional suggestions for words or wordlists,
        !            65: should be sent to me.  I cannot fix bugs involving the code of "spell",
        !            66: but I am maintaining a list of these bugs, and of other ideas for
        !            67: improvement.
        !            68:                George Bergman, [email protected]
        !            69:                18 March, 1987
        !            70: 
        !            71: --------------------------------------------------------------------
        !            72: FILES and subdirectories of /usr/share/dict:
        !            73: 
        !            74:     words    -- common words, and important technical terms from all
        !            75:        fields, that are spelled the same in British and American usage.
        !            76:     american -- spellings preferred in American but not British usage.
        !            77:     british  -- spellings preferred in British but not American usage.
        !            78:     stop     -- forms that would otherwise be derivable by "spell" from
        !            79:        words in one of the above files, but should not be accepted.
        !            80:     hlist    -- hashed list, formed from the file "words" only.
        !            81:     hlista   -- hashed list, formed from files {words,american,special/4bsd}.
        !            82:     hlistb   -- hashed list, formed from files {words,british,special/4bsd}.
        !            83:     hstop    -- hashed list, formed from file "stop".
        !            84:     web2     -- words from Webster's 2nd International (see WEB below).
        !            85:     web2a    -- compounds and phrases from same source.
        !            86:     README   -- this file
        !            87:     papers/  -- an (out-of-date specialized) bibliographical database,
        !            88:        used as the default by the program "refer".
        !            89:     special/ -- directory of less common terms from specialized fields.
        !            90:        It presently contains:
        !            91: 
        !            92:        special/4bsd -- commands and system calls (from filenames in
        !            93:            /usr/share/man/man[1238n]), and builtin csh commands (named in
        !            94:            /usr/share/man/man1/csh.1) of the current version of 4bsd Unix.
        !            95:            (Supersedes old "/usr/src/usr.bin/spell/local".)
        !            96:        special/math -- some mathematical terms not in /usr/share/dict/words.
        !            97: 
        !            98: WEB ---- (introduction provided by jaw@riacs) -------------------------
        !            99: 
        !           100: Welcome to Webster's Second International, all 234,936 words worth.
        !           101: The 1934 copyright has elapsed, according to the supplier.  The
        !           102: supplemental 'web2a' list contains hyphenated terms as well as assorted
        !           103: noun and adverbial phrases.  The wordlist makes a dandy 'grep' victim.
        !           104: 
        !           105:      -- James A. Woods    {ihnp4,hplabs}!ames!jaw    (or jaw@riacs)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.