1 11/30/87  add_search_rules, asr
 2 
 3 Syntax as a command:
 4   asr path1 {-control_args} ... pathN {-control_args}
 5 
 6 
 7 Function:  adds pathnames and keywords to the search rules for object
 8 segments.
 9 
10 
11 Arguments:
12 pathJ
13    is the absolute or relative pathname of a directory, or one of the
14    keywords listed below under "List of keywords."
15 
16 
17 Control arguments:
18 -after PATH, -af PATH
19    appends the previous path argument after the existing search rule
20    named by PATH.
21 -before PATH, -be PATH
22    inserts the previous path argument before the existing search rule
23    named by PATH.
24 -force, -fc
25    deletes any old occurrence of path in the search rules before adding
26    the new rule.
27 -inhibit_error, -ihe
28    suppresses warning messages printed when a pathname is nonexistent
29    or already in the search rules.
30 
31 
32 -no_force, -nfc
33    fails and prints an error message if a rule to be added already
34    exists in a different position.  (Default)
35 -no_inhibit_error, -nihe
36    causes warning messages to be printed.  (Default)
37 
38 
39 List of keywords:
40    Both pathJ and PATH arguments can be either pathnames or keywords.
41    The defined keywords are--
42       initiated_segments
43       referencing_dir
44       working_dir
45 
46    In addition PATH in control arguments can be--
47       home_dir
48       process_dir
49       any site-defined keywords
50 
51 
52 Notes:  No warning is printed if a rule to be added already exists in
53 the same position as that for which it is intended.
54 
55 See the print_search_rules, delete_search_rules, and set_search_rules
56 info segments.  The standard search rules are described in Section 4
57 under "Search Rules" in the Programmer's Reference Manual (AG91).