RcppCore · eddelbuettel · Jul 19, 2025 · Jul 18, 2025 · Jul 18, 2025 · Jul 18, 2025
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 +1,16 @@
+2025-07-18  Dirk Eddelbuettel  <[email protected]>
+
+	* DESCRIPTION (Version, Date): Roll micro version and date
+	* inst/include/Rcpp/config.h: Idem
+
+	* R/asis.R (asisWeave, asisTangle): Borrowed with thanks from R.rsp
+	and shortened / simplified to provide 'asis' vignette processor
+	* R/zzz.R (.onLoad): Register new vignette processor
+	* vignettes/*.asis: New files with vignette info from .Rnw files
+	* vignettes/pdf/*.pdf: Moved to directory vignettes/
+	* vignettes/*.Rnw: Removed
+	* man/asisWeave.Rd: Documentation
+
 2025-07-01  Dirk Eddelbuettel  <[email protected]>
 
         * DESCRIPTION (Date, Version): Release 1.1.0

diff --git a/DESCRIPTION b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: Rcpp
 Title: Seamless R and C++ Integration
-Version: 1.1.0
-Date: 2025-07-01
+Version: 1.1.0.1
+Date: 2025-07-18
 Authors@R: c(person("Dirk", "Eddelbuettel", role = c("aut", "cre"), email = "[email protected]",
                     comment = c(ORCID = "0000-0001-6419-907X")),
              person("Romain", "Francois", role = "aut",
@@ -35,3 +35,4 @@ BugReports: https://github.com/RcppCore/Rcpp/issues
 MailingList: [email protected]
 RoxygenNote: 6.1.1
 Encoding: UTF-8
+VignetteBuilder: Rcpp
diff --git a/NAMESPACE b/NAMESPACE
@@ -33,8 +33,7 @@ export(Module,
        cpp_object_initializer,
        cpp_object_dummy,
        Rcpp.plugin.maker,
-       getRcppVersion
-       )
+       getRcppVersion)
 S3method(print, bytes)
 S3method(format, Rcpp_stack_trace)
 S3method(str, Rcpp_stack_trace)

diff --git a/R/asis.R b/R/asis.R
@@ -0,0 +1,56 @@
+## These two functions are borrowed with grateful appreciation from the R.rsp package
+## by Henrik Bengtsson licensend under LPGL (>= 2.1) and somewhat simplified / shortened
+## feature-reduced here. Please the R.rsp for a full-featured version and documentation
+
+##' Simple \sQuote{asis} Vignette Processor
+##'
+##' To pass pre-made pdf vignette vignettes through \dQuote{as is}, a simple vignette
+##' process is added. It is derived from the more feature-complete one in the \pkg{R.rsp}
+##' package. To use it, add files named like the pdf file plus an appended \code{.asis}
+##' with the vignette metainformation and register the vignette processor, see the examples.
+##'
+##' @title Process pdf vignettes \sQuote{asis}
+##' @name asisWeave
+##' @param file character Filename to be processed
+##' @param ... dots Currently ignored
+##' @param pattern character A regular expression describing the filename pattern
+##' @return The respective filename is returned, invisibly
+##' @author Henrik Bengtsson for the original versions in package \pkg{R.rsp},
+##' Dirk Eddelbuettel for the shortened ones used here
+##' @examples
+##' # To register this vignette engine in another package, add
+##' # \code{VignetteBuilder: Rcpp} as well as \code{Suggests: Rcpp} to \code{DESCRIPTON}
+##' # which uses the registration this package provides via
+##' \dontrun{tools::vignetteEngine("asis", package = pkgname, pattern = "[.](pdf|html)[.]asis$",
+##'                                weave = asisWeave, tangle = asisTangle)}
+##'
+##' # Use a .asis file as in the Rcpp package, for example Rcpp-FAQ.pdf.asis has these lines:
+##' #   %\VignetteIndexEntry{Rcpp-FAQ}
+##' #   %\VignetteKeywords{Rcpp, FAQ, R, Cpp}
+##' #   %\VignettePackage{Rcpp}
+##' #   %\VignetteEncoding{UTF-8}
+##' #   %\VignetteEngine{Rcpp::asis}
+asisWeave <- function (file, ...) {
+    output <- tools::file_path_sans_ext(basename(file))
+    if (!file.exists(output)) {
+        outputS <- file.path("..", "inst", "doc", output)
+        if (file.exists(outputS)) {
+            file.copy(outputS, output, overwrite = TRUE)
+            output <- outputS
+        } else {
+            stop("No file to process", call. = FALSE)
+        }
+    }
+    Sys.setFileTime(output, time = Sys.time())
+    invisible(output)
+}
+
+##' @rdname asisWeave
+asisTangle <- function (file, ..., pattern = "(|[.][^.]*)[.]asis$") {
+    workdir <- "."
+    filename <- basename(file)
+    fullname <- gsub(pattern, "", filename)
+    filenameR <- sprintf("%s.R", fullname)
+    cat(sprintf("### This is an R script tangled from '%s'\n", filename), file = filenameR)
+    invisible(filenameR)
+}
diff --git a/R/zzz.R b/R/zzz.R
@@ -1,4 +1,4 @@
-# Copyright (C) 2009 - 2016  Dirk Eddelbuettel and Romain Francois
+# Copyright (C) 2009 - 2025  Dirk Eddelbuettel and Romain Francois
 #
 # This file is part of Rcpp.
 #
@@ -20,7 +20,8 @@
 .classes_map <- new.env()
 
 .onLoad <- function(libname, pkgname){
-    new_dummyObject(.dummyInstancePointer)   # nocov
-}
-
+    new_dummyObject(.dummyInstancePointer)   						# nocov start
 
+    tools::vignetteEngine("asis", package = pkgname, pattern = "[.](pdf|html)[.]asis$",
+                          weave = asisWeave, tangle = asisTangle)	# nocov end
+}
diff --git a/inst/NEWS.Rd b/inst/NEWS.Rd
@@ -3,6 +3,16 @@
 \newcommand{\ghpr}{\href{https://github.com/RcppCore/Rcpp/pull/#1}{##1}}
 \newcommand{\ghit}{\href{https://github.com/RcppCore/Rcpp/issues/#1}{##1}}
 
+\section{Changes in Rcpp release version 1.1.1 (2026-01-xx)}{
+  \itemize{
+    \item Changes in Rcpp Documentation:
+    \itemize{
+      \item Vignettes are now processed via a new "asis" processor adopted
+      from \pkg{R.rsp} (Dirk in \ghpr{1394} fixing \ghit{1393})
+    }
+  }
+}
+
 \section{Changes in Rcpp release version 1.1.0 (2025-07-01)}{
   \itemize{
     \item Changes in Rcpp API:

diff --git a/inst/include/Rcpp/config.h b/inst/include/Rcpp/config.h
@@ -31,7 +31,7 @@
 #define RCPP_VERSION_STRING     "1.1.0"
 
 // the current source snapshot (using four components, if a fifth is used in DESCRIPTION we ignore it)
-#define RCPP_DEV_VERSION        RcppDevVersion(1,1,0,0)
-#define RCPP_DEV_VERSION_STRING "1.1.0.0"
+#define RCPP_DEV_VERSION        RcppDevVersion(1,1,0,1)
+#define RCPP_DEV_VERSION_STRING "1.1.0.1"
 
 #endif
diff --git a/man/asisWeave.Rd b/man/asisWeave.Rd
diff --git a/man/compilerCheck.Rd b/man/compilerCheck.Rd
diff --git a/vignettes/Rcpp-FAQ.Rnw b/vignettes/Rcpp-FAQ.Rnw
diff --git a/vignettes/Rcpp-FAQ.pdf b/vignettes/Rcpp-FAQ.pdf
diff --git a/vignettes/Rcpp-FAQ.pdf.asis b/vignettes/Rcpp-FAQ.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-FAQ}
+%\VignetteKeywords{Rcpp, FAQ, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-attributes.Rnw b/vignettes/Rcpp-attributes.Rnw
diff --git a/vignettes/Rcpp-attributes.pdf b/vignettes/Rcpp-attributes.pdf
diff --git a/vignettes/Rcpp-attributes.pdf.asis b/vignettes/Rcpp-attributes.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-attributes}
+%\VignetteKeywords{Rcpp, attributes, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-extending.Rnw b/vignettes/Rcpp-extending.Rnw
diff --git a/vignettes/Rcpp-extending.pdf b/vignettes/Rcpp-extending.pdf
diff --git a/vignettes/Rcpp-extending.pdf.asis b/vignettes/Rcpp-extending.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-extending}
+%\VignetteKeywords{Rcpp, extending, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-introduction.Rnw b/vignettes/Rcpp-introduction.Rnw
diff --git a/vignettes/Rcpp-introduction.pdf b/vignettes/Rcpp-introduction.pdf
diff --git a/vignettes/Rcpp-introduction.pdf.asis b/vignettes/Rcpp-introduction.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-introduction}
+%\VignetteKeywords{Rcpp, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-jss-2011.pdf b/vignettes/Rcpp-jss-2011.pdf
diff --git a/vignettes/Rcpp-jss-2011.Rnw → vignettes/Rcpp-jss-2011.pdf.asis b/vignettes/Rcpp-jss-2011.Rnw → vignettes/Rcpp-jss-2011.pdf.asis
@@ -1,11 +1,5 @@
-\documentclass{article}
-\usepackage{pdfpages}
 %\VignetteIndexEntry{Rcpp-JSS-2011}
 %\VignetteKeywords{Rcpp, foreign function interface, .Call, C++, R}
 %\VignettePackage{Rcpp}
 %\VignetteEncoding{UTF-8}
-
-\begin{document}
-\includepdf[pages=-, fitpaper=true]{pdf/Rcpp-jss-2011.pdf}
-\end{document}
-
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-libraries.Rnw b/vignettes/Rcpp-libraries.Rnw
diff --git a/vignettes/Rcpp-libraries.pdf b/vignettes/Rcpp-libraries.pdf
diff --git a/vignettes/Rcpp-libraries.pdf.asis b/vignettes/Rcpp-libraries.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-libraries}
+%\VignetteKeywords{Rcpp, Package, Library}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-modules.Rnw b/vignettes/Rcpp-modules.Rnw
diff --git a/vignettes/Rcpp-modules.pdf b/vignettes/Rcpp-modules.pdf
diff --git a/vignettes/Rcpp-modules.pdf.asis b/vignettes/Rcpp-modules.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-modules}
+%\VignetteKeywords{Rcpp, modules, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-package.Rnw b/vignettes/Rcpp-package.Rnw
diff --git a/vignettes/Rcpp-package.pdf b/vignettes/Rcpp-package.pdf
diff --git a/vignettes/Rcpp-package.pdf.asis b/vignettes/Rcpp-package.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-package}
+%\VignetteKeywords{Rcpp, package, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-quickref.Rnw b/vignettes/Rcpp-quickref.Rnw
diff --git a/vignettes/Rcpp-quickref.pdf b/vignettes/Rcpp-quickref.pdf
diff --git a/vignettes/Rcpp-quickref.pdf.asis b/vignettes/Rcpp-quickref.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-quickref}
+%\VignetteKeywords{Rcpp, quickref, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/Rcpp-sugar.Rnw b/vignettes/Rcpp-sugar.Rnw
diff --git a/vignettes/Rcpp-sugar.pdf b/vignettes/Rcpp-sugar.pdf
diff --git a/vignettes/Rcpp-sugar.pdf.asis b/vignettes/Rcpp-sugar.pdf.asis
@@ -0,0 +1,5 @@
+%\VignetteIndexEntry{Rcpp-sugar}
+%\VignetteKeywords{Rcpp, sugar, R, Cpp}
+%\VignettePackage{Rcpp}
+%\VignetteEncoding{UTF-8}
+%\VignetteEngine{Rcpp::asis}
diff --git a/vignettes/pdf/Rcpp-FAQ.pdf b/vignettes/pdf/Rcpp-FAQ.pdf
diff --git a/vignettes/pdf/Rcpp-attributes.pdf b/vignettes/pdf/Rcpp-attributes.pdf
diff --git a/vignettes/pdf/Rcpp-extending.pdf b/vignettes/pdf/Rcpp-extending.pdf
diff --git a/vignettes/pdf/Rcpp-introduction.pdf b/vignettes/pdf/Rcpp-introduction.pdf
diff --git a/vignettes/pdf/Rcpp-jss-2011.pdf b/vignettes/pdf/Rcpp-jss-2011.pdf
diff --git a/vignettes/pdf/Rcpp-libraries.pdf b/vignettes/pdf/Rcpp-libraries.pdf
diff --git a/vignettes/pdf/Rcpp-modules.pdf b/vignettes/pdf/Rcpp-modules.pdf
diff --git a/vignettes/pdf/Rcpp-package.pdf b/vignettes/pdf/Rcpp-package.pdf
diff --git a/vignettes/pdf/Rcpp-quickref.pdf b/vignettes/pdf/Rcpp-quickref.pdf
diff --git a/vignettes/pdf/Rcpp-sugar.pdf b/vignettes/pdf/Rcpp-sugar.pdf
diff --git a/vignettes/rmd/Makefile b/vignettes/rmd/Makefile
@@ -7,7 +7,7 @@ rmdvignettes := 	$(rmdsources:.Rmd=.pdf)
 %.pdf:			%.Rmd
 			Rscript -e 'rmarkdown::render("$<")'
 			Rscript -e 'tools::compactPDF("$@", gs_quality="ebook")'
-			cp -vax $@ ../pdf
+			cp -vax $@ ..
 
 all:			${rmdvignettes} Rcpp-jss-2011.pdf
 
@@ -19,7 +19,7 @@ Rcpp-jss-2011.pdf:	Rcpp-jss-2011.tex
 			bibtex Rcpp-jss-2011.aux
 			Rscript -e 'tools::texi2pdf("$<", texi2dvi="pdflatex")'
 			Rscript -e 'tools::compactPDF("$@", gs_quality="ebook")'
-			cp -vax $@ ../pdf
+			cp -vax $@ ..
 
 clean:
 			@rm -rf *.aux *.log *.out *.toc *.tex *.pdf Rcpp-introduction_cache Rcpp-libraries_cache pinp.cls Rcpp-jss-2011.bbl Rcpp-jss-2011.blg auto