\Header{attach}{Attach Set of \R Objects to Search Path}
\keyword{data}{attach}
\begin{Usage}
\begin{verbatim}
attach(what, pos = 2, name = deparse(substitute(what)))
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{what}] ``database'' to attach. Typically a
\texttt{\Link{data.frame}}.
\item[\texttt{pos}] integer specifying position in \texttt{\Link{search}()} where
to attach.
\item[\texttt{name}] alternative way to specify the database to be attached.
\end{ldescription}
\end{Arguments}
\begin{Description}
A new database is attached. This means that its objects are made
available to \R.

------ should say more here ------\end{Description}
\begin{Value}
The \texttt{\Link{environment}} is returned invisibly with a
\texttt{"name"} attribute.\end{Value}
\begin{SeeAlso}
\texttt{\Link{library}}, \texttt{\Link{detach}}, \texttt{\Link{search}},
\texttt{\Link{objects}}, \texttt{\Link{environment}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(women)
attach(women)
summary(height)   #- which belongs to `women'
\end{ExampleCode}
\end{Examples}

