.BG
.VE $Header: /usr3/s/current/s/.help/RCS/options,v 1.2 83/12/30 19:31:33 rab Exp $
.FN options
.FN option
.TL
options option: Set or Print Options
.CS
options(echo=, width=, length=, space=, max=,
        macsize=, dump=, sourcexit=)
.PP
.AG echo=
controls the amount of information echoed by S.  If `echo=0'
(the default) there is  no printing of commands or macro
expansions.  If `echo=1', there is printing of all macro
expansions and input from source files.  If `echo=2' (the
default for batch mode) all commands are printed before
being executed.  If `echo=3', commands, input from source
files, and macro expansions are printed.
.AG width=
specifies the width (in print positions) of the user's
terminal.  Default 80, minimum 20, maximum 133.
.AG length=
the length of an output page, currently used only for the
length of printer plots. Default 56, must be between 20 and
100.
.AG space=
the number of characters separating printed numbers.
Default 2.
.AG max=
the maximum number of elements of any vector that will be
printed.  If the length of a vector to be printed exceeds
this number, only the first `max' will be printed, followed
by a message telling what the actual length of the vector
was.  Default is 1000000.
.AG macsize=
the size (in characters) of the macro workspace.  Should be
large enough to accommodate the largest macro used, and
larger if macros are nested.  Default 10000.
.AG dump=
how long should an expression be (in characters) before an
error or interrupt generates an automatic dump (see `edit').
Default 20.
.AG sourcexit=
if TRUE, exit from a source file if an error occurs (the
default); if FALSE, continue execution of the source file
regardless of errors.
.PP
If `options' is called without arguments, it prints the current
options values.
.EX
options( )  # print current option values
.f 1
    echo = 0  macsize = 10000  dump = 20
    width = 80  length = 56  space = 2
    max = 1000000  sourcexit = T
.KW basic*
.KW session
.KW error
.WR
