1 07/24/90 links
 2 
 3 Syntax as a command:  links star_names {-control_args}
 4 
 5 
 6 Syntax as an active function:  [links star_names {-control_args}]
 7 
 8 
 9 Function:  returns the entrynames or absolute pathnames of links that
10 match one or more star names.
11 
12 
13 Arguments:
14 star_names
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.
21 -inhibit_error, -ihe
22    ignore star_names if they are invalid or if access to tell of an
23    entry's existence is lacking.
24 -no_inhibit_error, -nihe
25    prints an error message if given an invalid star_name or if
26    access to tell of an entry's existence is lacking.  (Default)
27 
28 
29 Notes:  Only one name per link is returned; i.e., if a link has more
30 than one name that matches star_name, only the first match found is
31 returned.
32 
33 Since each entryname (or pathname) returned by links is enclosed in
34 quotes, the command processor treats each name as a single argument
35 regardless of the presence of special characters in the name.