1 10/20/86  trim_wordlist, twl
 2 
 3 Syntax as a command:  twl path {dict_paths} {-control_args}
 4 
 5 
 6 Function:  trims (deletes) all words in the specified wordlist segment
 7 or MSF that are found in one or more Wordpro dictionaries.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of the wordlist segment or MSF to be trimmed.  If
13    path does not have the suffix wl, one is assumed; however, wl must
14    be the last component of the segment name.
15 dict_paths
16    are the pathnames of dictionaries to be searched in order.  If
17    dict_paths does not have a suffix of dict, one is assumed; however,
18    dict must be the last component of the dictionary segment name.  If
19    no dict_paths are specified, the dictionaries in the dict search
20    list are used.
21 
22 
23 Control arguments:
24 -brief, -bf
25    suppresses the display of the number of words trimmed and the number
26    of words remaining in the trimmed wordlist segment.
27 -exact_match, -exm
28    trims only those words that match exactly a word found in a
29    dictionary, i.e., no special processing is performed with respect to
30    capitalization (see "Notes" below).
31 -temp_dir path, -td path
32    path holds the temporary segment if the input file is an MSF.
33    (Default is the process directory.)
34 
35 
36 Notes:  For each word processed, the dictionaries are searched in the
37 order specified or as defined in the dict search list.  Normally, when
38 a word is found in a dictionary, it is trimmed.  However, if the word
39 found has the no-trim attribute, then the word is not trimmed and no
40 more dictionaries are searched for this word.
41 
42 
43 When searching for a word in a dictionary, special processing of
44 capital letters is performed unless the -exact_match control argument
45 is specified.
46 
47 
48 Most words in a dictionary consist of all lowercase letters.  These
49 words match any representations of themselves that are either all
50 lowercase letters, all lowercase letters with a leading capital letter,
51 or all capital letters.
52 
53 
54 Words in a dictionary that have a leading capital letter only match
55 representations of themselves that have a leading capital letter or are
56 all capital letters.
57 
58 
59 Words in a dictionary that consist of all capital letters or mixed
60 lowercase and capital letters only match representations of themselves
61 that have the identical capitalization.