1 07/09/90  add_name, an
 2 
 3 Syntax as a command:  an path names {-control_args}
 4 
 5 
 6 Function: adds alternate name(s) to a segment, multisegment file,
 7 directory, link, data management file, or extended entry.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of a segment, multisegment file, directory, link, or
13    extended entry.  This argument can be "-name STR" to specify a
14    nonstandard name, such as one beginning with a minus sign or
15    containing * or >.  The star convention is allowed, but does not
16    apply to STR.
17 names
18    are additional names to be added.  This argument can be "-name STR".
19    The equal convention is allowed, but does not apply to STR.
20 
21 
22 Control arguments:
23 -brief, -bf
24    suppresses the error message "Name already on entry".
25 -interpret_as_extended_entry, -inaee
26    interpret the selected entry as an extended entry type.
27 -interpret_as_standard_entry, -inase
28    interpret the selected entry as a standard entry type.
29 -long, -lg
30    does not suppress the error message "Name already on entry".
31    (Default)
32 
33 
34 Access required: You need modify permission on the parent directory.
35 
36 
37 Notes: Two entries in a directory cannot have the same entryname;
38 therefore, add_name takes special action if the added name already
39 exists.  If the added name is an alternate name of another entry, the
40 name is removed from this entry, added to the entry specified by path,
41 and you are informed of this action.  If the added name is the only
42 name of another entry, you are asked whether to delete this entry.  If
43 you answer "yes", the entry is deleted and the name is added to the
44 entry specified by path; if you answer "no", no action is taken.
45 
46 See the delete_name and rename commands.