ssr (1) --- set search rule                              08/27/84


          | _U_s_a_g_e

                 ssr [ <new search rule> ]


            _D_e_s_c_r_i_p_t_i_o_n

                 The  'ssr'  command  allows  users of the Subsystem shell to
                 specify which directories and command  libraries  should  be
                 searched  in  the  process  of  invoking  a  command.  If an
                 argument is specified, it becomes the new  search  rule;  if
                 not, the search rule remains unchanged.  In either case, the
                 resulting search rule is printed.

                 The search rule consists of a string of 'elements' separated
                 by commas.  Each element is a template that specifies either
                 a special command library or a directory to be searched.  In
                 the  process  of invoking a command, the shell examines each
                 element in the search rule from  left  to  right.   In  each
                 element,  it  replaces all ampersands ("&") with the command
                 name specified by the user.  It then searches for a  command
                 by  that  name.   The  shell keeps examining elements of the
                 search rule until a command is located or  the  end  of  the
                 search rule is reached.

                 For example, the default search rule,

                      '^int,^var,&,=lbin=/&,=bin=/&'

                 specifies the following directories and libraries:

                      ^int      Internal commands - those commands recognized
                                and executed by the shell itself.

                      ^var      Shell variables - the effect of 'executing' a
                                variable   is  to  print  the  value  of  the
                                variable on standard output 1.

                      &         A  single  ampersand  specifies  the  current
                                working directory.

                      =lbin=/&  The   directory   '//lbin',   where  locally-
                                supported commands are stored.

                      =bin=/&   The directory '//bin',  where  standard  Sub-
                                system commands reside.  Note that the trail-
                                ing  slash  and ampersand MUST be included in
                                the search rule.



          | _E_x_a_m_p_l_e_s

                 ssr
                 ssr "^var,^int,&,//newshbin/&,//newbin/&"
                 ssr "^var,//project_lib/&"


            ssr (1)                       - 1 -                       ssr (1)




            ssr (1) --- set search rule                              08/27/84


            _S_e_e _A_l_s_o

                 set (1), declare (1), forget (1), vars (1), _U_s_e_r_'_s _G_u_i_d_e _f_o_r
                 _t_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _C_o_m_m_a_n_d _I_n_t_e_r_p_r_e_t_e_r






















































            ssr (1)                       - 2 -                       ssr (1)