1 03/31/83  nonzero_msfs, nzmsfs
 2 
 3 Syntax:  nzmsfs star_names {-control_arg{s}}
 4 
 5 
 6 Syntax as active function:  [nzmsfs star_names {-control_arg{s}}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of multisegment
10 files with a nonzero bit count that match one or more star names.
11 
12 
13 Arguments:
14 star_names
15    are star names to be used in selecting the names to be returned.
16 
17 
18 Control arguments:
19 -absolute_pathname, -absp
20    returns absolute pathnames rather than entrynames.
21 -chase
22    will process the targets of links when a starname is specified.
23 -no_chase
24    will not process the targets of links when a starname is specified.
25    (Default)
26 
27 
28 Notes:  Only one name per msf is returned; i.e., if a multisegment file
29 has more than one name that matches star_name, only the first match
30 found is returned.
31 
32 Since each entryname (or pathname) returned by nonzero_msfs is enclosed
33 in quotes, the command processor treats each name as a single argument
34 regardless of the presence of special characters in the name.