source — Apollo

9.0;source, revision 9.0, 85/03/27
SOURCE -- Execute a Shell script at the current Shell level.
usage:  SOURCE script_name [arg1...]


FORMAT

  SOURCE script_name [arg1...]


  SOURCE  allows you to execute a Shell script at the current Shell level.  When
  you type

    $ MY_SCRIPT arg1

  your script runs in a new (subordinate) Shell level.    This  means  that  all
  variables  are  now  defined  at a new level; that your script can't delete or
  otherwise effect variables at  the  level  above;  that  state  settings  like
  VON/BON/EON that get set in the script vanish when the script finishes, and so
  forth.

  On the other hand, typing

    $ SOURCE MY_SCRIPT arg1

  executes the script at the current Shell level, just as though you  had  typed
  the  contents  of  MY_SCRIPT  into the process input window (and filled in the
  command line arguments yourself).  If the script says 'von' then VON  will  be
  set  after  the  script  exits.   If it defines a variable, that variable will
  still be defined, etc.


ARGUMENTS

  script_name
  (required)         Specify the name of the script to be executed.

  arg1...
  (optional)         Specify any arguments to be passed to the script.

                     Default if omitted:  no arguments passed.
Museum
