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