1 09/10/87  trim_list, tls
 2 
 3 
 4 Syntax as a command:  tls path -control_args
 5 
 6 
 7 Function:  deletes selected records from the specified lister file.
 8 Because selection is required for trimming any lists, the select
 9 control argument must be used with this command.
10 
11 
12 Arguments:
13 path
14    is the pathname of the lister file being trimmed.  The suffix lister
15    must be the last component of the lister file name; however, if path
16    does not have a suffix of lister, one is assumed.
17 
18 
19 Control arguments:
20 -select STR, -sel STR
21    specifies the records selected for deletion.  This is a REQUIRED
22    argument.
23 -totals, -tt
24    displays the number of records deleted.  This is an OPTIONAL
25    argument.
26 
27 
28 Notes:  The trim_list command sets the "lister" severity indicator.  A
29 severity of 2 is set when the trim is not performed, for some reason
30 other than no records matching the selection expression, or the
31 invocation of trim_list terminates abnormally.  A severity of 1 is set
32 when the selection expression matches no records.  A severity of 0 is
33 set when at least one record is trimmed and the command terminates
34 normally.
35