\HeaderA{libPaths}{Search Paths for Packages}{libPaths}
\aliasA{.libPaths}{libPaths}{.libPaths}
\aliasA{.Library}{libPaths}{.Library}
\keyword{data}{libPaths}
\begin{Description}\relax
\code{.libPaths} gets/sets the library trees within which packages are
looked for.
\end{Description}
\begin{Usage}
\begin{verbatim}
.libPaths(new)

.Library
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{new}] a character vector with the locations of \R{} library trees.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{.Library} is a character string giving the location of the
default library, the \file{library} subdirectory of \env{R\_HOME}.

\code{.libPaths} is used for getting or setting the library trees that
\R{} knows about (and hence uses when looking for packages).  If called
with argument \code{new}, the library search path is set to
the existing files in \code{unique(c(new, .Library))} and this is
returned.  If given no argument, a character vector with the currently
known library trees is returned.

The library search path is initialized at startup from the environment
variable \env{R\_LIBS} (which should be a colon-separated list of
directories at which \R{} library trees are rooted) by calling
\code{.libPaths} with the directories specified in \env{R\_LIBS}.
\end{Details}
\begin{Value}
A character vector of file paths.
\end{Value}
\begin{References}\relax
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
\emph{The New S Language}.
Wadsworth \& Brooks/Cole.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{library}{library}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
.libPaths()                 # all library trees R knows about
\end{ExampleCode}
\end{Examples}

