Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

4.0;csr (command_search_rules, revision 4.0, 82/03/31
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, or a new shell script run, the new shell inherits the search rules of
  the invoking shell.  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 Chapter 3 of  the  DOMAIN  System  Command  Reference  Manual  for  a
  detailed discussion of command search rules.


ARGUMENTS

  Specifying CSR without arguments displays the current command search rules.

  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.


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.  You cannot specify this option
                     if you have already specified any  directory  pathnames  as
                     arguments.


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/specoal_commands to the
                                              current list of directory names.

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