NAME

create-interp - Create Soar interpreter

SYNOPSIS

create-interp [options]

DESCRIPTION

This command creates new Soar interpreters identified by given names. The various options specify any special initialization conditions, if any. The most important option is the type which indicates what type of interpreter is to be created and must be one of the following values:

-agent
Create agent interpreter(s). This includes Tcl + Tk + Soar if Tk is enabled, otherwise this includes Tcl + Soar.
-wish
Create wish interpreter(s). Wish includes Tcl + Tk. This is available only if Tk is enabled.
-tclsh
Create tclsh interpreter(s). Tclsh includes only Tcl.

One or more names may be given after the above types. If no type is given on the command line when Soar is invoked, a single -agent interpreter is created with the name soar. Within Soar, it is an error to call this command without specifying some interpreter name to create.

Tk is enabled if Soar has been compiled with the USE_TK option, the $DISPLAY environment variable is set, and the -noTk option has not been given on the command line (see below).

OPTIONS

Environment variables used below are assumed to be defined in the Unix shell used to start Soar.
-path
Use the given sequence of directories to scan for agent initialization files. The sequence is a colon (:) separated list of directories. The default value is ".:$HOME", where $HOME is the user's home directory. Agent initialization files are assumed to be named name.soar.
-display
Place the top-level window associated with the interpreter on the indicated display. The value of this option follows standard X conventions for specifying displays. The default is the value of $DISPLAY. This only applies to wish-based shells.
-file
Specifies a file to run immediately after defining the last interpreter. This only applies when invoking Soar.
-geometry
Specifies the geometry (width, height, and placement) of the top-level window associated with the interpreter. The value of this option follows standard X conventions for specifying geometries. This only applies to wish-based shells.
-help
Lists all available options for this command.
-noTk
Do not use Tk when creating any subsequent interpreters. This option applies to the rest of the command line.
-sync
Use synchronous X server updates with all subsequent wish-based interpreter windows. This applies only to wish-based shells.
-verbose
Print diagnostic information about options as each interpreter is defined.

SEE ALSO

list-interps, destroy-interp