\Header{sys.source}{Parse and Evaluate Expressions from a File}
\keyword{file}{sys.source}
\keyword{utilities}{sys.source}
\begin{Description}\relax
Parses expressions in the given file, and then successively evaluates
them in the specified environment.\end{Description}
\begin{Usage}
\begin{verbatim}
sys.source(file, envir = NULL, chdir = FALSE,
           keep.source = getOption("keep.source.pkgs"))
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{file}] a character string naming the file to be read from
\item[\code{envir}] an \R{} object specifying the environment in which the
expressions are to be evaluated.  May also be a list or an integer.
The default value \code{NULL} corresponds to evaluation in the base
environment.  This is probably not what you want; you should
typically supply an explicit \code{envir} argument.
\item[\code{chdir}] logical; if \code{TRUE}, the \R{} working directory is
changed to the directory containing \code{file} for evaluating.
\item[\code{keep.source}] logical.  If \code{TRUE}, functions ``keep their
source'' including comments, see \code{\Link{options}(keep.source = *)}
for more details.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
For large files, \code{keep.source = FALSE} may save quite a bit of
memory.\end{Details}
\begin{SeeAlso}\relax
\code{\Link{source}}, and \code{\Link{library}} which uses
\code{sys.source}.\end{SeeAlso}

