\HeaderA{make.packages.html}{Update HTML Documentation Files}{make.packages.html}
\keyword{utilities}{make.packages.html}
\begin{Description}\relax
Functions to link and (optionally) re-create the HTML documentation
files to reflect all installed packages.
\end{Description}
\begin{Usage}
\begin{verbatim}
make.packages.html(lib.loc = .libPaths(), packages = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{lib.loc}] character vector. List of libraries to be included.
\item[\code{packages}] logical: should be package indices be create.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This sets up the links from packages in libraries to the \file{.R}
subdirectory of the per-session directory (see \code{\LinkA{tempdir}{tempdir}})
and optionally creates the \file{packages.html} and \file{index.txt} files
to point to those links.  The slow part is creating those files (as
all the package \file{DESCRIPTION} files are read).

If a package is available in more than one library tree, all the
copies are linked, after the first with suffix \code{.1} etc.
\end{Details}
\begin{Value}
Invisible logical, indicating if the files were created.
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{help.start}{help.start}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}## Not run: 
# to prefer HTML help, put in your .Rprofile
options(htmlhelp=TRUE)
make.packages.html(packages=FALSE)
# this can be slow for large numbers of installed packages.
## End(Not run)\end{ExampleCode}
\end{Examples}

