1 10/20/86 locate_words, lw
2
3 Syntax as a command: lw path words -control_args
4
5
6 Function: locates all occurrences of a given word within a specified
7 text segment or MSF. The user can specify more than one word to be
8 located. For each occurrence of a given word within the text segment,
9 the number of the lines containing the word is displayed.
10
11
12 Arguments:
13 path
14 is the pathname of the text segment or MSF.
15 words
16 are words to be located in the text segment.
17
18
19 Control arguments:
20 -count, -ct
21 displays only the number of occurrences for each word.
22 -from n, -fm n
23 the text segment is searched starting from the line number specified
24 by n. If this control argument is not specified, the text segment
25 is searched starting from the first line.
26 -header, -he
27 displays the pathname of the text segment.
28 -lines n, -li n
29 for each occurrence of a given word, the lines and line numbers
30 starting n lines before, through n lines after the line containing
31 the word are displayed. Thus, if n is 1, three lines are displayed.
32 If n is not specified, only the line containing the word is
33 displayed. Default
34
35
36 -long, -lg
37 for each occurrence of a given word, the line and line number of
38 that word is displayed.
39 -to n
40 the text segment is searched up to and including the line number
41 specified by n. If this control argument is not specified, the text
42 segment is searched to the last line.
43 -word STR
44 locates the word STR even though STR may look like a control
45 argument.
46
47
48 Notes: The -count control argument is mutually exclusive with the
49 -long and -lines control arguments.
50
51
52 Words are found in the text segment in the same way as described for
53 the create_wordlist command. Words containing no letters can be found
54 even though they are normally excluded from a wordlist.
55
56
57