

   OOppttiioonnss SSeettttiinnggss

        options(...)

   AArrgguummeennttss::

        ...: any options can be defined, using `name = value'.
             However, only the ones below are used in ``base
             .IP "" Further, `options('name') ==
             options()['name']', see the example.

     prompt: a string, used for rompt; should usually end in a
             blank (`" "').

   continue: a string setting the prompt used for lines which
             continue over one line.

      width: controls the number of characters on a line. You
             may want to change this if you resize the window
             that is running in.

     digits: controls the number of digits to print when print-
             ing numeric values. It is a suggestion only.

     editor: sets the default text editor, e.g., for `edit'.

   contrasts: The default contrasts used in model fitting such
             as `lm'.

   expressions: sets a limit on the number of nested expres-
             sions that will be evaluated.   This is especially
             important on the Macintosh since stack overflow is
             likely if this is set too high.

   na.action: the name of a function for treating missing val-
             ues (`NA''s) for certain situations.

   papersize: the paper format used for graphics printing; cur-
             rently read-only, set by environment variable
             R_PAPERSIZE, or in `config.site'.

   printcmd: the command used for graphics printing; currently
             read-only, set by environment variable R_PRINTCMD,
             or in `config.site'.

     ts.eps: the relative tolerance for certain time series
             (`ts') computations.

   DDeessccrriippttiioonn::

        This function allows the user to set and examine a
        variety of global ``options'' which affect the way in
        which computes and displays its results.

        Invoking `options()' with no arguments returns a list
        with the current values of the options.

   VVaalluuee::

        A list (in any case) with the previous values of the
        options changed, or all options when no arguments were
        given.

   EExxaammpplleess::

        options()       # printing all current options
        op <- options(); str(op) # nicer printing

        options('width')[[1]] == options()$width # the latter needs more memory
        options(digits=20)
        pi

        # set the editor, and save previous value
        old.o <- options(editor="nedit")
        old.o

        options(op)    # reset (all) initial options
        options('digits')

