Next: setseeds() Up: MacAnova Help File Previous: setodometer()   Contents

setoptions()

Usage:
setoptions(option1:value [,option2:value ... ] [,badoptok:T]) option1,
  option2, ... option names
setoptions(str [,badoptok:T]), where str is of the form
  structure(option1:value, ...)
Type 'usage(options)' for a succinct list of all options and their
   permissible values.



Keywords: control, missing values, output, random numbers
                                  Usage
setoptions(keyword:value [,keyword:value, ...]) changes the values of
various items specified by the keywords.

Legal option names are 'angles', 'batchecho', 'dumbplot', 'errors',
'findmacros', 'format', 'fstats', 'height', 'inline', 'labelabove',
'labelstyle', 'maxlinelen', 'maxwhile', 'minpvalue', 'missing', 'nsig',
'prompt', 'pvals', 'quiet', 'restoredel', 'seeds', 'update',
'traceback', 'warnings', 'wformat', and 'width'.

Option name 'lines' is a synonym for 'height' for compatibility with
previous versions.

Options 'history' and 'savehistry' (note spelling) are also available
(see gethistory() and gethistory()).

On windowed versions, option 'scrollback' is also legal.

In the Windows version, option 'keyboard' is also legal.

On Mac OS 9, options 'font' and 'fontsize' are also legal.

See topic 'options' for details on these options.

                           Keyword 'badoptok'
setoptions(keyword:value [,keyword:value, ...] , badoptok:T) does the
same, except it is not an error is a non-existent or otherwise improper
option is specified.  This feature is intended to provide backward
compatibility to macros making use of new options.

                           Structure argument
setoptions(Options [,badoptok:T]), where Options is a structure with
component names matching any or all of the legal option names, sets the
options from the component values.  For example, if Options was created
by 'Options <- getoptions()', setoptions(Options) resets the options to
what they were at the time getoptions() was invoked.  See also
getoptions().

                Restoring default values for all options
setoptions(defaults:T) restores all the options to their default values.
It is an error if there is more than one argument.  If a prompt was set
at start up, it is restored.  When setoptions(defaults:T) occurs in a
batch file, the current batch prompt is restored to what it was when the
batch file was opened, either the file name or the value of keyword
'prompt' on the batch() command.  See batch().

                        Options menu on Mac OS 9
On Mac OS 9, you can use the Options menu to change most of the
options.  This works by generating and executing an appropriate
setoptions() command.


Gary Oehlert 2006-01-30