1 11/12/86  null_links, nlinks
 2 
 3 Syntax as a command:  nlinks star_names {-control_arg}
 4 
 5 
 6 Syntax as an active function:  [nlinks star_names {-control_arg}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of links for
10 which the target does not exist 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 
22 
23 Notes:  Only one name per link is returned; i.e., if a link has more
24 than one name that matches star_name, only the first match if returned.
25 
26 Since each entryname (or pathname) returned by null_links is enclosed
27 in quotes, the command processor treats each name as a single argument
28 regardless of the presence of special characters in the name.