document changes and bump version

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: gratia
-Version: 0.8.2.58
-Date: 2024-02-02
+Version: 0.8.9.1
+Date: 2024-02-03
 Title: Graceful 'ggplot'-Based Graphics and Other Functions for GAMs Fitted Using 'mgcv'
 Authors@R: c(person(given = "Gavin L.", family = "Simpson",
                     email = "ucfagls@gmail.com",
@@ -59,7 +59,7 @@ LazyData: true
 URL: https://gavinsimpson.github.io/gratia/
 BugReports: https://github.com/gavinsimpson/gratia/issues
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.2.3
+RoxygenNote: 7.3.1
 Encoding: UTF-8
 VignetteBuilder: knitr
 Config/testthat/edition: 3

NEWS.md

@@ -1,4 +1,4 @@
-# gratia 0.8.2.58
+# gratia 0.8.9.1
 
 ## Breaking changes
 
@@ -22,6 +22,27 @@
   stores the data variables at which the derivatives were evaluated as columns
   in the object with their actual variable names.
 
+### Defunct and deprecated functions
+
+#### Defunct
+
+* `evaluate_smooth()` was deprecated in gratia version 0.7.0. This function and
+  all it's methods have been removed from the package. Use `smooth_estimates()`
+  instead.
+
+#### Deprecated functions
+
+The following functions were deprecated in version 0.9.0 of gratia. They will
+eventually be removed from the package as part of a clean up ahead of an
+eventual 1.0.0 release. These functions will become defunct by version 0.11.0 or
+1.0.0, whichever is released soonest.
+
+* `evaluate_parametric_term()` has been deprecated. Use `parametric_effects()`
+  instead.
+
+* `datagen()` has been deprecated. It never really did what it was originally
+  designed to do, and has been replaced by `data_slice()`.
+
 ## User visible changes
 
 * `smooth_samples()` now uses a single call to the RNG to generate draws from