1 01/12/2018  branches, nonlinks
 2 
 3 Syntax as a command:  nonlinks star_names {-control_arg{s}}
 4 
 5 
 6 Syntax as an active function:  [nonlinks star_names {-control_arg{s}}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of segments,
10 directories, and multisegment files that match one or more star names.
11 
12 
13 Arguments:
14 star_name
15    is a star name 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.  The default is
21    to return entrynames.
22 -chase
23    will process the targets of links when a starname is specified.
24 -inhibit_error, -ihe
25    does not display error messages if there are errors with the
26    specified star_name.
27 -no_inhibit_error, -nihe
28   displays error messages if there are errors with the specified
29   star_name. (Default)
30 -no_chase
31    will not process the targets of links when a starname is specified.
32    (Default)
33 
34 
35 Notes:  Only one name per branch is returned; i.e., if a branch has
36 more than one name that matches star_name, only the first match found
37 is returned.
38 
39 Since each entryname (or pathname) returned by nonlinks is enclosed in
40 quotes, the command processor treats each name as a single argument
41 regardless of the presence of special characters in the name.
42 
43 A synonym for nonlinks is branches.