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