

   RReeddiirreecctt IInnppuutt

        source(file, local = FALSE, echo = debug, print.eval = echo,
               debug = FALSE, max.deparse.length = 150)

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

       file: the name of the file to read from (quoted).

      local: if `local' is `FALSE', the statements scanned are
             evaluated in the global environment, otherwise in
             the local calling source.

       echo: logical; if `TRUE', each expression is printed
             after parsing, before evaluation.

   print.eval: logical; if `TRUE', the result of `eval(i)' is
             printed for each expression `i'; defaults to
             `echo'.

      debug: if `TRUE', more diagnostics are printed during
             parsing and evaluation of input, including extra
             info for each expression.

   max.deparse.length: integer; is used only if `echo' is
             `TRUE' and gives the maximal length of the
             ``echo'' of a single expression.

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

        `source' causes to accept its input from the named file
        (the name must be quoted).  Input is read from that
        file until the end of the file is reached.  `parse' is
        used to scan the files in, they are then evaluated
        sequentially in the chosen environment.

   SSeeee AAllssoo::

        `demo' which uses `source'; `eval', `parse' and `scan'.

