\HeaderA{Deprecated}{Marking Objects as Deprecated}{Deprecated}
\aliasA{.Deprecated}{Deprecated}{.Deprecated}
\keyword{documentation}{Deprecated}
\keyword{utilities}{Deprecated}
\begin{Description}\relax
When an object is about removed from \R{} it is first deprecated and
should include a call to \code{.Deprecated}.
\end{Description}
\begin{Usage}
\begin{verbatim}
.Deprecated(new, package=NULL, msg)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{new}] character string: A suggestion for a replacement function.

\item[\code{package}] character string: The package to be used when suggesting where the
deprecated function might be listed.

\item[\code{msg}] character string: A message to be printed, if missing a default
message is used.

\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{.Deprecated("<new name>")} is called from deprecated
functions.  The original help page for these functions is often
available at \code{help("oldName-deprecated")} (note the quotes).
Functions should be listed in \code{help("pkg-deprecated")} for an
appropriate \code{pkg}, including \code{base}.
\end{Details}
\begin{SeeAlso}\relax
\code{\LinkA{Defunct}{Defunct}}

\code{\LinkA{base-deprecated}{base.Rdash.deprecated}} and so on which list the deprecated functions
in the packages.
\end{SeeAlso}

