\Header{packageStatus}{Package Management Tools}
\alias{newestVersion}{packageStatus}
\alias{print.packageStatus}{packageStatus}
\alias{summary.packageStatus}{packageStatus}
\alias{update.packageStatus}{packageStatus}
\alias{upgrade}{packageStatus}
\methalias{upgrade.packageStatus}{packageStatus}
\keyword{utilities}{packageStatus}
\begin{Description}\relax
Summarize information about installed packages and packages
available at various repositories, and automatically upgrade outdated
packages. These tools will replace \code{\Link{update.packages}} and friends
in the future and are currently work in progress.
\end{Description}
\begin{Usage}
\begin{verbatim}
packageStatus(lib.loc = NULL, repositories = getOption("repositories")())

## S3 method for class 'packageStatus':
summary(object, ...)

## S3 method for class 'packageStatus':
update(object, lib.loc = levels(object$inst$LibPath),
       repositories = levels(object$avail$Repository), ...)

## S3 method for class 'packageStatus':
upgrade(object, ask = TRUE, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{lib.loc}] a character vector describing the location of \R{}
library trees to search through, or \code{NULL}.  The default value
of \code{NULL} corresponds to all libraries currently known.
\item[\code{repositories}] a character vector of URLs describing the location of \R{}
package repositories on the Internet or on the local machine.
\item[\code{object}] return value of \code{packageStatus}.
\item[\code{ask}] if \code{TRUE}, the user is prompted which packages should
be upgraded and which not.
\item[\code{...}] currently not used.
\end{ldescription}
\end{Arguments}
\begin{Examples}
\begin{ExampleCode}
## Not run: 
x <- packageStatus()
print(x)
summary(x)
upgrade(x)
x <- update(x)
print(x)
## End(Not run)\end{ExampleCode}
\end{Examples}

