1 02/22/85  shortest_path
 2 
 3 Syntax as a command:  shortest_path path {entry {component}}
 4 
 5 
 6 Syntax as an active function:  [shortest_path path {entry {component}}]
 7 
 8 
 9 Function: returns the shortest absolute pathname represented by the
10 argument if you give one argument, or the shortest absolute pathname of
11 the archive component or the entry in the directory specified by path
12 if you give two or three arguments.  The shortest name is determined by
13 using the shortest of each of the names on each component in the path.
14 
15 
16 Arguments:
17 path
18    is the pathname to be expanded and returned if you don't use entry;
19    otherwise this is the pathname of the directory to be used in the
20    returned pathname.
21 entry
22    is the entryname to be used in the returned pathname.
23 component
24    is the archive component name to be used in the returned pathname.
25 
26 
27 Notes: Since the pathname returned by path is in quotes, the command
28 processor treats it as a single argument regardless of special
29 characters in the name.
30 
31 When more than one name qualifies as the shortest name for a directory,
32 shorthest_path tries to select the name containing all lowercase
33 characters.  If several names still qualify, they are compared to the
34 primary name of the directory: the first name found with the same
35 first character as the primary name is chosen; this comparison is case
36 independent.