Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ csr — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

9.0;csr (command_search_rules, revision 9.0, 85/05/16
CSR (COMMAND_SEARCH_RULES) -- Set or display command search rules.
usage:  CSR [dir ...] [-A dir...]


FORMAT

  CSR [directory ...] [-A dir_name]


  Command  search  rules  determine which directories the Shell examines to find
  commands.  CSR lets you display or change this  list.    If  a  new  Shell  is
  invoked inside the current process, or a new Shell script run, the subordinate
  Shell inherits the search rules of the parent Shell.  Note that this does  not
  apply  to "shells" created by the <SHELL> key, since that key actually creates
  a new, separate  process.    Its  Shell  receives  the  default  search  rules
  described below.

  By default, the Shell looks for commands in this order:

     1. Your  working  directory  ("."),  or the directory specified by the
        command's pathname.

     2. Your personal command directory, ~COM (the COM subdirectory of your
        naming directory).

     3. The system command directory, /COM.

  Refer  to  The DOMAIN System User's Guide for a detailed discussion of command
  search rules.

  Specifying CSR without arguments  or  options  displays  the  current  command
  search rules.


ARGUMENTS

  directory
  (optional)          Specify  new  command search sequence.  Multiple directory
                     pathnames are permitted; separate names with blanks.    The
                     Shell  will  search  the  directories in the order that you
                     specify.

                     Default if omitted:  display current search rules unless -A
                                          is specified.


OPTIONS

  -A dir_name        Append the specified  directory  name(s)  to  the  existing
                     command  search  sequence.    This  allows you to add a new
                     directory to the end  of  the  list  without  retyping  the
                     entire  list.   Multiple directory pathnames are permitted;
                     separate names with blanks.


EXAMPLES


  1. $ csr                                 Display current search rules.
     . ~com /com

  2. $ csr . ~com //us/myproj/com /com     Set new search sequence by adding
                                            an additional command directory.

  3. $ csr -a ~com/special_commands        Append the directory
                                            ~com/special_commands to the
                                            current list of directory names.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026