.Deprecated
Mark Functions as Deprecated, Defunct, or Not Yet Implemented

### Description

Warns when a function is due to be removed, has been removed, or is not yet added.

### Usage

    .Deprecated(new, package = NULL, msg, old = as.character(sys.call(sys.parent()))[1L])
    .Defunct(new, package = NULL, msg)
    .NotYetImplemented()

### Arguments

new | a character string. The name of a suggested replacement function.
package | a charactered string. The name of the package where help("package-deprecated") or help("package-defunct") conveys information on how to replace the old function with the new function.
msg | arbitrary arguments that are pasted together to form a message.
old | a character string. The name of the deprecated function. If not specified, the value of sys.call(sys.parent)) is used.

### Details

These functions are meant for package authors.

- When you plan to remove a function, add a call to .Deprecated. It warns the user that the function is going to be removed soon.
- When you remove a function, change the call from .Deprecated to .Defunct. It stops if the user tries to use the removed function.

Both .Deprecated and .Defunct should provide information recommending a replacement function or refer to a help file that provides an alternative function.
Use .NotYetImplemented for a function that is not yet available but that you plan to implement.
Value
.Deprecated returns the text of the warning message it makes. .Defunct and .NotYetImplemented call stop and hence return nothing.
See Also
warning, options.
Examples

    oldFun <- function(x)
    {
            .Deprecated(new = "newFun")
            sum(log(x))
    }
    olderFun <- function(x)
    {
            .Defunct(new = "newFun")
    }
    newFun <- function(x)
    {
            .NotYetImplemented()
    }
    ## Not run:
    oldFun(1:3)
    olderFun(1:3)
    newFun(1:3)

    ## End(Not run)

Package base version 6.1.5-18
Package Index