1 01/14/87  segments, segs
 2 
 3 Syntax as a command:  segs star_names {-control_args}
 4 
 5 
 6 Syntax as an active function:  [segs star_names {-control_args}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of segments
10 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 segment is returned; i.e., if a segment has
35 more than one name that matches a star_name, only the first match found
36 is returned.
37 
38 Since each entryname (or pathname) returned by segs 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.