Update docs

Author: hadley

R/mock.R

@@ -1,17 +1,11 @@
 #' Mock functions in a package.
 #'
 #' @description
-#' `with_mock()` and `local_mock()` are deprecated in favour of
-#' [with_mocked_bindings()] and [local_mocked_bindings()].
+#' `r lifecycle::badge("defunct")`
 #'
-#' These functions worked by using some C code to temporarily modify the mocked
-#'  function _in place_. This was an abuse of R's internals and it is no longer
-#' permitted.
-#'
-#' @section 3rd edition:
-#' `r lifecycle::badge("deprecated")`
-#'
-#' `with_mock()` and `local_mock()` are deprecated in the third edition.
+#' `with_mock()` and `local_mock()` are now defunct, and can be replaced by
+#' [with_mocked_bindings()] and [local_mocked_bindings()]. These functions only 
+#' worked by abusing of R's internals.
 #'
 #' @param ... named parameters redefine mocked functions, unnamed parameters
 #'   will be evaluated after mocking the functions
@@ -21,7 +15,6 @@
 #' @param .local_envir Environment in which to add exit handler.
 #'   For expert use only.
 #' @keywords internal
-#' @return The result of the last unnamed parameter
 #' @export
 with_mock <- function(..., .env = topenv()) {
   lifecycle::deprecate_stop("3.2.0", "with_mock()", "with_mocked_bindings()")