1 11/10/86  nonobject_msfs, nobmsfs
 2 
 3 Syntax as a command:  nobmsfs star_names {-control_args}
 4 
 5 
 6 Syntax as an active function:  [nobmsfs star_names {-control_args}]
 7 
 8 
 9 Function: returns the entrynames or absolute pathnames of multisegment
10 files that are not object multisegment files and that match one or more
11 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 -inhibit_error, -ihe
25    returns false if a star_name is an invalid name or if access to tell
26    of an entry's existence is lacking.
27 -no_chase
28    will not process the targets of links when a starname is specified.
29    (Default)
30 -no_inhibit_error, -nihe
31    signals an error if a star_name is an invalid name or if access to
32    tell of an entry's existence is lacking.  (Default)
33 
34 
35 Notes: Only one name per msf is returned; i.e., if an msf has more than
36 one name that matches star_name, only the first match found is
37 returned.
38 
39 
40 Since each entryname (or pathname) returned by nonobject_msfs is
41 enclosed in quotes, the command processor treats each name as a single
42 argument regardless of the presence of special characters in the name.
43 
44 
45 Multisegment files that the user does not have at least r access to are
46 treated as nonobject msfs, since r access is needed to determine if
47 the file is an object msf.