1 01/14/87  nonsegments, nonsegs
 2 
 3 Syntax as a command:  nonsegs star_names {-control_args}
 4 
 5 
 6 Syntax as an active function:  [nonsegs star_names {-control_args}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of directories,
10 multisegment files (MSFs), or links 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    processes the targets of links when you specify a starname.
23 -inhibit_error, -ihe
24    returns false if star_name is an invalid name or if access to tell
25    of an entry's existence is lacking.
26 -no_chase
27    does not process the targets of links when you specify a starname.
28    (Default)
29 -no_inhibit_error, -nihe
30    signals an error if star_name is an invalid name or if access to
31    tell of an entry's existence is lacking.  (Default)
32 
33 
34 Notes:  Only one name per entry is returned; i.e., if a directory, MSF,
35 or link has more than one name that matches star_name, only the first
36 match found is returned.
37 
38 Since each entryname (or pathname) returned by nonsegs is enclosed in
39 quotes, the command processor treats each name as a single argument
40 regardless of the presence of special characters in the name.