\HeaderA{RShowDoc}{Show R Manuals and Other Documentation}{RShowDoc}
\keyword{documentation}{RShowDoc}
\begin{Description}\relax
Utility function to find and display \R{} documentation.
\end{Description}
\begin{Usage}
\begin{verbatim}
RShowDoc(what, type = c("pdf", "html", "txt"), package)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{what}] a character string: see \sQuote{Details}.
\item[\code{type}] an optional character string giving the preferred format.
\item[\code{package}] an optional character string specifying the name of a
package within which to look for documentation.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{what} can specify one of several different sources of documentation,
including the \R{} manuals (\code{R-admin}, \code{R-data}, \code{R-exts},
\code{R-intro}, \code{R-ints}, \code{R-lang}), \code{NEWS},
\code{COPYING} (the GPL licence), \code{FAQ} (also available as
\code{R-FAQ}), and the files in \file{\var{\LinkA{R\_HOME}{R.Rul.HOME}}/doc}.

If \code{package} is supplied, documentation is looked for in the
\file{doc} and top-level directories of an installed package of that name.

If \code{what} is missing a brief usage message is printed.

The documentation types are tried in turn starting with the first
specified in \code{type} (or \code{"pdf"} if none is specified).
\end{Details}
\begin{Value}
A invisible character string given the path to the file found.
\end{Value}
\begin{Examples}
\begin{ExampleCode}## Not run: 
RShowDoc("R-lang")
RShowDoc("FAQ", type="html")
RShowDoc("frame", package="grid")
RShowDoc("changes.txt", package="grid")
RShowDoc("NEWS", package="MASS")
## End(Not run)\end{ExampleCode}
\end{Examples}

