.Deprecated(new, package=NULL, deprecatedFunName=NULL)
sys.call(sys.parent))
will be used.
A call to
.Deprecated is typically added to
a function that is being deprecated.
By default, every call to a deprecated function that calls
.Deprecated
produces a warning message.
This can be controlled by the value of options("deprecated.warn").
Possible values are:
   -1 => no warning
    0 or NULL => always warn (the default)
    1 => warn only once in a session
This function emulates the R function
.Deprecated, but the S-PLUS version includes a new argument,
deprecatedFunName. Also, the option "deprecated.warn" controls the frequency of the
warning messages as described previously.
zlog <- function(x)
{
.Deprecated(new = "zslog", deprecatedFunName = "zlog")
sum(log(x))
}
zlog(1:5)
# [1] 4.787492
# Warning messages:
# 'zlog' is deprecated.
# Use 'zslog' instead.
# See help("Deprecated") in: zlog(1:5)