![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / usr.bin / spell|
Return to README CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / usr.bin / spell |
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.4 (Berkeley) 3/20/87
6:
7: All files and subdirectories of /usr/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/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/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/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/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/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/man/man[1238n]), and builtin csh commands (named in
94: /usr/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/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.