\HeaderA{help.start}{Hypertext Documentation}{help.start}
\keyword{documentation}{help.start}
\begin{Description}\relax
Start the hypertext (currently HTML) version of \R's online
documentation.
\end{Description}
\begin{Usage}
\begin{verbatim}
help.start(gui = "irrelevant", browser = getOption("browser"),
           remote = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{gui}] just for compatibility with S-PLUS.
\item[\code{browser}] the name of the program to be used as hypertext
browser. It should be in the \env{PATH}, or a full path specified.

\item[\code{remote}] A character giving a valid URL for the \file{\$R\_HOME}
directory on a remote location.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
All the packages in the known library trees are linked to directory
\file{.R} in the per-session temporary directory.  The links are
re-made each time \code{help.start} is run, which should be done
after packages are installed, updated or removed.

A side effect is to set \code{options(htmlhelp = TRUE)} so that future
help requests (by default) are sent to the browser.

If the browser named by the \code{browser} argument is different from
the default browser as specified by \code{options("browser")}, the
default is changed to the given browser so that it gets used for all
future help requests.
\end{Details}
\begin{Note}\relax
There is a Java-based search facility available from the HTML page
that \code{help.start} brings up.  Should this not work, please
consult the \sQuote{R Installation and Administration} manual which is
linked from that page.
\end{Note}
\begin{SeeAlso}\relax
\code{\LinkA{help}{help}()} for on- and off-line help in ASCII/Editor or
PostScript format.

\code{\LinkA{browseURL}{browseURL}} for how the help file is displayed.

\code{\LinkA{RSiteSearch}{RSiteSearch}} to access an on-line search of \R{} resources.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## Not run: 
help.start()
## End(Not run)\end{ExampleCode}
\end{Examples}

