1 10/20/86  print_wordlist, pwl
 2 
 3 
 4 Syntax as a command:  pwl path {-control_args}
 5 
 6 
 7 Function:  displays (prints) the words contained in a wordlist segment
 8 in a multiple column format.
 9 
10 
11 Arguments:
12 path
13    is the pathname of a wordlist segment.  If path does not have the
14    suffix wl, one is assumed; however, wl must be the last component of
15    the segment name.
16 
17 
18 Control arguments:
19 -brief_errors, -bfe
20    suppresses error messages when no words are generated in the
21    wordlist (see -output-file).
22 -columns n, -cols n
23    specifies that the output is to contain n columns.  (The default
24    number of columns depends on the line length and the column width.
25 -column_width n, -cw n
26    specifies that the column width is n characters.  (The default
27    column width is 20.)
28 
29 
30 -output_file path, -of path
31    directs the output to the segment specified by path in a format
32    suitable for printing on a line printer.  If there are no words in
33    the wordlist, the following error message is provided.  There are no
34    words in the <wordlist name> wordlist and an empty wordlist is
35    created unless -brief_errors was also provided.
36 -page_length n, -pl n specifies that the page length is n lines.  (The
37    default page length is 60 if -output_file is specified; otherwise,
38    it is 66.)
39 -vertical_margin n, -vm n
40    specifies that the vertical margin size is n lines.  (The default
41    vertical margin size is 0 if -output_file is specified; otherwise,
42    it is 3.)
43 
44 
45 Notes:  The default number of columns is the maximum number of columns
46 that fit within the line length.  If the -output_file control argument
47 is specified, a line length of 136 is assumed.  Otherwise, the line
48 length defined for the user_output switch is used.  If none is defined,
49 a line length of 72 is assumed.
50 
51 
52 If the length of a word is greater than or equal to the column width,
53 the word is truncated.  An asterisk (*) is appended to such words to
54 indicate truncation.
55 
56 
57 Output is divided into pages.  Each page has a top and bottom vertical
58 margin consisting of n blank lines where n is the vertical margin size.
59 These lines are included in the page length.  The column height on a
60 page is equal to the page length minus twice the vertical margin size.
61 In the default case, the column height equals 60 lines whether or not
62 the -output_file control argument is specified.  On the last page of
63 output, the column height is reduced to the minimum height needed to
64 accommodate remaining words.  If the -output_file control argument is
65 specified, each page is terminated by an ASCII new page character
66 (octal 014).
67 
68 
69 
70 
71