1 10/20/86  create_list, cls
 2 
 3 Syntax as a command:  cls path {-control_arg}
 4 
 5 
 6 Function:  creates a nonprintable lister file (upon which document
 7 processing is performed) from a listin file (the ASCII file used to
 8 input and update a list).  See also the description of the make_list
 9 command, which creates an empty lister file from information supplied
10 on the command line.
11 
12 
13 Arguments:
14 path
15    is the pathname of the listin file.  The suffix listin must be the
16    last component of the listin segment name; however, if path does not
17    have a suffix of listin, one is assumed.  A lister file is created
18    in the working directory with the same entryname as path, and with
19    the entryname suffix of listin changed to lister.  Any existing copy
20    of this lister file is overwritten.
21 
22 
23 Control arguments:
24 -output_file PATH, -of PATH
25    causes the lister file to be placed in PATH.  Lister must be the
26    last component of the segment identified by PATH; however, if PATH
27    does not have a suffix of lister, one is assumed.  If this control
28    argument is not specified, the lister file is placed in the working
29    directory, and has the same entryname as the listin file, except
30    that the listin suffix is changed to lister.
31 -totals, -tt
32    prints number of records in path.
33 
34 
35 Notes:  The creation of a lister file is the only List Processing
36 operation which uses listin files as input.  All other operations use
37 lister files as input (which are unprintable files containing ASCII and
38 binary information).
39 
40 
41 A listin file provides an ASCII representation of a list.  It is used
42 to input and update a list.  The listin files can be created and
43 updated by using any text editor.
44 
45 
46 The create_list command sets the "lister" severity indicator.  A
47 severity of 2 is set when the lister file is not created or the
48 invocation of create_list terminates abnormally.  A severity of 0 is
49 set when the lister file is successfully created.