% File src/library/base/man/Defunct.Rd
% Part of the R package, https://www.R-project.org
% Copyright 1995-2007 R Core Team
% Distributed under GPL 2 or later

\name{Defunct}
\title{Marking Objects as Defunct}
\alias{Defunct}
\alias{.Defunct}
\alias{defunct}

\description{
  When a function is removed from \R it should be replaced by a function
  which calls \code{.Defunct}.
}
\usage{
.Defunct(new, package = NULL, msg)
}
\arguments{
  \item{new}{
    character string: A suggestion for a replacement function.
  }
  \item{package}{
    character string: The package to be used when suggesting where the
    defunct function might be listed.
  }
  \item{msg}{
    character string: A message to be printed, if missing a default
    message is used.
  }
}
\details{
  \code{.Defunct} is called from defunct functions.
  These should be listed in \code{help("\var{pkg}-defunct")}
  for an appropriate \var{pkg}, including \pkg{base}.
  The alias of the defunct function is added to the same file.

  \code{.Defunct} signals an error of class \code{"defunctError"}
  with fields \code{old}, \code{new}, and \code{package}.
}
\seealso{
  \code{\link{Deprecated}}.

  \code{help("\link{base-defunct}")} and so on which list the defunct
  functions in the packages.
}
\keyword{documentation}
\keyword{utilities}
