1 10/20/86  make_list, mkls
 2 
 3 
 4 Syntax as a command:  mkls path -control_args
 5 
 6 
 7 Function:  creates a nonprintable empty lister file upon which document
 8 processing is performed.  (Also see the description of the create_list
 9 command, which creates a lister file using an ASCII input file.)
10 
11 
12 Arguments:
13 path
14    is the pathname of the lister file to be made.  Lister must be the
15    last component of the lister file name; however, if path does not
16    have a suffix of lister, one is assumed.
17 
18 
19 Control arguments:
20 -delimiter rf, -dm rf
21    sets the record delimiter used in the lister file to r, and the
22    field delimiter used in the lister file to f.  Both r and f must be
23    exactly one character long and be chosen from:
24 
25         ! # $ % & * = ? @ ^ | ~
26 
27    and each must be a different character.  If this control argument is
28    omitted, the record delimiter, by default, is the dollar character
29    ($), and the field delimiter, by default, is the equal character
30    (=).
31 -field_name name1 ...  nameN, -fn name1 ...  nameN
32    sets the names of the fields in the created lister file to name1
33    through nameN.  Each name must begin with an alphabetic character
34    and consist of alphanumeric characters.  No two names can be the
35    same.  This control argument is required.
36 
37 
38 Notes:  The make_list command sets the "lister" severity indicator.  A
39 severity of 2 is set when the lister file is not created or the
40 invocation of make_list terminates abnormally.  A severity of 0 is set
41 when the lister file is successfully created.