Release 15.0.1-1

Author: eddelbuettel

ChangeLog

@@ -1,10 +1,12 @@
-2025-08-29  Dirk Eddelbuettel  <edd@debian.org>
+2025-09-01  Dirk Eddelbuettel  <edd@debian.org>
 
-	* DESCRIPTION (Version, Date): RcppArmadillo 15.0.1-1 (unreleased)
+	* DESCRIPTION (Version, Date): RcppArmadillo 15.0.1-1
         * inst/NEWS.Rd: Idem
         * configure.ac: Idem
         * configure: Idem
 
+2025-08-29  Dirk Eddelbuettel  <edd@debian.org>
+
 	* inst/include/RcppArmadillo/version/arma.h: Add version check logic
 	driven by user-select #define and compilation standard
 	* inst/include/RcppArmadillo.h: Ensure new header is included

DESCRIPTION

@@ -2,7 +2,7 @@ Package: RcppArmadillo
 Type: Package
 Title: 'Rcpp' Integration for the 'Armadillo' Templated Linear Algebra Library
 Version: 15.0.1-1
-Date: 2025-08-27
+Date: 2025-09-01
 Authors@R: c(person("Dirk", "Eddelbuettel", role = c("aut", "cre"), email = "edd@debian.org",
                     comment = c(ORCID = "0000-0001-6419-907X")),
              person("Romain", "Francois", role = "aut",
@@ -28,9 +28,11 @@ Description: 'Armadillo' is a templated C++ linear algebra library aiming toward
  .
  The 'RcppArmadillo' package includes the header files from the 'Armadillo' library;
  users do not need to install 'Armadillo' itself in order to use 'RcppArmadillo'.
- .
  Starting from release 15.0.0, the minimum compilation standard is C++14 so 'Armadillo'
  version 14.6.3 is included as a fallback when an R package forces the C++11 standard.
+ Package authors should set a '#define' to select the 'current' version, or select the
+ 'legacy' version (also chosen as default) if they must. See 'GitHub issue #475' for
+ details.
  .
  Since release 7.800.0, 'Armadillo' is licensed under Apache License 2; previous
  releases were under licensed as MPL 2.0 from version 3.800.0 onwards and LGPL-3

README.md

@@ -73,7 +73,8 @@ packages still impose C++11 as their compilation standard, the RcppArmadillo pac
 the final version allowing C++11, namely Armadillo 14.6.3, as a fallback used when C++11 compilation
 is detected. Conversion to and compilation under C++14 or later is encouraged. R [defaults to
 C++17](https://cran.r-project.org/doc/manuals/r-devel/R-exts.html#Portable-C-and-C_002b_002b-code-1)
-since version 4.3.0.
+since version 4.3.0. See [GitHub issue #475](https://github.com/RcppCore/RcppArmadillo/issues/475)
+for more about choosing between 'legacy' Armadillo 14.6.3 or 'current' Armadillo 15.0.1 or later.
 
 ### Documentation
 

inst/NEWS.Rd

@@ -3,14 +3,18 @@
 \newcommand{\ghpr}{\href{https://github.com/RcppCore/RcppArmadillo/pull/#1}{##1}}
 \newcommand{\ghit}{\href{https://github.com/RcppCore/RcppArmadillo/issues/#1}{##1}}
 
-\section{Changes in RcppArmadillo version 15.0.1-1 (2025-08-27) (unreleased)}{
+\section{Changes in RcppArmadillo version 15.0.1-1 (2025-09-01)}{
   \itemize{
     \item Upgraded to Armadillo release 15.0.1-1 (Medium Roast)
     \itemize{
       \item Workaround for GCC compiler bug involving misoptimisation of
       complex number multiplication
     }
-    \item Update DESCRIPTION and README.md
+    \item This version contains both 'legacy' and 'current' version of
+    Armadillo (see also below). Package authors should set a '#define' to
+    select the 'current' version, or select the 'legacy' version (also chosen
+    as default) if they must. See 'GitHub issue #475' for more details.
+    \item Updated DESCRIPTION and README.md
   }
 }
 
@@ -28,7 +32,7 @@
       \item Extended \code{conv()} and \code{conv2()} to accept the "valid"
       shape argument
     }
-    \item Also include Armadillo 14.6.3 as fallback for C++11 compilations
+    \item Also includes Armadillo 14.6.3 as fallback for C++11 compilations
     \item This new 'dual' setup had been rigorously tested with five interim
     pre-releases of which several received full reverse-dependency checks
   }