\Header{undoc}{Find Undocumented Objects}
\keyword{documentation}{undoc}
\begin{Description}\relax
Finds the objects in a package which are undocumented, in the sense
that they are visible to the user (or data objects provided by the
package), but no documentation entry exists.\end{Description}
\begin{Usage}
\begin{verbatim}
undoc(package, dir, lib.loc = .lib.loc)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{package}] a character string naming an installed package.
\item[\code{dir}] a character string specifying the path to a package's root
source directory.  This must contain the subdirectory \file{man}
with \R{} documentation sources (in Rd format), and at least one of
the \file{R} or \file{data} subdirectories with \R{} code or data
objects, respectively.
\item[\code{lib.loc}] a character vector describing the location of \R{}
library trees to search for \code{package}.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This function is useful for package maintainers mostly.  In principle,
\emph{all} user level \R{} objects should be documented; note however
that the precise rules for documenting methods of generic functions
are still under discussion.\end{Details}
\begin{Value}
A character vector containing the names of the undocumented objects.\end{Value}
\begin{Examples}
\begin{ExampleCode}
undoc("eda")                   # Undocumented objects in `eda'
\end{ExampleCode}
\end{Examples}

