Remove deprecated loadRcppModules (closes #1415) (#1416)

* Remove deprecated loadRcppModules (closes #1415)

* Tweak ChangeLog whitespace following rebase following #1416 merge

* Remove section about deprecated loadRcppModules()

* Remove commented-out mentions of loadRcppModules()

Author: eddelbuettel

ChangeLog

@@ -1,3 +1,12 @@
+2025-12-02  Dirk Eddelbuettel  <[email protected]>
+
+	* R/loadRcppModules.R: Remove file with function deprecated years ago
+	* man/loadRcppModules-deprecated.Rd: Idem
+	* NAMESPACE: Remove reference to loadRcppModules()
+	* man/loadModule.Rd: Idem
+	* man/Rcpp-deprecated.Rd: Idem
+	* vignettes/rmd/Rcpp-modules.Rmd: Idem
+
 2025-12-01  Kevin Ushey <[email protected]>
 
 	* R/Attributes.R: Update OpenMP plugin for macOS

NAMESPACE

@@ -16,7 +16,6 @@ exportMethods(prompt, show, .DollarNames, initialize, "formals<-")
 export(Module,
        Rcpp.package.skeleton,
        populate,
-       loadRcppModules,  # deprecated since Rcpp 0.12.5 released May 2016
        setRcppClass,
        loadRcppClass,
        loadModule,

R/loadRcppModules.R

@@ -1,16 +1,7 @@
 
-## Up until R 2.15.0, the require("methods") is needed but (now)
-## triggers an warning from R CMD check
-#.onLoad <- function(libname, pkgname){
-#    #require("methods")  ## needed with R <= 2.15.0
-#    loadRcppModules()
-#}
-
-
-## For R 2.15.1 and later this also works. Note that calling loadModule() triggers
+## For R 2.15.1 and later the approach shown here works (as opposed to the now removed
+## and long-deprecated `loadRcppModules()`. Note that calling loadModule() triggers
 ## a load action, so this does not have to be placed in .onLoad() or evalqOnLoad().
 loadModule("NumEx", TRUE)
 loadModule("yada", TRUE)
 loadModule("stdVector", TRUE)
-
-

inst/skeleton/zzz.R

@@ -1,11 +1,6 @@
-#
-#.onLoad <- function(libname, pkgname){
-#    loadRcppModules()
-#}
-
-## For R 2.15.1 and later this also works. Note that calling loadModule() triggers
+## For R 2.15.1 and later the approach shown here works (as opposed to the now removed
+## and long-deprecated `loadRcppModules()`. Note that calling loadModule() triggers
 ## a load action, so this does not have to be placed in .onLoad() or evalqOnLoad().
 loadModule("RcppModuleNumEx", TRUE)
 loadModule("RcppModuleWorld", TRUE)
 loadModule("stdVector", TRUE)
-

inst/tinytest/testRcppModule/R/zzz.R

@@ -7,9 +7,6 @@
 }
 \details{
   \itemize{
-  \item \code{\link{loadRcppModules}} calls should now be replaced by
-  \code{\link{loadModule}} calls, one per Module.
-
   \item \code{\link{LdFlags}} and \code{\link{RcppLdFlags}} are no
   longer required as no library is provided (or needed) by Rcpp (as it
   was up until release 0.10.1).

man/Rcpp-deprecated.Rd

@@ -80,9 +80,6 @@ John Chambers
 }
 \seealso{
 \code{\link{setRcppClass}()} to avoid the explicit call.
-
-\code{\link{loadRcppModules}()} for a (deprecated) shotgun procedure to load all
-modules.
 }
 \examples{
 \dontrun{

man/loadModule.Rd

@@ -1236,36 +1236,6 @@ The `loadModule` function has an argument `what` to control which objects are
 exposed in the package namespace. The special value `TRUE` means that all
 objects are exposed.
 
-### Deprecated legacy method using loadRcppModules
-
-Prior to release 0.9.11, where `loadModule` was introduced,
-loading all functions and classes from a module
-into a package namespace was achieved using the `loadRcppModules` function
-within the `.onLoad` body.
-
-```{r, eval=FALSE}
-.onLoad <- function(libname, pkgname) {
-    loadRcppModules()
-}
-```
-
-This will look in the package's `DESCRIPTION` file for the `RcppModules`
-field, load each declared module and populate their contents into the
-package's namespace. For example, a package defining modules
-`yada`, `stdVector`, `NumEx` would have this declaration:
-
-```
-RcppModules: yada, stdVector, NumEx
-```
-
-The `loadRcppModules` function has a single argument `direct`
-with a default value of `TRUE`. With this default value, all content
-from the module is exposed directly in the package namespace. If set to
-`FALSE`, all content is exposed as components of the module.
-
-Note: This approach is **deprecated** as of Rcpp 0.12.5, and now triggers a
-warning message. Eventually this function will be withdrawn.
-
 ### Just expose the module
 
 Alternatively to exposing a module's content via `loadModule`,