R 4.5.0 Release Notes and Features
R 4.5.0 Release Notes and Features
0 (2025-04-11 ucrt)
NEWS R News
CHANGES IN R 4.5.0
NEW FEATURES:
• [Link](rl) and hence [Link](rl) now work for a list of raw(1) elements, as
proposed by Michael Chirico’s PR#18696.
• graphics’ grid() gains optional argument nintLog.
• New functions check_package_urls() and check_package_dois() in package tools
for checking URLs and DOIs in package sources.
• New head() and tail() methods for class "ts" time series, proposed by Spencer
Graves on R-devel.
• New [Link]() function, a “bare bones” interface to the [Link]() leave-
one-out diagnostics computations; wished for in PR#18739.
• Package citation() results auto-generated from the package metadata now also pro-
vide package DOIs for CRAN and Bioconductor packages.
• New function grepv() identical to grep() except for the default value = TRUE.
• methods(<pkg>:::<genfun>) now does report methods when neither the generic nor
the methods have been exported.
• pdf() gains an author argument to set the corresponding metadata field, and logi-
cal arguments timestamp and producer to optionally omit the respective metadata.
(Thanks to Edzer Pebesma.)
• grDevices::glyphInfo() gains a rot argument to allow per-glyph rotation. (Thanks
to Daniel Sabanes Bove.)
• Package tools now exports functions CRAN_current_db(), CRAN_aliases_db(),
CRAN_rdxrefs_db(), CRAN_archive_db(), and CRAN_authors_db().
• Package tools now exports functions R() and parse_URI_reference().
• Package tools now exports functions base_aliases_db() and base_rdxrefs_db().
• It is now possible to set the background color for row and column names in the data
editor on Windows (Rgui).
1
2 NEWS
• [Link](from, to, by, ....) when |by| = 1 now behaves as if by was omitted, and
hence returns from:to, possibly integer.
• [Link](from, to, by, ....) and [Link](..) now also work when from is
missing and sufficient further arguments are provided, thanks to Michael Chirico’s
report, patch proposal in PR#17672 and ‘R Dev Day’ contributions.
The Date method also works for seq(from, to), when by is missing and now defaults
to "1 days".
It is now documented (and tested) that the by string may be abbreviated in both seq
methods.
Both methods return or keep internal type "integer" more consistently now. Also,
[Link]({}) is internally integer.
• duplicated(), unique(), and anyDuplicated() now also work for class expression
vectors.
• New function use() to use packages in R scripts with full control over what gets
added to the search path. (Actually already available since R 4.4.0.)
• There is some support for zstd compression of tarballs in tar() and untar(). (This
depends on OS support of libzstd or by tar.)
• print(summary(<numbers>)) gets new optional argument zdigits to allow more
flexible and consistent (double) rounding. The current default zdigits = 4L is some-
what experimental. Specifying both digits = *, zdigits = * allows behaviour in-
dependent of the global digits option.
• The format() method for "difftime" objects gets a new back compatible option
[Link].
• A summary() method for "difftime" objects which prints nicely, similar to those for
"Date" and "POSIXct".
• unique()’s default method now also deals with "difftime" objects.
• optimize(f, *) when f(x) is not finite says more about the value in its warning
message. It no longer replaces -Inf by the largest positive finite number.
• The documentation of gamma() and [Link]() is more specific, thanks to the
contributors of PR#18677.
• New dataset gait thanks to Heather Turner and Ella Kaye, used in examples.
• New datasets penguins and penguins_raw thanks to Ella Kaye, Heather Turner, and
Kristen Gorman.
• isSymmetric(<matrix>) gains a new option trans = "C"; when set to non-default,
it tests for “simple” symmetry of complex matrices.
• [Link]() produces more informative error messages in some cases when vari-
ables in the formula are not found, thanks to Ben Bolker’s PR#18860.
• selectMethod(f, ..) now keeps the function name if the function belongs to a group
generic and the method is for the generic.
• This update was mainly bug fixes but contained a barely documented major change.
The set of BLAS routines had been unchanged since 1988, so throughout R’s history.
This update introduced new BLAS routines dgemmtr and zgemmtr which are now
used by LAPACK routines. This means that BLAS implementations are no longer
interchangeable.
• To work around this, R can be configured with option ‘--with-2025blas’ which
arranges for the 2025 BLAS additions to be compiled into libRlapack (the internal
LAPACK, not built if an external LAPACK is used).
This option allows the continuation of the practice of swapping the BLAS in use by
symlinking ‘lib/libRblas.*’. It has the disadvantage of using the reference BLAS
version of the 2025 routines whereas an enhanced BLAS might have an optimized
version (OpenBLAS does as from version 0.3.29).
• Windows builds currently use the internal LAPACK and by default the in-
ternal BLAS: notes on how to swap the latter via ‘[Link]’ are in file
‘src/extra/blas/[Link]’.
INSTALLATION on a UNIX-ALIKE:
• A C23 compiler (if available) is now selected by default for compilation of R and
packages. R builds can opt out via the configure flag ‘--without-C23’, unless the
specified or default (usually gcc) compiler defaults to C23: gcc 15 will.
A C23 compiler is known to be selected with gcc 13–15, LLVM clang 18–20 (and 15
should), Apple clang 15–17 and Intel 2024.2–2025.0 (and 2022.2 should).
Current binary distributions on macOS use Apple clang 14 and so do not use C23.
• The minimum autoconf requirement for a maintainer build has been increased to
autoconf 2.72.
• Building the HTML and Info versions of the R manuals now requires texi2any from
Texinfo 6.1 or later.
• Failures in building the manuals under ‘doc’ now abort the installation, removing any
file which caused the failure.
• Control of symbol visibility is now supported on macOS (the previous check only
worked on ELF platforms).
• There is now support for installing the debug symbols for recommended packages on
macOS: see ‘REC_INSTALL_OPT’ in file ‘[Link]’.
• configure is now able to find an external libintl on macOS (the code from an
older GNU gettext distribution failed to try linking with the macOS Core Foundation
framework).
INSTALLATION on WINDOWS:
• Both building R and installing packages use the C compiler in C23 mode.
• R on Windows by default uses pkg-config for linking against external libraries. This
makes it easier to test R and packages with alternative toolchains (such as from Msys2,
e.g., testing with LLVM and possibly with sanitizers). It also allows more significant
Rtools updates within a single R minor release.
• The installer scripts for Windows have been tailored to Rtools45, an update of the
Rtools44 toolchain. It is based on GCC 14. The experimental support for 64-bit
ARM (aarch64) CPUs is based on LLVM 19. R-devel and R 4.5.x are no longer
maintained to be buildable using Rtools44 and it is advised to switch to Rtools45.
NEWS 5
PACKAGE INSTALLATION:
• Packages are now installed using C23 where supported by the OS and R build.
Packages using R’s compiler settings can ask not to use C23 via including USE_C17
in SystemRequirements or can be installed by R CMD INSTALL --use-C17. (Some
packages ignore these settings in their configure script or when compiling in sub-
directories of ‘src’, as will those using a ‘src/Makefile’.)
• Source installs now report the package version in the log.
• There is preliminary support for C++26 with GCC >= 14, Apple clang++ >= 16
and LLVM clang++ >= 17.
C-LEVEL FACILITIES:
• The non-API and hidden entry points Rf_setIVector, Rf_setRVector and
Rf_setSVector have been removed.
• The internal code for changing the parent of an environment now signals an error if
the new parent is not an environment or if the change would create a cycle in the
parent chain.
• SET_TYPEOF now signals an error unless the old and new types have compatible mem-
ory structure and content. Use of SET_TYPE in package C code should be avoided and
may be deprecated in the near future. It is better to allocate an object of the desired
type in the first place.
• The set of LAPACK (double and complex) routines declared in the headers
‘R_ext/Lapack.h’ and ‘R_ext/Applic.h’ has been extended, mostly to routines ac-
tually in use by packages.
• Memory allocation messages now use the (non-SI notation) "Mb", "Gb" , . . . , and
"Mbytes" strings as arguments instead of as part of the (translatable format) string.
This is one step for PR#18297; from Henrik Bengtsson.
• Header ‘R_ext/Constants.h’ (included by ‘R.h’) now always includes header
‘float.h’ or ‘cfloat’ for constants such as DBL_MAX.
6 NEWS
• Strict R headers are now the default. This removes the legacy definitions of PI,
Calloc, Realloc and Free: use M_PI, R_Calloc, R_Realloc or R_Free instead.
• The deprecated and seemingly never-used S-compatibility macros F77_COM and
F77_COMDECL have been removed from header ‘R_ext/RS.h’.
• The enum Rboolean defined in header ‘R_ext/Boolean.h’ now has a fixed underlying
type of int on platforms whose C compiler supports this.
This is a C23 feature (taken from C++11) and also supported in all C standards by
some versions of clang (from LLVM and Apple) and (with a warning when using
‘-pedantic’) by GCC when in C17 mode.
A fair amount of code has assumed this: it may be changed to a smaller type in
future. In particular, as standard compilers do not check the validity of assignment
to an enum, it has been possible to assign NA_INTEGER to an Rboolean variable, coerce
it to int and recover the value.
If there were a platform which used an underlying type of a different size this would
be an ABI-breaking change (but we are unaware of any such platform).
• Header ‘R_ext/Boolean.h’ now ensures that a bool type is available either as a
keyword (C23 and C++) or by including the C99 header ‘stdbool.h’. This is being
used internally in R to replace Rboolean by bool.
• There are new functions asRboolean and asBool, variants of asLogical more suited
to converting logical arguments to Rboolean or to bool. They require a length-one
input and throw an error if that evaluates to NA.
• Header ‘R_exts/Error.h’ now ensures that Rf_error and similar are given a
noreturn attribute when used from C++ under all compilers.
• Header ‘R_exts/Utils.h’ no longer contains a declaration for F77_SUB(interv).
This is intended to be called from Fortran and was wrongly declared: LOGICAL in
Fortran corresponds to int * not Rboolean *.
• Defining R_INCLUDE_BOOLEAN_H to 0 before including headers ‘R.h’ or ‘Rinternals.h’
(or any other header which includes ‘R_ext/Boolean.h’) stops the inclusion of header
R_ext/Boolean.h which ‘defines’ constants TRUE, FALSE, true, false and the type
bool which some package maintainers wish to avoid.
Note that the last three are keywords in C23 and C++11 so cannot be avoided
entirely. However, with commonly-used compilers they can be masked by a macro of
the same name, often with a warning.
C-LEVEL API:
• The ‘Writing R Extensions’ Texinfo source now contains very experimental annota-
tions for more clearly identifying the API status of C entry points. These annotations
are used to produce indices for API, experimental API, and embedded API entry
points in the rendered versions. This is very preliminary and may be dropped if a
better approach emerges.
Also for Fortran-callable entry points which are part of the API.
• ‘Writing R Extensions’ has a new section ‘Moving into C API compliance’ to help
package authors move away from using non-API endpoints. This section will continue
to be updated as work on clarifying and tightening the C API continues.
• New API function R_mkClosure. This checks that its arguments are valid and should
be used instead of allocSExp(CLOSXP followed by SET_FORMALS, SET_BODY, and
SET_CLOENV.
NEWS 7
UTILITIES:
• R CMD INSTALL (and hence check) now compile C++ code with -DR_NO_REMAP.
‘Writing R Extensions’ has been revised to describe the remapped entry points, for
with the Rf_ prefix remains optional when used from C code (but is recommended
for new C code).
• R CMD check --as-cran notes bad parts in the ‘DESCRIPTION’ file’s URL fields.
• R CMD check now reports more warnings on long-deprecated/obsolete Fortran features
reported by gfortran -Wall. For hints on how to modernize these, see https://
[Link]/fortran/show/Modernizing+Old+Fortran.
• Since almost all supported R versions now use UTF-8, R CMD check no longer by
default reports on marked UTF-8 or Latin-1 strings in character data. Set environ-
ment variable _R_CHECK_PACKAGE_DATASETS_SUPPRESS_NOTES_ to a false value for
the previous behaviour.
• tools::checkDocFiles() notes more cases of usage documentation without corre-
sponding \alias.
• R CMD check with a true value for environment variable _R_CHECK_BASHISMS_ checks
more thoroughly, including for bash scripts and bashisms in components of autoconf-
generated configure scripts.
• R CMD check gains option ‘--run-demo’ to check demo scripts analogously to tests.
This includes a check for undeclared package dependencies: it can also be enabled
separately by setting the environment variable _R_CHECK_PACKAGES_USED_IN_DEMO_
to a true value (as done by R CMD check --as-cran).
8 NEWS
BUG FIXES:
• update_pkg_po() now copies ‘.mo’ files to the translation package even if a
‘DESCRIPTION’ file exists, thanks to Michael Chirico fixing PR#18694.
• Auto-generated citation() entries no longer include (additional) URLs in the ‘note’
field (PR#18547).
• [Link]() gets a new option [Link] and now preserves NA names,
thus fixing the format() method for data frames, and also bug PR#18745. Relatedly,
the format() method gets an option [Link].
• stem() formats correctly also in cases where rounding up, e.g., from 9.96 to 10 needs
more digits; thanks to Ella Kaye and Kelly Bodwin, fixing PR#8934 during ‘R Dev
Day’ at useR!2024.
Additionally, stem(x) now works normally also when length(x) == 1.
• tools’ toTitleCase() now works better, fixing PR#18674, thanks to Shannon Pileggi,
Sarah Zeller, Reiko Okamoto, and Hugo Gruson’s ‘R Dev Day’ effort.
• Printing matrices (typically with many rows and or columns) now also omits columns
when desirable according to option [Link], or argument max, respectively. This is
primarily the work of Lorena Abad, Ekaterina Akimova, Hanne Oberman, Abhishek
Ulayil, and Lionel Henry at the ‘R Dev Day’, thus fixing PR#15027.
• [Link]() now warns about some failures to change the language.
• Printing [Link]() now shows "<missing>" even when R’s language setting is not
English.
• xyTable() now handles and reports NAs fixing PR#18654. Thanks to Heather Turner
and Zhian Kamvar for report and patch.
• as(*, "raw") now works as documented, thanks to Mikael Jagan’s PR#18795.
• Informational messages of e.g., print(1:1e4, max=1000), now correctly mention max
in addition to getOption("[Link]").
• rowSums(A, dims = dd), colMeans(..), etc, give a more helpful error message when
dd is not of length one, thanks to Michael Chirico’s PR#18811.
• [Link]() no longer explicitly coerces results from integer to double, analogously
with [Link](), [Link]() and [Link](), resolving a modified PR#18782.
• axisTicks(usr, ...) documentation clarification for log = TRUE, fixing bug
PR#18821 thanks to Duncan Murdoch.
• debug() and debugonce(fun) now also accept a string fun when it names an S4
generic, fixing PR#18822 thanks to Mikael Jagan.
• debugonce(<S4-simple-body>, signature=*) now works correctly when “called
twice”, fixing PR#18824 thanks to Mikael Jagan.
NEWS 9
CHANGES IN R 4.4.3
INSTALLATION:
• R can be installed using C23 (for example with ‘-std=gnu23’ or ‘-std=gnu2x’) with
recent compilers including gcc 12–14, Apple clang 15–16, LLVM clang 17–20 and
Intel icx 2024.2.
It can be installed with the upcoming (at the time of writing) gcc 15, which defaults
to C23.
C-LEVEL FACILITIES:
• The functions R_strtod and R_atof now allow hexadecimal constants without an
exponent, for compatibility with their C99 versions (PR#18805).
UTILITIES:
• R CMD build and R CMD check now allow reference output for demo scripts
(‘demo/[Link]’ files) to be shipped with the package, as proposed by
Torsten Hothorn in PR#18816.
BUG FIXES:
• kappa(A, exact=TRUE) for singular A returns Inf more generally, fixing PR#18817
reported by Mikael Jagan.
• Fixed URLs of the sun spots ([Link] etc) data sets and mention future
changes due to recalibration.
• The parser now accepts hexadecimal constants with a decimal point without an ex-
ponent (taken as p0) as documented in ?NumericConstants (PR#18819).
• rbind() now works correctly when inputs include a raw vector and a logical, integer
or double vector – previously the inclusion of the latter was garbled.
NEWS 11
CHANGES IN R 4.4.2
C-LEVEL FACILITIES:
• The S-compatibility macros F77_COM and F77_COMDECL defined in header
‘R_ext/RS.h’ are deprecated and will be removed shortly. We could find no record of
their use.
BUG FIXES:
• Mathlib function lgammacor(x) no longer warns about underflow to zero for large x.
• Text widths and heights were incorrectly reported by the Quartz device if the drawing
context didn’t exist yet (typically when drawing off-screen to a window that is yet to
appear, see PR#18591).
• The Quartz device could segfault in cases where paths with spaces are used in the
new glyph drawing API. Thanks to Tomek Gieorgijewski (PR#18758).
• On macOS in R CRAN builds, it is again possible to read little-endian UTF-16 text
with a BOM from a connection using encoding="UTF-16". Users building R from
source should avoid using the system libiconv in macOS 14.1 and later.
• methods’ internal .requirePackage() now re-enables primitive method dispatch
when needed; thanks to Ivan Krylov for demystifying CRAN package check failures
on the R-devel mailing list.
12 NEWS
CHANGES IN R 4.4.1
C-LEVEL FACILITIES:
• Functions R_atof and R_strtod declared in header ‘R_ext/Utils.h’ are now docu-
mented in ‘Writing R Extensions’ and so formally part of the API.
• The non-API entry points Rf_setSVector, Rf_StringFalse, Rf_StringTrue and
Rf_isBlankString have been added to those reported by R CMD check.
• The new function Rf_allocLang is now available. This provides an alternative to the
idiom of calling Rf_allocList followed by SET_TYPEOF.
UTILITIES:
• R CMD check now reports as warnings what gfortran calls ‘Fortran 2018 deleted
features’, all of which have long been marked as ‘obsolescent’ and some of which were
deleted in Fortran 2008 or earlier. Fortran compilers are no longer required to support
these.
BUG FIXES:
• [Link](), scan(), [Link]() and other places which use the internal
C function R_strtod now require a non-empty digit sequence in a decimal or bi-
nary exponent. This aligns with the C/POSIX standard for strtod and with
?NumericConstants.
• [Link](m, [Link]=NA) now works correctly for a matrix m with NA’s in
row names.
• The error message from <POSIXlt>[["hour"]] and similar now mentions *[[,
"hour"]], as wished for in PR#17409 and proposed by Michael Chirico.
• qbinom() and potentially qpois(), qnbinom(), no longer sometimes fail accurate
inversion (of pbinom(), etc), thanks to Christopher Chang’s report and patch in
PR#18711.
• The internal help server on Windows can again serve requests sent in quick succession,
fixing a regression in R 4.4.0.
• debugcall(S3Generic()) now also works when a corresponding S4-generic version is
in the methods cache (PR#18143).
• Package tools’ toTitleCase(ch0) now returns character(0) when ch0 is of zero
length; fixing PR#18724, reported by David Hugh Jones.
• R CMD check is no longer broken (without a check result and no explanation
in ‘[Link]’) for a package which declares an invalid VignetteBuilder in
‘DESCRIPTION’ but has no vignettes.
CHANGES IN R 4.4.0
SIGNIFICANT USER-VISIBLE CHANGES:
• Startup banners, R --version, sessionInfo() and R CMD check no longer report
(64-bit) as part of the platform as this is almost universal – the increasingly rare
32-bit platforms will still report (32-bit).
On Windows, ditto for window titles.
NEWS 13
NEW FEATURES:
• The confint() methods for "glm" and "nls" objects have been copied to the
stats package. Previously, they were stubs which called versions in package MASS.
The MASS namespace is no longer loaded if you invoke (say) confint(glmfit).
Further, the "glm" method for profile() and the plot() and pairs() methods
for class "profile" have been copied from MASS to stats. ([Link]() and
[Link]() were already in stats.)
• The confint() and profile methods for "glm" objects have gained a possibility to
do profiling based on the Rao Score statistic in addition to the default Likelihood
Ratio. This is controlled by a new test = argument.
• The pairs() method for "profile" objects has been extended with a which = argu-
ment to allow plotting only a subset of the parameters.
• The "glm" method for anova() computes test statistics and p-values by default, using
a chi-squared test or an F test depending on whether the dispersion is fixed or free.
Test statistics can be suppressed by giving argument test a false logical value.
• In setRepositories() the repositories can be set using their names via name = in-
stead of index ind =.
• methods() and .S3methods() gain a [Link] option for the (rare) case where
functions starting with a ‘.’ should be included.
• Serializations can now be interrupted (e.g., by Ctrl-C on a Unix-alike) if they take
too long, e.g., from [Link](), thanks to suggestions by Ivan Krylov and others
on R-devel.
• New startup option ‘--max-connections’ to set the maximum number of simultane-
ous connections for the session. Defaults to 128 as before: allowed values up to 4096
(but resource limits may in practice restrict to smaller values).
• R on Windows (since Windows 10 2004) now uses the new Segment Heap allocator.
This may improve performance of some memory-intensive applications.
• When R packages are built, typically by R CMD build <pkg>, the new
--user=<build_user> option overrides the (internally determined) user name, cur-
rently [Link]()["user"] or LOGNAME. This is a (modified) fulfillment of Will Lan-
dau’s suggestion in PR#17530.
• tools::testInstalledBasic() gets new optional arguments outDir and
testSrcdir, e.g., allowing to use it in a builddir != srcdir setup, and in stan-
dard “binary” Windows installation if a source ‘tests/’ folder is present.
• range(<DT_with_Inf>, finite = TRUE) now work for objects of class "Date",
"POSIXct", and "POSIXlt" with infinite entries, analogously to [Link](),
as proposed by Davis Vaughan on R-devel. Other range()-methods can make use of
new function .rangeNum().
• New .internalGenerics object complementing .S3PrimitiveGenerics, for docu-
mentation and low-level book-keeping.
• grid() now invisibly returns the x- and y- coordinates at which the grid-lines were
drawn.
14 NEWS
In a UTF-8 locale some transliterations are now done with a warning (e.g., dashes
and Unicode minus to hyphen, ligatures are expanded, permille (‘‰’) is replaced by
‘o/oo’), although the OS may have got there first. These are warnings as they will
continue to be replaced by dots in earlier versions of R.
• The matrix multiplication functions crossprod() and tcrossprod() are now also
primitive and S3 generic, as %*% had become in R 4.3.0.
• source() and example() have a new optional argument [Link] which allows
continued evaluation of the R code after an error.
• The non-Quartz tiff() devices allow additional types of compression if supported
by the platform’s ‘libtiff’ library.
• The list of base and recommended package names is now provided by
tools::standard_package_names().
• cairo_pdf() and cairo_ps() default to onefile = TRUE to closer match pdf() and
postscript().
• New option [Link] provides a documented way to catch errors and
then continue in non-interactive use.
• L %||% R newly in base is an expressive idiom for the phrases if() L
else R or if([Link](L)) R else L.
• The return value from warnings() now always inherits from "warnings" as docu-
mented, now also in the case of no warnings where it previously returned NULL.
• [Link]("1i") now returns 0 + 1i instead of NA with a warning.
• z <- c(NA, 1i) now keeps the imaginary part Im(z[1]) == 0, no longer coercing to
NA_complex_. Similarly, cumsum(z) correctly sums real and imaginary parts sepa-
rately, i.e., without “crosstalk” in case of NAs.
• On Alpine Linux iconv() now maps "latin2", "latin-2", "latin9" and "latin-9"
to encoding names the OS knows about (case-insensitively).
• iconv(sub = "Unicode") now always zero-pads to four (hex) digits, rather than to 4
or 8. (This seems to have become the convention once Unicode restricted the number
of Unicode points to 221 − 1 and so will never need more than 6 digits.)
• NCOL(NULL) now returns 0 instead of 1, for consistency with cbind().
• The information for the Euro glyph missing from the Adobe ‘.afm’ files for the
Courier, Helvetica and Times families has been copied from their URW equivalents –
this will improve vertical centring in the pdf() and postscript() devices.
• The included BLAS sources have been updated to those shipped with LAPACK ver-
sion 3.12.0. The changes are almost entirely cosmetic.
• The included LAPACK sources have been updated to version 3.12.0 and some further
double-complex routines added.
• There are new font families for the 2014–5 URW 2.0 fonts (see ?pdf) which are
included in recent versions of Ghostscript. These have font widths for most Greek
glyphs and a few others which were missing from the original versions (whose font
families remain available for reproducibility, although Ghostscript-based viewers will
render using the 2.0 versions).
• Improve the large-n efficiency of [Link](<dist>), thanks an R contributors effort,
notably by Tim Taylor and Heather Turner, see PR#18660.
• The default and numeric methods of [Link]() get a [Link] option.
16 NEWS
• zapsmall() gets new optional arguments, function mFUN and min.d, for extra flexi-
bility; fulfills a wish in PR#18199. Also, it is now an implicit S4 generic in package
methods.
• The Rd filter for aspell() gains an ignore argument.
• New generic function sort_by(), primarily useful for the [Link] method which
can be used to sort rows of a data frame by one or more columns.
• The licence headers for the RPC code in ‘src/extra/xdr’ have been updated to use
the GPL-compatible licence published by Oracle America in 2010.
• New function pkg2HTML() in tools to create single-page HTML reference manuals for
R packages.
• The byte code evaluator now uses less C stack space for recursive calls to byte-
compiled functions. It also makes more of an effort to avoid allocations for scalar
return values.
• New completion option backtick (disabled by default) allows non-syntactic comple-
tions to be wrapped in backquotes. This is currently only useful for Jupyter notebooks
via the IRkernel package, and may cause problems for other backends.
• The numeric version creators now stop on invalid non-character version specifications.
INSTALLATION:
• The parser has been updated to work with bison 3.8.2, which is now used for the pre-
generated parsers in ‘gram.c’, file.c, and ‘gramRd.c’. A few parser error messages
have changed, which may affect code that relies on exact messages.
INSTALLATION on a UNIX-ALIKE:
• System valgrind headers are now required to use configure option
‘--with-valgrind-instrumentation’ with value 1 or 2.
• configure will warn if it encounters a 32-bit build, as that is nowadays almost
untested.
• Environment variable R_SYSTEM_ABI is no longer used and so no longer recorded in
‘etc/Renviron’ (it was not on Windows and was only ever used when preparing
package tools).
• If the libdeflate library and headers are available, libdeflate rather than libz is
used to (de)compress R objects in lazy-load databases. Typically tasks spend up to
5% of their time on such operations, although creating lazy-data databases is one of
the exceptions.
This can be suppressed if the library is available by the configure option
‘--without-libdeflate-compression’.
• configure option ‘--enable-lto=check’ has not worked reliably since 2019 and has
been removed.
• The minimum autoconf requirement for a maintainer build has been increased to
autoconf 2.71.
It is intended to increase this to 2.72 for R 4.5.0: the distributed ‘configure’ file was
generated using 2.72.
• The minimum version requirement for an external LAPACK has been reduced to
3.9.0.
NEWS 17
INSTALLATION on macOS:
• A new configure option ‘--with-newAccelerate’ makes use of Apple’s ‘new’ BLAS
/ LAPACK interfaces in their Accelerate framework. Those interfaces are only avail-
able in macOS 13.3 or later, and building requires SDK 13.3 or later (from the Com-
mand Line Tools or Xcode 14.3 or later).
By default the option uses new Accelerate for BLAS calls: to also use it for LAPACK
use option ‘--with-newAccelerate=lapack’. The later interfaces provide LAPACK
3.9.1 rather than 3.2.1: 3.9.1 is from 2021-04 and does not include the improved
algorithms introduced in LAPACK 3.10.0 (including for BLAS calls).
INSTALLATION on WINDOWS:
• The makefiles and installer scripts for Windows have been tailored to Rtools44, an
update of the Rtools43 toolchain. It is based on GCC 13 and newer versions of
MinGW-W64, binutils and libraries (targeting 64-bit Intel CPUs). R-devel can no
longer be built using Rtools43 without changes.
• Rtools44 has experimental support for 64-bit ARM (aarch64) CPUs via the LLVM
17 toolchain using lld, clang/flang-new and libc++.
UTILITIES:
• R CMD check notes when S4-style exports are used without declaring a strong depen-
dence on package methods.
• tools::checkRd() (used by R CMD check) detects more problems with \Sexpr-based
dynamic content, including bad nesting of \Sexprs and invalid arguments.
• tools::checkRd() now reports Rd titles and section names ending in
a period; this is ignored by R CMD check unless environment variable
_R_CHECK_RD_CHECKRD_MINLEVEL_ is set to -5 or smaller.
• R CMD check now notes Rd files without an \alias, as long documented in ‘Writing
R Extensions’ §1.3.1. The check for a missing \description has been moved from
tools::checkRd() to tools::checkRdContents().
• R CMD check now visits ‘inst/[Link]’ and OS-specific ‘man’ subdirectories when
checking Rd files.
• tools::checkDocFiles() and tools::checkRdContents() now also check internal
Rd files by default, but “specially” (ignoring missing documentation of arguments).
• R CMD Rdiff gets option ‘--useEx’.
• R CMD check now warns on non-portable uses of Fortran KIND such as
INTEGER(KIND=4) and REAL(KIND=8).
To see the failing lines set environment variable _R_CHECK_FORTRAN_KIND_DETAILS_
to a true value.
18 NEWS
• When checking Rd files, R CMD check now notes some of the “lost braces” that
tools::checkRd() finds. Typical problems are Rd macros missing the initial back-
slash (e.g., ‘code{...}’), in-text set notation (e.g., ‘{1, 2}’, where the braces
need escaping), and \itemize lists with \describe-style entries of the form
\item{label}{description}.
• R CMD INSTALL (and hence check) will compile C++ code with -DR_NO_REMAP if en-
vironment variable _R_CXX_USE_NO_REMAP_ is set to a true value. It is planned that
this will in future become the default for compiling C++.
• The new built-in Rd macro \dontdiff{} can be used to mark example code
whose output should be ignored when comparing check output to reference out-
put (‘tests/Examples/[Link]’). The \dontdiff tag, like \donttest,
is not shown on the rendered help page, so provides a clean alternative to ‘##
IGNORE_RDIFF_(BEGIN|END)’ comments.
• R CMD build when there is no ‘NAMESPACE’, now uses the recommended
exportPattern("^[^.]"), instead of exporting everything.
• R CMD check now warns about non-ASCII characters in the ‘NAMESPACE’ file (in ad-
dition to R files). Such packages are not portable and may fail to install on some
platforms.
C-LEVEL FACILITIES:
• Headers ‘R_ext/Applic.h’ and ‘R-ext/Linpack.h’ used to include ‘R_ext/BLAS.h’
although this was undocumented and unneeded by their documented entry points.
They no longer do so.
• New function R_missing(), factored out from do_missing(), used to fix PR#18579.
• SEXP type S4SXP has been renamed to OBJSXP to support experimenting with al-
ternative object systems. The S4SXP value can still be used in C code but is now
deprecated. Based on contributions from the R Consortium’s Object-Oriented Pro-
gramming Working Group.
• New function pow1p(x,y) for accurate (1+x)^y.
• mkCharLenCE was incorrectly documented to take a size_t length but was imple-
mented with int (and character strings in R are limited to 231 − 1 bytes).
• UseMethod() no longer forwards local variables assigned in the generic function into
method call environments before evaluating the method body. This makes method
calls behave more like standard function calls and makes method code easier to analyze
correctly.
• The twelve [Link].<class>() methods which were deprecated
only via _R_CHECK_AS_DATA_FRAME_EXPLICIT_METHOD_ and in R CMD check
--as-cran are formally deprecated now in favour of calling [Link]()
or [Link](). The deprecation “check” now works also when
[Link]() is S4 generic thanks to Ivan Krylov.
• The default method for the directional comparison operators <, >, <=, and >= now
signals an error when one of the operands is a language object, i.e. a symbol or a
call.
• For [Link](), deprecate abb and [Link] arguments formally in addition
to just documenting it.
BUG FIXES:
• The methods package is more robust to not being attached to the search path. More
work needs to be done.
• [Link]() misbehaved when subgroups had 0 DF for variance, even with
[Link] = TRUE. (PR#18594 by Jack Berry).
• Probability distribution functions [dpq]<distrib>(x, *), but also
bessel[IKJY](x, .) now consistently preserve attributes(x) when length(x) ==
0, e.g., for a 2 × 0 matrix, thanks to Karolis Koncevičius’ report PR#18509.
• Group “Summary” computations such as sum(1:3, 4, [Link] = 5, NA, 7, [Link] =
LL) now give an error instead of either 17 or NN for LL true or false, as proposed
by Ivan Krylov on the R-devel mailing list. (This also means it is now an error to
specify [Link] more than once.)
• [Link](x) now returns complex(real = x, imaginary = 0) for all numerical
and logical x, notably also for NA or NA_integer_.
• Directories are now omitted by [Link](, recursive = FALSE) and in
[Link]() (PR#17337).
• gsub() and sub() are now more robust to integer overflow when reporting errors
caused by too large input strings (PR#18346).
• Top-level handlers are now more robust to attempts to remove a handler whilst han-
dlers are running (PR#18508).
• The handling of Alt+F4 in dialogs created on Windows using GraphApp has been
fixed (PR#13870).
• density() more consistently computes grid values for the FFT-based convolution,
following Robert Schlicht’s analysis and proposal in PR#18337, correcting density
values typically by a factor of about 0.999. Argument [Link] = TRUE provides
back compatibility.
• [Link]() gains a name argument that defaults to FALSE controlling whether
the vector of colours that is returned has names (where possible). PR#18529.
• tools::xgettext() no longer extracts the (non-translatable) class names from
warningCondition and errorCondition calls.
• S3method(<gen>, <class>, <func>) in the ‘NAMESPACE’ file now works (again) when
<func> is visible from the namespace, e.g., imported, or in base.
20 NEWS
• getParseData(f) now also works for a function defined in the first of several
‘<pkg>/R/*.R’ source files, thanks to Kirill Müller’s report and Duncan Murdoch’s
patch in PR#16756.
• Rd \Sexpr macros with nested #ifdef conditionals were not processed.
• A non-blocking connection with non-default encoding (such as a socket) now correctly
returns from readLines() after new data has arrived also when its EOF had been
reached previously. Thanks to Peter Meilstrup’s report on R-devel and Ivan Krylov’s
report and patch proposal in PR#18555.
• tools::checkRdContents() failed to detect empty argument descriptions when they
spanned multiple lines, including those generated by prompt(). These cases are now
noted by R CMD check.
• Plain-text help no longer outputs spurious colons in the arguments list (for multi-line
\item labels in the Rd source).
• kappa() and rcond() work correctly in more cases; kappa(., norm = "2") now warns
that it computes the 1-norm with (default) exact = FALSE; prompted by Mikael Ja-
gan’s quite comprehensive PR#18543.
• Rd skeletons generated by prompt() or promptData() now use a dummy title (so
R CMD build works). tools::checkRdContents() has been updated to detect such
template leftovers, including from promptPackage().
• When S4 method dispatch fails because no method was found, the error message now
includes the signature argument names; thanks to Michael Chirico’s proposal on the
R-devel list.
• withAutoprint({ .. }) now preserves srcrefs previously lost, thanks to Andrew
Simmons’ report plus fix in PR#18572.
• [Link]() no longer adjusts names; in particular, untransformed vari-
ables are kept as-is, including those with syntactically invalid names (PR#17890).
• The [Link] option for Rd \Sexpr blocks is no longer ignored.
• The formula methods for [Link]() and [Link]() now catch when paired is
passed, addressing PR#14359; use Pair(x1, x2) ~ 1 for a paired test.
• The level reported in the browser prompt was often too large. It now shows the
number of browser contexts on the stack.
• For cbind() and rbind(), the optional [Link] argument is now properly
passed to methods, thanks to Mikael Jagan’s PR#18579 and comments there.
• Some error and warning messages for large (‘long vector’) matrix(v, nr, nc)
and dim(m) <- d are now correct about sizes, using long long formatting, fixing
PR#18612 (and more) reported by Mikael Jagan.
• readChar(useBytes = TRUE) now terminates strings even when the underlying con-
nection uses extra spaces in the input buffer. This fixes problems with extra garbage
seen with gzip connections, PR#18605.
• Named capture in PCRE regular expressions now works also with more than 127
named groups (PR#18588).
• Datetime functions are now robust against long jumps when dealing with internal time
zone changes. This avoids confusing warnings about an invalid time zone, previously
triggered by turning warnings into errors or handling them via tryCatch (PR#17966,
PR#17780).
NEWS 21
• Datetime functions now restore even an empty TZ environment variable after internal
time zone changes (PR#17724). This makes results of datetime functions with this
(typically unintentional) setting more predictable.
• [Link](*) now drops response as by default, [Link] = FALSE, fixing
PR#18564 thanks to Mikael Jagan.
• [Link](.) now also works for lm()-models with character categorical predictor
variables rather than factor ones, fixing PR#18635 reported by Jinsong Zhao.
• formals(f) <- formals(f) now also works for a function w/o arguments and atomic
constant body(f).
• Correct [Link](<invalid list>, .)’s error message.
• removeSource() is yet more thorough in finding and removing "srcref" and the
other source references from parsed R language chunks, fixing PR#18638 thanks to
Andrew Simmons.
• dgeom() is more accurate now, notably when its result is very small, fixing PR#18642
thanks to the proposal of Morten Welinder, also improving other instances where C
level binom_raw(x, n, ..) has x == 0 or x== n.
• warning() with options(warn = 1) has improved output for multi-line messages.
• [Link]() and [Link]() now respect the par("lab") setting for the num-
ber of pretty() intervals.
• Comparisons for language objects (which are based on deparsing) are now more careful
about using accurate deparsed results (PR#18676).
• Plain-text help (Rd2txt) now correctly preserves blank lines following single-line
\dontrun code.
• <POSIXlt>[*] no longer sets wrong "balanced" attribute, fixing PR#18681 thanks
to Mikael Jagan.
• str(<classed-call>) now deparses the call as expected, fixing PR#18684, reported
by Dave Slager.
• In Rd examples, code following the closing brace of a \dontrun, \dontshow or
\donttest tag on the same line is no longer skipped when R CMD check runs the
examples.
• [Link](matrix(*, ncol=0)) now gets valid names() and colnames(); re-
ported by Davis Vaughan on the R-devel list.
• Internal Mathlib function stirlerr(n) is now almost fully (52-bit) accurate for all
n >= 5.9 and more accurate also in the range 1 − −5.9. This entails small (“after
12th decimal”) changes in density functions, e.g., dgamma() in some regions of their
support. The fix was partly prompted by Morten Welinder’s PR#18640.
• Numbers like 9876543.2 are now considered non-integer by Mathlib internal
R_nonint(), amending original fix of PR#15734.
• Rd comment lines no longer cause broken paragraphs in the rendered PDF and plain-
text help. In code blocks, pure comment lines (starting with ‘%’) no longer produce
an empty line.
• xtabs(Freq ~ .) now consistently defaults to [Link] = [Link], using [Link] =
FALSE (added as an argument) when summing over Freq (PR#17770).
• tools::testInstalledPackage() is no longer silent about failures from running ex-
amples or tests and its return code no longer ignores failures from checking vignettes.
22 NEWS
CHANGES IN R 4.3.3
NEW FEATURES:
• iconv() now fixes up variant encoding names such as "utf8" case-insensitively.
BUG FIXES:
• Arguments are now properly forwarded to methods on S4 generics with . . . in the
middle of their formal arguments. This was broken for the case when a method
introduced an argument but did not include . . . in its own formals. Thanks to Hervé
Pagès for the report PR#18538.
• Some invalid file arguments to pictex(), postscript() and xfig() opened a file
called ‘NA’ rather than throw an error. These included postscript(NULL) (which
some people expected to work like pdf(NULL)).
• Passing filename = NA to svg(), cairo_pdf(), cairo_ps() or the Cairo-based
bitmap devices opened a file called ‘NA’: it now throws an error.
• quartz(file = NA) opened a file called ‘NA’, including when used as a Quartz-based
bitmap device. It now gives an error.
• rank(<long vector>) now works, fixing PR#18617, thanks to Ilia Kats.
• [Link]() did not adequately check its [Link] argument.
• match(<POSIXct>, .) is correct again for differing time zones, ditto for "POSIXlt",
fixing PR#18618 reported by Bastian Klein.
• [Link](*, dropx = <0-length>) now works, fixing PR#18563 as proposed by
Mikael Jagan.
• [Link](*) keeps + offset(.) terms when it should, PR#18565, and
[Link]() no longer makes up a response, PR#18566, fixing both bugs thanks
to Mikael Jagan.
• getS3method("t", "test") no longer finds the [Link]() function, fixing PR#18627.
• pdf() and postscript() support for the documented Adobe encodings "Greek" and
"Cyrilllic" was missing (although the corresponding Windows’ codepages could be
used).
• Computations of glyph metric information for pdf() and postscript() did not take
into account that transliteration could replace one character by two or more (only
seen on macOS 14) and typically warned that the information was not known.
• rank(x) no longer overflows during integer addition, when computing rank average
for largish but not-yet long vector x, fixing PR#18630, thanks to Ilia Kats.
• [Link]() on Windows now returns also files with names longer that 260 bytes
(the Windows limit is 260 characters). Previously, some file names particularly with
‘East Asian’ characters were omitted.
• cov2cor(<0 x 0>) now works, fixing PR#18423 thanks to Mikael Jagan and Elin
Waring.
NEWS 23
• cov2cor(<negative diagonal>) and similar now give one warning instead of two,
with better wording, fixing PR#18424 thanks to Mikael Jagan.
• tools:: startDynamicHelp() now ensures port is in proper range, fixing PR#18645.
• pbeta(x, a,b) is correct now for x=0 or 1 in the boundary cases where a or b or
both are 0, fixing PR#18672 thanks to Michael Fay.
• pmatch(x, table) for large table, also called for data frame row selection, dfrm[nm,
], is now interruptible, fixing PR#18656.
• predict(<rank-deficient lm>, newdata=*) fix computing of nbasis, see Russ
Lenth’s comment 29 in PR#16158.
• Added a work-around for a bug in macOS 14.3.1 and higher which prevents R plots
in the Quartz Cocoa device from updating on screen.
CHANGES IN R 4.3.2
NEW FEATURES:
• The default initialization of the "repos" option from the ‘repositories’ file at
startup can be skipped by setting environment variable R_REPOSITORIES to NULL
such that getOption("repos") is empty if not set elsewhere.
• qr.X() is now an implicit S4 generic in methods.
• iconv(to = "ASCII//TRANSLIT") is emulated using substitution on platforms which
do not support it (notably Alpine Linux). This should give a human-readable con-
version in ASCII on all platforms (rather than NA_character_).
• trans3d() gains options continuous and verbose addressing the problem of possible
“wrap around” when projecting too long curves, as reported by Achim Zeileis in
PR#18537.
• tools::showNonASCII() has been rewritten to work better on macOS 14 (which has
a changed implementation of iconv()).
• tiff(type = "quartz") (the default on macOS) now warns if compression is spec-
ified: it continues to be ignored.
INSTALLATION on a UNIX-ALIKE:
• There is some support for building with Intel’s LLVM-based compilers on ‘x86_64’
Linux, such as (C) icx, (C++) ipcx and (Fortran) ifx from oneAPI 2023.x.y.
• There is support for using LLVM’s flang-new as the Fortran compiler from LLVM
16.0.x (preferably 17.0.0 or later).
UTILITIES:
• R CMD check reports the use of the Fortran 90 random number generator
RANDOM_NUMBER() and the subroutines to initialize it.
‘Writing R Extensions’ has example code to use R’s RNGs from Fortran.
BUG FIXES:
• substr(x, n, L) <- cc now works (more) correctly for multibyte UTF-8 strings x
when L > nchar(x), thanks to a report and patch by ‘Architect 95’.
24 NEWS
CHANGES IN R 4.3.1
C-LEVEL FACILITIES:
• The C-level API version of R’s integrate(), Rdqags() in ‘Applic.h’, now returns
the correct number of integrand evaluations neval, fixing PR#18515 reported and
diagnosed by Stephen Wade.
• The C prototypes for LAPACK calls dspgv and dtptrs in ‘R_ext/Lapack.h’ had one
too many and one too few character length arguments — but this has not caused any
known issues. To get the corrected prototypes, include
NEWS 25
INSTALLATION:
• Many of the checks of esoteric Internet operations and those using unreliable external
sites have been moved to a new target that is not run by default and primarily
intended for the core developers. To run them use
cd tests; make test-Internet-dev
BUG FIXES:
• .S3methods(), typically called from methods(), again marks methods from package
base as visible.
Also, the visibility of non-base methods is again determined by the method’s presence
in search().
• tools::Rdiff() is now more robust against invalid strings, fixing installation tests
on Windows without Rtools installed (PR#18530).
• Fix (new) bug in [Link](2, *), by Achim Zeileis (PR#18523).
• head(., <illegal>) and tail(..) now produce more useful "Error in ...." error
messages, fixing PR#18362.
• Package code syntax on Windows is checked in UTF-8 when UTF-8 is the native
encoding.
• [Link](x) now also returns the first run, when it is at the beginning and
there is a later one of the same length; reported to R-devel, including a fix, by Georgi
Boshnakov. Further, by default, it modifies only an existing attr(*,"tsp") but
otherwise no longer sets one.
• chol(<not [Link]>, pivot = <T|F>) now gives a correct error or warning message
(depending on pivot), thanks to Mikael Jagan’s (PR#18541).
CHANGES IN R 4.3.0
SIGNIFICANT USER-VISIBLE CHANGES:
• Calling && or || with LHS or (if evaluated) RHS of length greater than one is now
always an error, with a report of the form
'length = 4' in coercion to 'logical(1)'
Environment variable _R_CHECK_LENGTH_1_LOGIC2_ no longer has any effect.
NEW FEATURES:
• The included BLAS sources have been updated to those shipped with LAPACK ver-
sion 3.10.1. (This caused some platform-dependent changes to package check output.)
And then to the sources from LAPACK version 3.11.0 (with changes only to double
complex subroutines).
26 NEWS
• The included LAPACK sources have been updated to include the four Fortran 90
routines rather than their Fortran 77 predecessors. This may give some different
signs in SVDs or eigendecompositions.. (This completes the transition to LAPACK
3.10.x begun in R 4.2.0.)
• The LAPACK sources have been updated to version 3.11.0. (No new subroutines have
been added, so this almost entirely bug fixes: Those fixes do affect some computations
with NaNs, including R’s NA.)
• The parser now signals classed errors, notably in case of the pipe operator |>. The
error object and message now give line and column numbers, mostly as proposed and
provided by Duncan Murdoch in PR#18328.
• toeplitz() is now generalized for asymmetric cases, with a toeplitz2() variant.
• [Link]() and [Link]() and consequently, e.g., plot(x,y, log = "y") now
signal a classed warning about negative values of y (where log(.) is NA). Such a
warning can be specifically suppressed or caught otherwise.
• Regular expression functions now check more thoroughly whether their inputs are
valid strings (in their encoding, e.g. in UTF-8).
• The performance of grep(), sub(), gsub() and strsplit() has been improved,
particularly with perl = TRUE and fixed = TRUE. Use of useBytes = TRUE for perfor-
mance reasons should no longer be needed and is discouraged: it may lead to incorrect
results.
• apropos() gains an argument dot_internals which is used by the completion
(help(rcompgen)) engine to also see base internals such as .POSIXct().
• Support in tools::Rdiff() for comparing uncompressed PDF files is further reduced
– see its help page.
• qqplot(x, y, ...) gains [Link] and [Link] arguments for computing and
plotting a confidence band for the treatment function transforming the distribution
of x into the distribution of y (Switzer, 1976, Biometrika). Contributed by Torsten
Hothorn.
• Performance of package_dependencies() has been improved for cases when the
number of dependencies is large.
• Strings newly created by gsub(), sub() and strsplit(), when any of the inputs is
marked as "bytes", are also marked as "bytes". This reduces the risk of creating
invalid strings and accidental substitution of bytes deemed invalid.
• Support for readLines(encoding = "bytes") has been added to allow processing
special text files byte-by-byte, without creating invalid strings.
• iconv(from = "") now takes into account any declared encoding of the input elements
and uses it in preference to the native encoding. This reduces the risk of accidental
creation of invalid strings, particularly when different elements of the input have
different encoding (including "bytes").
• Package repositories in getOption("repos") are now initialized from the
‘repositories’ file when utils is loaded (if not already set, e.g., in ‘.Rprofile’).
(From a report and patch proposal by Gabriel Becker in PR#18405.)
• compactPDF() gets a verbose option.
• [Link]() and hence [Link]() get new option tryLogical = TRUE with
back compatible default. When set to false, converts "F" or "T" columns to character.
• Added new unit prefixes "R" and "Q" for abbreviating (unrealistically large) sizes
beyond 1027 in standard = "SI", thanks to Henrik Bengtsson’s PR#18435.
NEWS 27
• [Link]()’s default method now also works fine with atomic objects inheriting
from classes such as "roman", "octmode" and "hexmode", thus fulfilling the wish of
PR#18421, by Benjamin Feakins.
• The [Link]() utility now errors for wrong-length [Link]. It
warned for almost six years, with “Will be an error!”.
• sessionInfo() now also contains La_version() and reports codepage and timezone
when relevant, in both print() and toLatex() methods which also get new option
tzone for displaying timezone information when locale = FALSE.
• New function R_compiled_by() reports the C and Fortran compilers used to build
R, if known.
• predict(<lm>, newdata = *) no longer unnecessarily creates an offset of all 0s.
• solve() for complex inputs now uses argument tol and by default checks for ‘com-
putational singularity’ (as it long has done for numeric inputs).
• predict(<rank-deficient lm>, newdata=*) now obeys a new argument
rankdeficient, with new default "warnif", warning only if there are non-estimable
cases in newdata. Other options include rankdeficient = "NA", predicting NA for
non-estimable newdata cases. This addresses PR#15072 by Russ Lenth and is based
on his original proposal and discussions in PR#16158 also by David Firth and Elin
Waring. Still somewhat experimental.
• Rgui console implementation now works better with the NVDA screen reader when the
full blinking cursor is selected. The underlying improvements in cursor handling may
help also other screen readers on Windows.
• The drop-field control in GraphApp can now be left with the TAB key and all controls
can be navigated in the reverse order using the Shift+TAB key, improving accessibility
of the Rgui configuration editor.
• qnorm(<very large negative>, log.p=TRUE) is now fully accurate (instead of to
“only” minimally five digits).
• demo([Link]) now also shows off withWarnings() and tryCatchWEMs().
• As an experimental feature the placeholder _ can now also be used in the rhs of
a forward pipe |> expression as the first argument in an extraction call, such as
_$coef. More generally, it can be used as the head of a chain of extractions, such as
_$coef[[2]].
• Spaces in the environment variable used to choose the R session’s temporary directory
(TMPDIR, TMP and TEMP are tried in turn) are now fatal. (On Windows the ‘short path’
version of the path is tried and used if that does not contain a space.)
• [Link]() gets a new optional switch giveErr to return the numeric
error as attribute. Relatedly, stopifnot([Link]<some>(a, b, ..)) is as “smart”
now, as stopifnot([Link](....)) has been already, thus allowing customized
[Link]<Some>() wrappers.
• R on Windows is now able to work with path names longer than 260 characters
when these are enabled in the system (requires at least Windows 10 version 1607).
Packages should be updated to work with long paths as well, instead of assum-
ing PATH_MAX to be the maximum length. Custom front-ends and applications
embedding R need to update their manifests if they wish to allow this feature.
See [Link]
for more information.
28 NEWS
• ‘Object not found’ and ‘Missing argument’ errors now give a more accurate error
context. Patch provided by Lionel Henry in PR#18241.
• The @ operator is now an S3 generic. Based on contributions by Tomasz Kalinowski
in PR#18482.
• New generic chooseOpsMethod() provides a mechanism for objects to resolve cases
where two suitable methods are found for an Ops Group Generic. This supports
experimenting with alternative object systems. Based on contributions by Tomasz
Kalinowski in PR#18484.
• inherits(x, what) now accepts values other than a simple character vector for ar-
gument what. A new generic, nameOfClass(), is called to resolve the class name
from what. This supports experimenting with alternative object systems. Based on
contributions by Tomasz Kalinowski in PR#18485.
• Detection of BLAS/LAPACK in use (sessionInfo()) with FlexiBLAS now reports
the current backend.
• The "[Link]" method for subset() now warns about extraneous arguments,
typically catching the use of ‘=’ instead of ‘==’ in the subset expression.
• Calling a:b when numeric a or b is longer than one may now be made into an error
by setting environment variable _R_CHECK_LENGTH_COLON_ to a true value, along the
proposal in PR#18419 by Henrik Bengtsson.
• density(x, weights = *) now warns if automatic bandwidth selection happens with-
out using weights; new optional warnWbw may suppress the warning. Prompted by
Christoph Dalitz’ PR#18490 and its discussants.
• rm(list = *) is faster and more readable thanks to Kevin Ushey’s PR#18492.
• The [Link]() function no longer produces a normal Q-Q plot for GLMs. Instead
it plots a half-normal Q-Q plot of the absolute value of the standardized deviance
residuals.
• The print() method for class "[Link]" no longer shows summary statistics
for the deviance residuals by default. Its optional argument [Link] can be
used to show them if required.
• The tapply() function now accepts a data frame as its X argument, and allows
INDEX to be a formula in that case. [Link]() similarly allows INDICES to be
a formula.
• The performance of df[j] <- value (including for missing j) and [Link](df)
has been improved for data frames df with a large number of columns. (Thanks to
Gabriel Becker’s PR#18500, PR#18503 and discussants, prompted by a report from
Toby Dylan Hocking on the R-devel mailing list.)
• The matrix multiply operator %*% is now an S3 generic, belonging to new group
generic matrixOps. From Tomasz Kalinowski’s contribution in PR#18483.
• New function array2DF() to convert arrays to data frames, particularly useful for
the list arrays created by tapply().
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 16 and so packages
that provide graphics devices should be reinstalled.
• The grDevices and grid packages have new functions for rendering typeset glyphs,
primarily: grDevices::glyphInfo() and grid::[Link]().
Rendering of typeset glyphs is only supported so far on the Cairo-based graphics
devices and on the pdf() and quartz() devices.
• The defined behaviour for "clear" and "source" compositing operators (via
grid::[Link]()) has been changed (to align better with simple interpretation
of original Porter-Duff definitions).
30 NEWS
• Support for gradients, patterns, clipping paths, masks, groups, compositing operators,
and affine transformations has been added to the quartz() device.
INSTALLATION on a UNIX-ALIKE:
• A system installation of generic LAPACK 3.10.0 or later will be preferred to the
version in the R sources.
configure option ‘--with-lapack=no’ (equivalently ‘--without-lapack’) forces
compilation of the internal LAPACK sources.
If ‘--with-lapack’ is not specified, a system liblapack is looked for and used if it
reports version 3.10.0 or later and does not contain BLAS routines.
Packages using LAPACK will need to be reinstalled if this changes to using an external
library.
• On ‘aarch64’ Linux platforms using GCC, configure now defaults to ‘-fPIC’ (instead
of ‘-fpic’), as desired in PR#18326.
• configure now checks conversion of datetimes between POSIXlt and POSIXct around
year 2020. Failure (which has been seen on platforms missing tzdata) is fatal.
• If configure option ‘--with-valgrind-instrumentation’ is given value 1 or 2,
option ‘--with-system-valgrind-headers’ is now the default and ignored (with a
warning). It is highly recommended that the system headers are installed alongside
valgrind: they are part of its packaging on some Linux distributions and packaged
separately (e.g. in the ‘valgrind-devel’ RPM) on others. configure will give a
warning if they are not found.
The system headers will be required in a future release of R to build with valgrind
instrumentation.
• libcurl 8.x is now accepted by configure: despite a change in major version number
it changes neither API nor ABI.
INSTALLATION on WINDOWS:
• The makefiles and installer scripts for Windows have been tailored to Rtools43, an
update of the Rtools42 toolchain. It is based on GCC 12 and newer versions of
MinGW-W64, binutils and libraries. At this time R-devel can still be built using
Rtools42 without changes, but when R-devel is installed via the installer, it will by
default look for Rtools43.
• Old make targets rsync-extsoft and 32-bit ones that are no longer needed have
been removed.
• Default builds (including for packages) no longer select C99. Thus the C standard
used is the default for the compiler, which for the toolchain in ‘Rtools43’ is C17.
(This is consistent with Unix builds.)
PACKAGE INSTALLATION:
• The default C++ standard has been changed to C++17 where available (which it
is on all currently checked platforms): if not C++14 or C++11 is used if available
otherwise C++ is not supported.
• USE_FC_LEN_T is the default: this uses the correct (compiler-dependent) prototypes
for Fortran BLAS/LAPACK routines called from C/C++, and requires adjustment
of many such calls – see ‘Writing R Extensions’ §6.6.1.
NEWS 31
• There is initial support for C++23 as several compilers are now supporting
-std=c++23 or -std=c++2b or similar. As for C++20, there no additional configure
checks for C++23 features beyond a check that the compiler reports a __cplusplus
value greater than that in the C++20 standard. C++ feature tests should be used.
• There is support for a package to indicate the version of the C standard which should
be used to compile it, and for the installing user to specify this. In most cases R
defaults to the C compiler’s default standard which is C17 (a ‘bug-fix’ of C11) –
earlier versions of R or compilers may have defaulted to C99.
Current options are:
USE_C17 Use a standard that is at most C17. The intention is to allow legacy
packages to still be installed when later C standards become the default, in-
cluding packages using new keywords as identifiers or with K&R-style function
declarations. This will use C17 if available, falling back to C11.
USE_C90 Use the C90 (aka C89) standard. (As that standard did not require
compilers to identify that version, all we can verify is that the compiler does not
claim to be using a later standard. It may accept C99 features – for example
clang accepts // to make comments.)
USE_C99 Use the C99 standard. This should be rarely needed – it avoids the few
new features of C11/C17 which can be useful if a package assumes them if C17
is specified and they are not implemented.
USE_C23 Use C23 (or in future, later). Compiler/library support for C23 is still
being implemented, but LLVM clang from 15.0.0 and GCC from 13 have quite
extensive support.
These can be specified as part of the ‘SystemRequirements’ field in the package’s
‘DESCRIPTION’ file or via options ‘--use-C17’ and so on of R CMD INSTALL and R CMD
SHLIB.
For further details see “Writing R Extensions” §1.2.5.
• (Windows) A ‘src/[Link]’ or ‘src/[Link]’ file is now included after
‘R_HOME/etcR_ARCH /Makeconf’ and so no longer needs to include that file it-
self. Installation of a package with such a file now uses a site ‘Makevars’ file in the
same way as a package with a ‘src/[Link]’ file would.
• configure is now passed crucial variables such as CC and CFLAGS in its environment,
as many packages were not setting them (as documented in ‘Writing R Extensions’
§1.2).
This has most effect where configure is used to compile parts of the package – most
often by cmake or libtool which obfuscate the actual compile commands used.
Also used for [Link] and [Link] on Windows.
FORTRAN FLAGS:
• The flag ‘-fno-optimize-sibling-calls’ is no longer forced for gfortran 7 and
later. It should no longer be needed now using ‘hidden’ character-length arguments
when calling BLAS/LAPACK routines from C/C++ is the default even for packages.
(Unless perhaps packages call Fortran code from C/C++ without using R’s headers
and without allowing for these arguments.)
C-LEVEL FACILITIES:
• The deprecated S-compatibility macros DOUBLE_* in ‘R_ext/Constants.h’ (included
by ‘R.h’) have been removed.
32 NEWS
• The deprecated legacy typedefs of Sint and Sfloat in header ‘R.h’ are no longer
defined, and that header no longer includes header ‘limits.h’ from C nor ‘climits’
from C++.
• New macro CAD5R() is provided in ‘Rinternals.h’ and used in a few places in the R
sources.
• ALTREP now supports VECSXP vectors. Contributed by Gabor Csardi in PR#17620.
• The Rcomplex definition (in header ‘R_ext/Complex.h’) has been extended to pre-
vent possible mis-compilation when interfacing with Fortran (PR#18430). The new
definition causes compiler warnings with static initializers such as {1, 2}, which can
be changed to {.r=1,.i=2}.
Using the new definition from C++ depends on compiler extensions supporting C
features that have not been incorporated into the C++ standards but are available
in g++ and clang++: this may result in C++ compiler warnings but these have been
worked around for recent versions of common compilers (GCC, Apple/LLVM clang,
Intel).
It is intended to change the inclusion of header ‘R_ext/Complex.h’ by other R head-
ers, so C/C++ code files which make use of Rcomplex should include that header
explicitly.
UTILITIES:
• R CMD check does more checking of package ‘.Rd’ files, warning about invalid email
addresses and (some) invalid URIs and noting empty ‘\item’ labels in description
lists.
• R CMD check now also reports problems when reading package news in md (file
‘[Link]’) and (optionally) plain text (file ‘NEWS’) formats.
• _R_CHECK_TIMINGS_ defaults to a value from the environment even for R CMD check
--as-cran; this allows for exceptionally fast or slow platforms.
It now applies to checking PDF and HTML versions of the manuals, and ‘checking
CRAN incoming feasibility’.
• R CMD check can optionally (but included in ‘--as-cran’) check whether HTML math
rendering via KaTeX works for the package ‘.Rd’ files.
• Non-interactive debugger invocations can be trapped by setting the environment vari-
able _R_CHECK_BROWSER_NONINTERACTIVE_ to a true value. This is enabled by R CMD
check --as-cran to detect the use of leftover browser() statements in the package.
• The use of sprintf and vsprintf from C/C++ has been deprecated in macOS 13
and is a known security risk. R CMD check now reports (on all platforms) if their use
is found in compiled code: replace by snprintf or vsnprintf respectively. [NB:
whether such calls get compiled into the package is platform-dependent.]
• Where recorded at installation, R CMD check reports the C and Fortran compilers
used to build R.
It reports the OS in use (if known, as given by osVersion) as well as that R was built
for.
It notes if a C++ standard was specified which is older than the current default:
many packages have used C++11 to mean ‘not C++98’ — as C++11 is the minimum
supported since R 4.0.0, that specification can probably be removed.
• R CMD INSTALL reports the compilers (and on macOS, the SDK) used, and this is
copied to the output of R CMD check.
Where a C++ standard is specified, it is reported.
NEWS 33
• R CMD check’s ‘checking compilation flags in Makevars’ has been relaxed to accept the
use of flags such as ‘-std=f2008’ in ‘PKG_FFLAGS’.
• tools::buildVignettes() has a new argument skip, which is used by R CMD check
to skip (and note) vignettes with unavailable ‘\VignetteDepends’ (PR#18318).
• New generic .AtNames() added to enable class-specific completions after @. The
formerly internal function findMatches() is now exported, mainly for use in methods
for .DollarNames() and .AtNames().
BUG FIXES:
• Hashed environments with sizes less than 5 can now grow. (Reported to R-devel by
Duncan Garmonsway.)
• [Link](<Rd>, deparse = TRUE) failed to re-escape curly braces in LaTeX-like
text. (Reported by Hadley Wickham in PR#18324.)
• library() now passes its [Link] argument when requiring Depends packages; re-
ported (with fix) in PR#18331 by Mikael Jagan.
• R CMD Stangle: improved message about ‘Output’ files.
• head(x, n) and tail(x, n) now signal an error if n is not numeric, instead of in-
cidentally “working” sometimes returning all of x. Reported and discussed by Colin
Fay, in PR#18357.
• The "lm" method for summary() now gives the correct F-statistic when the model
contains an offset. Reported in PR#18008.
• C() and `contrasts<-`() now preserve factor level names when given a function ob-
ject (as opposed a function name which did preserve names). Reported in PR#17616.
• c(a = 1, 2)[[]] no longer matches 2 but rather signals a classed error. Reported
and analysed by Davis Vaughan in PR#18367, a duplicate of PR#18004, by Jan Meis
et al. For consistency, NULL[[]] is also erroneous now. x[[]] <- v gives an error of
the same class "MissingSubscriptError".
• The relist() function of utils now supports NULL elements in the skeleton
(PR#15854).
• ordered(levels = *) (missing x) now works analogously to factor(,
ordered=TRUE); reported (with fix) by Achim Zeileis in PR#18389.
• User-defined Rd macro definitions can now span multiple lines, thanks to a patch
from Duncan Murdoch. Previously, the Rd parser silently ignored everything after
the first line.
• Plain-text help (tools::Rd2txt()) now preserves an initial blank line for text fol-
lowing description list items.
• tools::Rd2HTML() and tools::Rd2latex() no longer split \arguments and \value
lists at Rd comments.
34 NEWS
CHANGES IN R 4.2.3
C-LEVEL FACILITIES:
• The definition of DL_FUNC in ‘R_ext/Rdynload.h’ has been changed to be fully C-
compliant. This means that functions loaded via for example R_GetCCallable need
to be cast to an appropriate type if they have any arguments.
• .Machine has a new element sizeof.time_t to identify old systems with a 32-bit
type and hence a limited range of date-times (and limited support for dates millions
of years from present).
PACKAGE INSTALLATION:
• (Windows) The default C++ standard had accidentally been left at C++11 when it
was changed to C++14 on Unix.
BUG FIXES:
• As "POSIXlt" objects may be “partially filled” and their list components meant to be
recycled, length() now is the length of the longest component.
• [Link]() could underflow for dates in the far past (more than half a million
years BCE).
• [Link](x) would return "1970-01-01" instead of NA in R 4.2.2, e.g., for
x <- [Link](c("2019-01-30","2001-1-1"))
x$mon <- c(0L, NA); [Link](x)
• R CMD check failed to apply enabled _R_CHECK_SUGGESTS_ONLY_ to examples and
vignettes (regression in R 4.2.0).
• R CMD check did not re-build vignettes in separate processes by default (regression in
R 4.2.0).
• Running examples from HTML documentation now restores previous knitr settings
and options (PR#18420).
• Quartz: fonts are now located using Core Graphics API instead of deprecated ATS
which is no longer supported in the macOS 13 SDK (PR#18426). This also addresses
an issue where the currently used font in the Quartz device context was not correctly
retained.
• (Windows) Math symbols in text drawing functions are again rendered correctly
(PR#18440). This fixes a regression in R 4.2.1 caused by a fix in PR#18382 which
uncovered an issue in GraphApp due to which the symbol charset was not used with
TT Symbol font face.
• (Windows) Installing a package with a ‘src/Makefile.{win,ucrt}’ file includes
‘~/.R/Makevars.win64’ in the search for user makevars, as documented in “R Instal-
lation and Administration” and done for packages with a ‘src/Makevars.{win,ucrt}’
file.
• format(<POSIXlt_w/_unbalanced_sec>, "....%OS<n>") with n > 0 no longer acci-
dentally uses the unbalanced seconds, thanks to Suharto Anggono’s report (including
patch) in PR#18448.
• [Link](a, b) works around issues with some versions of LAPACK when a
contains NA or NaN values.
NEWS 37
• When UseMethod() cannot dispatch, it no longer segfaults producing the error mes-
sage in case of a long class(), thanks to Joris Vankerschaver’s report (including
patch) in PR#18447.
• When example(foo, ..) produces graphics on an interactive device it needs to open
itself, it now leaves devAskNewPage() unchanged even when it was FALSE, thus fixing
a 14 years old ‘FIXME’.
• packageDescription() again catches errors from encoding conversions. This also
fixes broken packageVersion() in C locale on systems where iconv does not support
transliteration.
CHANGES IN R 4.2.2
NEW FEATURES:
• tools::Rdiff(useDiff = TRUE) checks for the presence of an external diff com-
mand and switches to useDiff = FALSE if none is found. This allows R CMD Rdiff to
always work.
• On Windows, environment variable R_LIBCURL_SSL_REVOKE_BEST_EFFORT can be
used to switch to only ‘best-effort’ SSL certificate revocation checks with the de-
fault "libcurl" download method. This reduces security, but may be needed for
downloads to work with MITM proxies (PR#18379).
• (macOS) The run-time check for libraries from XQuartz for X11 and Tcl/Tk no longer
uses otool from the Apple Developer Tools (PR#18400).
• The LATEX style for producing the PDF manuals, ‘[Link]’, now loads the standard
‘amsmath’, ‘amsfonts’ and ‘amssymb’ packages for greater coverage of math commands
in the Rd \eqn and \deqn macros. The \mathscr LATEX command is also provided
(via the ‘mathrsfs’ package, if available, or the ‘amsfonts’ bundle otherwise), fulfill-
ing the wish of PR#18398.
• (Windows) The default format of readClipboard() and writeClipboard() has been
changed to 13 (CF_UNICODETEXT).
INSTALLATION on a UNIX-ALIKE:
• The PDF manuals (if built) can be compacted by the new target make compact-pdf
(at the top level or in directory ‘doc/manual’).
• There is now configure support for LLVM clang 15 on Linux, which defaults to
position-independent (PIE) executables whereas gfortran does not.
• Many small changes to ease compilation (and suppress warnings) with LLVM clang
15.
BUG FIXES:
• Rscript -e would fail if ‘stdin’ were closed (Reported by Henrik Bengtsson.)
• qt(*, log.p=TRUE) in outer tails no longer produces NaN in its final steps, thus fixing
PR#18360.
• tools::Rd2latex() now escapes hashes and ampersands when writing URLs, fixing
LaTeX errors with such URLs in \tabular.
• When isGeneric(f, fdef=*) is used with mismatching names, the warning is better
understandable; reported (with fix) in PR#18370 by Gabe Becker.
38 NEWS
CHANGES IN R 4.2.1
NEW FEATURES:
• New function utils::findCRANmirror() to find out if a CRAN mirror has been
selected, otherwise fallback to the main site. This behaves in the same way as
tools::CRAN_package_db() and is intended for packages wishing to access CRAN
for purposes other than installing packages.
The need for this was shown by a day when the main CRAN website was offline and
a dozen or so packages which had its URL hardcoded failed their checks.
INSTALLATION on a UNIX-ALIKE:
• The libraries searched for by ‘--with-blas’ (without a value) now include BLIS (after
OpenBLAS but before ATLAS). And on macOS, the Accelerate framework (after
ATLAS). (This is patterned after the AX_BLAS macro from the Autoconf Archive.)
NEWS 39
UTILITIES:
• The (full path to) the command tidy to be used for HTML validation can be set by
environment variable R_TIDYCMD.
• Setting environment variable _R_CHECK_RD_VALIDATE_RD2HTML_ to a false value will
override R CMD check --as-cran and turn off HTML validation. This provides a way
to circumvent a problematic tidy.
The 2006 version that ships with macOS is always skipped.
C-LEVEL FACILITIES:
• The undocumented legacy declarations of Sint, Sfloat, SINT_MAX and SINT_MIN in
header ‘R.h’ are deprecated.
BUG FIXES:
• [Link](d) no longer segfaults for “large” d; fixing PR#18336 by prevent-
ing/detecting an integer overflow reliably.
• tar(., files=*) now produces correctly the warning about invalid UID or GID of
files, fixing PR#18344, reported by Martin Morgan.
• tk_choose.files() with multi = FALSE misbehaved on paths containing spaces
(PR#18334) (regression introduced in R 4.0.0).
• sort(x, partial = ind, *) now works correctly notably for the non-default [Link]
= FALSE or TRUE, fixing PR#18335 reported by James Edwards.
• Environment variable _R_CHECK_XREFS_REPOSITORIES_ is only used for checking
‘.Rd’ cross-references in R CMD check (as documented) and not for other uses looking
for a CRAN mirror.
• The search for a CRAN mirror when checking packages now uses
getOption("repos") if that specifies a CRAN mirror, even when it does not
also specify all three Bioconductor repositories (as was previously required).
• The html code generated by tools::Rd2HTML() has been improved to pass tidy
5.8.0.
CHANGES IN R 4.2.0
SIGNIFICANT USER-VISIBLE CHANGES:
• The formula method of aggregate() now matches the generic in naming its first
argument x (resolving PR#18299 by Thomas Soeiro).
This means that calling aggregate() with a formula as a named first argument
requires name formula in earlier versions of R and name x now, so portable code
should not name the argument (code in many packages did).
• Calling && or || with either argument of length greater than one now gives a warning
(which it is intended will become an error).
• Calling if() or while() with a condition of length greater than one
gives an error rather than a warning. Consequently, environment variable
_R_CHECK_LENGTH_1_CONDITION_ no longer has any effect.
• Windows users should consult the WINDOWS section below for some profound
changes including
– Support for 32-bit builds has been dropped.
– UTF-8 locales are used where available.
– The default locations for the R installation and personal library folder have been
changed.
Thanks to Tomas Kalibera for months of work on the Windows port for this release.
NEW FEATURES:
• matrix(x, n, m) now warns in more cases where length(x) differs from n * m, as
suggested by Abby Spurdle and Wolfgang Huber in Feb 2021 on the R-devel mailing
list.
This warning can be turned into an error by setting environment variable
_R_CHECK_MATRIX_DATA_ to ‘TRUE’: R CMD check --as-cran does so unless it is al-
ready set.
• Function file_test() in package utils gains tests for symlinks, readability and
writability.
• capabilities("libxml") is now false.
The description of capabilities("http/ftp") now reflects that it refers to the
default method, no longer the internal one.
• simplify2array() gains an except argument for controlling the exceptions used by
sapply().
NEWS 41
• Environment variables R_LIBS_USER and R_LIBS_SITE are both now set to the R
system default if unset or empty, and can be set to NULL to indicate an empty list of
user or site library directories.
• The warning for axis()(-like) calls in cases of relatively small ranges (typically
in log-scale situations) is slightly improved and suppressed from explicit calls to
.axisPars() as has always been the intention.
• The contrasts setter function `contrasts<-` gains an explicit default [Link] =
NULL rather than just using missing([Link]).
• [Link]() gains a new optional argument n = 5.
• There is a new function .pretty() with option bounds as a technical-utility version
of pretty(). It and pretty() gain a new argument [Link] with a better than back-
compatible default.
• Function grDevices::axisTicks() and related functions such as graphics::axis()
work better, notably for the log scale; partly because of the pretty() improvements,
but also because care is taken e.g., when ylim is finite but diff(ylim) is infinite.
• [Link]() gains a digits option.
• The R Mathlib internal C function bd0() (called indirectly from a dozen probability
density and distribution functions such as dpois(), dbinom(), dgamma(), pgamma()
etc) has been complemented by a more sophisticated and (mostly) more accurate C
function ebd0(), currently called only by internal dpois_raw() improving accuracy
for R level dpois() and potentially others calling it such as dnbinom(), dgamma() or
pgamma(). (Thanks to Morten Welinder’s PR#15628.)
• [Link]() gains sep = " " argument as suggested by Thomas Soeiro.
• The names of the locale categories supported by R’s [Link]() and
[Link]() are now provided by variable .[Link] in the base names-
pace.
• The Date and POSIXt methods for hist() and the histogram method for plot() now
also use the new default col = "lightgray" in consistency with the corresponding
change to hist()’s default for R 4.0.0.
• [Link]() gains new fuzz argument, and the histogram plot method no longer
uses fractional axis ticks when displaying counts ("Frequency").
• mapply() and hence Map() now also obey the “max-or-0-if-any” recycling rule, such
that, e.g., Map(`+`, 1:3, 1[0]) is valid now.
• [Link](<obj>) for "hexmode" or "octmode" objects now fulfils the important
basic rule [Link](x)[j] === [Link](x[j]).
• The set utility functions, notably intersect() have been tweaked to be more con-
sistent and symmetric in their two set arguments, also preserving a common mode.
• substr(ch, start,end) <- new now e.g., preserves names(ch); ditto for
substring(), thanks to a patch from Brodie Gaslam.
• plot(<lm>) gains a [Link].f argument, in partial response to PR#15285;
further PR#17784 is fixed thanks to several contributors and a patch by Elin War-
ing. The Cook’s dist contours get customizable via [Link] and [Link] with
a different default color and their legend is nicer by default and customizable via
[Link].
• Attempting to subset an object that is not subsettable now signals an error of class
notSubsettableError. The non-subsettable object is contained in the object field
of the error condition.
42 NEWS
• iconv() now allows sub = "c99" to use C99-style escapes for UTF-8 inputs which
cannot be converted to encoding to.
• In a forward pipe |> expression it is now possible to use a named argument with
the placeholder _ in the rhs call to specify where the lhs is to be inserted. The
placeholder can only appear once on the rhs.
• The included LAPACK sources have been updated to version 3.10.0, except for the
four Fortran 77 routines which 3.10.0 has re-implemented in Fortran 90 (where the
older versions have been retained as the R build process does not support Fortran
90).
• [Link]() and most other uses of tilde expansion now warn if a path would be
too long if expanded. (An exception is [Link](), which silently returns false.)
• trunc(<Date>, *) now supports units = "months" or "years" for consistency with
the POSIXt method, thanks to Dirk Eddelbuettel’s proposal in PR#18099.
• list2DF() now checks that its arguments are of the same length, rather than use
recycling.
• The HTML help system has several new features: LaTeX-like math can be typeset
using either KaTeX or MathJax, usage and example code is highlighted using Prism,
and for dynamic help the output of examples and demos can be shown within the
browser if the knitr package is installed. These features can be disabled by setting
the environment variable _R_HELP_ENABLE_ENHANCED_HTML_ to a false value.
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 15 and so packages
that provide graphics devices should be reinstalled.
• The grid package now allows the user to specify a “vector” of pattern fills. The fill
argument to gpar() accepts a list of gradients and/or patterns and the functions
linearGradient(), radialGradient(), and pattern() have a new group argument.
Points grobs (data symbols) can now also have a pattern fill.
The grobCoords() function now returns a more informative and complex result.
• The grid package has new functions for drawing isolated groups: [Link](),
[Link](), and [Link](). These functions add compositing operators and
affine transformations to R’s graphics capabilities.
The grid package also has new functions for stroking and filling paths:
[Link](), [Link](), and [Link]().
A new function [Link]() allows the user to specify the fill rule for a path that
is to be used for clipping, stroking, or filling; available options are "winding" and
"evenodd". A new function [Link]() allows the user to specify the type of a mask;
available options are "alpha" and "luminance".
These new features are only supported so far (at most) on the Cairo-based graphics
devices and on the pdf() device.
• [Link]() reports on device support for the new features.
• par() now warns about unnamed non-character arguments to prevent misuse such
as {usr <- par("usr"); par(usr)}.
WINDOWS:
• R uses UTF-8 as the native encoding on recent Windows systems (at least Windows
10 version 1903, Windows Server 2022 or Windows Server 1903). As a part of this
44 NEWS
INSTALLATION:
• Facilities for accessing ‘[Link] sites are no longer tested (except pro tem for
curlGetHeaders()) as modern browsers have removed support.
• R can now be built with ‘DEFS = -DSTRICT_R_HEADERS’ .
PACKAGE INSTALLATION:
• R CMD INSTALL no longer tangles vignettes. This completes an R CMD build change in
R 3.0.0 and affects packages built before R 3.0.2. Such packages should be re-made
with R CMD build to have the tangled R code of vignettes shipped with the tarball.
• USE_FC_LEN_T will become the default: this uses the correct prototypes for Fortran
BLAS/LAPACK routines called from C/C++, and requires adjustment of most such
calls – see ‘Writing R Extensions’ §6.6.1. (This has been supported since R 3.6.2.)
• Package installation speed for packages installed with [Link] has been im-
proved. This resolve the issue reported by Ofek Shilon in PR#18236.
UTILITIES:
• R CMD check can optionally report files/directories left behind in home, ‘/tmp’ (even
though TMPDIR is set) and other directories. See the “R Internals” manual for details.
• R CMD check now reports byte-compilation errors during installation. These are not
usually fatal but may result in parts of the package not being byte-compiled.
• _R_CHECK_DEPENDS_ONLY_ can be applied selectively to examples, tests and/or vi-
gnettes in R CMD check: see the “R Internals” manual.
• _R_CHECK_SRC_MINUS_W_IMPLICIT_ now defaults to true: recent versions of Apple
clang on macOS have made implicit function declarations in C into a compilation
error.
• R CMD check --as-cran makes use of the environment variable AUTORECONF. See the
“R Internals” manual §8 for further details.
• R CMD check --use-valgrind also uses valgrind when re-building vignettes as some
non-Sweave vignettes unhelpfully comment out all their code when R CMD check runs
vignettes.
• Errors in re-building vignettes (unless there are LaTeX errors) are reported by R CMD
check as ‘ERROR’ rather than ‘WARNING’ when running vignettes has been skipped (as
it frequently is in CRAN checks and by ‘--as-cran’).
• R CMD Rd2pdf gains a ‘--quiet’ option that is used by R CMD build when building
the PDF package manual.
• R CMD Rd2pdf now always runs LaTeX in batch mode, consistent with Texinfo ≥ 6.7.
The ‘--batch’ option is ignored.
• R CMD build and R CMD check now include the Rd file name and line numbers in the
error message of an \Sexpr evaluation failure.
• For packages using the \doi Rd macro (now an install-time \Sexpr) but no other
dynamic Rd content, R CMD build now produces a smaller tarball and is considerably
faster – skipping temporary package installation.
46 NEWS
• R CMD check can optionally (but included in ‘--as-cran’) validate the HTML pro-
duced from the packages ‘.Rd’ files. See [Link]
08/enhancements-to-html-documentation/: this needs a fairly recent version of
HTML Tidy to be available.
C-LEVEL FACILITIES:
• The non-API header ‘R_ext/R-ftp-http.h’ is no longer provided, as the entry points
it covered are now all defunct.
• A number of non-API declarations and macro definitions have been moved from the
installed header ‘Rinternals.h’ to the internal header ‘Defn.h’. Packages that only
use entry points and definitions documented to be part of the API as specified in
‘Writing R Extensions’ §6 should not be affected.
• The macro USE_RINTERNALS no longer has any effect when compiling package code.
Packages which also use R_NO_REMAP will need to ensure that the remapped names
are used for calls to API functions that were formerly also made available as macros.
• The deprecated legacy S-compatibility macros PROBLEM, MESSAGE, ERROR, WARN,
WARNING, RECOVER, . . . are no longer defined in ‘R_ext/RS.h’ (included by ‘R.h’). Re-
place these by calls to Rf_error and Rf_warning (defined in header ‘R_ext/Error.h’
included by ‘R.h’).
Header ‘R_ext/RS.h’ no longer includes ‘R_ext/Error.h’.
• Header ‘R_ext/Constants.h’ (included by ‘R.h’) when included from C++ now in-
cludes the C++ header ‘cfloat’ rather than the C header ‘float.h’ (now possible
as C++11 is required).
• The legacy S-compatibility macros DOUBLE_* in ‘R_ext/Constants.h’ (included by
‘R.h’) are deprecated.
• The deprecated S-compatibility macros SINGLE_* in ‘R_ext/Constants.h’ (included
by ‘R.h’) have been removed.
• R_Calloc, R_Free and R_Realloc are preferred to their unprefixed forms and error
messages now use the prefix. These forms were introduced in R 3.4.0 and are available
even when STRICT_R_HEADERS is defined.
• rmultinom has been documented in ‘Writing R Extensions’ §6 so is now part of the
R API.
• Similarly, Rtanpi, called from R level tanpi() is now part of the R API.
• The long-deprecated, undocumented and non-API entry point call_R is no longer
declared in ‘R_ext/RS.h’ (included by ‘R.h’).
• The header ‘S.h’ which has been unsupported since Jan 2016 has been removed. Use
‘R.h’ instead.
• [Link]() now has xpinch and ypinch arguments so that the user can override
Windows’ (potentially wrong) guess at device dimensions.
• x[i] and x[[i]] for non-integer i should now behave in all cases as always docu-
mented: the index used is equivalent to [Link](i) unless that would overflow
where trunc(i) is used instead; thanks to Suharto Anggono’s report and patch pro-
posals in PR#17977.
• asOneSidedFormula() now associates the resulting formula with the global environ-
ment rather than the evaluation environment created for the call.
• <bibentry>$name now matches the field name case-insensitively, consistent with
bibentry() creation and the replacement method.
• cbind() failed to detect some length mismatches with a mixture of time-series and
non-time-series inputs.
• The default LaTeX style file ‘[Link]’ used by the RweaveLatex driver no longer
loads the obsolete ‘ae’ package; thanks to a report by Thomas Soeiro in PR#18271.
Furthermore, it now skips ‘\usepackage[T1]{fontenc}’ for engines other than pdf-
TeX (if detected) or if the new ‘[nofontenc]’ option is used.
• [Link]() now stores its logical cv argument more safely, fixing a rare bug
when printing, and also stores n.
• [Link](x,y,*) now computes the [Link] statistic correctly, also when
[Link](x), fixing PR#18294.
• The [Link] method of rbind() now warns when binding not-wholly-recycling
vectors, by analogy to the default method (for matrices).
• setAs() finds the correct class for name to when multiple packages define a class
with that name. Thanks to Gabor Csardi for the report.
• Fix for detaching a package when two classes of the same name are present in method
signatures for the same generic. Thanks to Gabor Csardi for the report.
• [Link]("", c("", "a", "B")) gives a better error message, in part from
PR#17959, thanks to Elin Waring.
• R CMD Sweave --clean no longer removes pre-existing files or subdirectories
(PR#18242).
• The quartz() device no longer splits polylines into subpaths. That has caused
narrowly-spaced lines with many points to always look solid even when dashed line
type was used due to dash phase restarts.
• Deparsing constructs such as quote(1 + `!`(2) + 3) works again as before R 3.5.0,
thanks to the report and patch in PR#18284 by Suharto Anggono.
• [Link](f) for a factor f now keeps names(f), fixing PR#18309.
• qbeta(.001, .9, .009) and analogous qf() calls now return a correct value instead
of NaN or wrongly 1, all with a warning; thanks to the report by Ludger Goeminne
in PR#18302.
• [Link]() failed to produce the plot of residuals vs. factor levels (i.e., which=5 when
leverages are constant) for models with character predictors (PR#17840).
• [Link](..., xtick = TRUE) misplaced the x-axis line (PR#18305).
• Not strictly fixing a bug, format()ing and print()ing of non-finite Date and POSIXt
values NaN and ±Inf no longer show as NA but the respective string, e.g., Inf, for
consistency with numeric vector’s behaviour, fulfilling the wish of PR#18308.
NEWS 49
• R CMD check no longer runs test scripts generated from corresponding ‘.Rin’ files
twice and now signals an ERROR if processing an ‘.Rin’ script fails.
• tools::Rd2txt() used for plain-text help pages now renders \hrefs (if
tools::Rd2txt_options(showURLs = TRUE)) and \urls with percent-encoding and
standards-compliant delimiting style (angle brackets and no ‘URL: ’ prefix). \email
is now rendered with a ‘[Link] prefix.
CHANGES IN R 4.1.3
NEW FEATURES:
• The default version of Bioconductor has been changed to 3.14. (This is used by
setRepositories and the menus in GUIs.)
UTILITIES:
• R CMD check --as-cran has a workaround for a bug in versions of file up to at least
5.41 which mis-identify DBF files last changed in 2022 as executables.
C-LEVEL FACILITIES:
• The legacy S-compatibility macros SINGLE_* in ‘R_ext/Constants.h’ (included by
‘R.h’) are deprecated and will be removed in R 4.2.0.
BUG FIXES:
• Initialization of self-starting nls() models with initialization functions following the
pre-R-4.1.0 API (without the ... argument) works again for now, with a deprecation
warning.
• Fixed quoting of ~autodetect~ in Java setting defaults to avoid inadvertent user
lookup due to leading ~, reported in PR#18231 by Harold Gutch.
• substr(., start, stop) <- v now treats negative stop values correctly. Reported
with a patch in PR#18228 by Brodie Gaslam.
• Subscripting an array x without dimnames by a length(dim(x))-column character
matrix gave "random" non-sense, now an error; reported in PR#18244 by Mikael
Jagan.
• ...names() now matches names(list(...)) closely, fixing PR#18247.
• [Link](*, scale = s) now works as intended when length(s) > 1, partly thanks
to Michael Chirico’s PR#18272.
• print(x) for long vectors x now also works for named atomic vectors or lists and
prints the correct number when reaching the getOption("[Link]") limit; partly
thanks to a report and proposal by Hugh Parsonage to the R-devel list.
• [Link](<selfStart>, *) no longer signals a deprecation warning.
• reformulate(*, response=r) gives a helpful error message now when length(r) >
1, thanks to Bill Dunlap’s PR#18281.
• Modifying globalCallingHandlers inside withCallingHandlers() now works or
fails correctly, thanks to Henrik Bengtsson’s PR#18257.
• hist(<Date>, breaks = "days") and hist(<POSIXt>, breaks = "secs") no longer
fail for inputs of length 1.
50 NEWS
• qbeta(.001, .9, .009) and similar cases now converge correctly thanks to Ben
Bolker’s report in PR#17746.
• window(x, start, end) no longer wrongly signals “’start’ cannot be after ’end” ’,
fixing PR#17527 and PR#18291.
• data() now checks that its (rarely used) list argument is a character vector – a
couple of packages passed other types and gave incorrect results.
• which() now checks its [Link] argument is TRUE rather coercing to logical and
taking the first element – which gave incorrect results in package code.
• [Link]() and [Link]() more carefully extract their model compo-
nents, thanks to Ben Bolker and Tim Taylor’s R-devel post.
• [Link](recursive = TRUE) now shows all broken symlinks (previously, some of
them may have been omitted, PR#18296).
CHANGES IN R 4.1.2
C-LEVEL FACILITIES:
• The workaround in headers ‘R.h’ and ‘Rmath.h’ (using namespace std;) for the Or-
acle Developer Studio compiler is no longer needed now C++11 is required so has
been removed. A couple more usages of log() (which should have been std::log())
with an int argument are reported on Solaris.
• The undocumented limit of 4095 bytes on messages from the S-compatibility macros
PROBLEM and MESSAGE is now documented and longer messages will be silently trun-
cated rather than potentially causing segfaults.
• If the R_NO_SEGV_HANDLER environment variable is non-empty, the signal handler for
SEGV/ILL/BUS signals (which offers recovery user interface) is not set. This allows
more reliable debugging of crashes that involve the console.
BUG FIXES:
• .mapply(F, dots, .) no longer segfaults when dots is not a list and uses
[Link](F) as always documented; reported by Andrew Simmons in PR#18164.
• hist(<Date>, ...) and hist(<POSIXt>, ...) no longer pass arguments for rect()
(such as col and density) to axis(). (Thanks to Sebastian Meyer’s PR#18171.)
• \Sexpr{ch} now preserves Encoding(ch). (Thanks to report and patch by Jeroen
Ooms in PR#18152.)
• Setting the RNG to "Marsaglia-Multicarry" e.g., by RNGkind(), now warns in
more places, thanks to André Gillibert’s report and patch in PR#18168.
• gray(numeric(), alpha=1/2) no longer segfaults, fixing PR#18183, reported by Till
Krenz.
• Fixed dnbinom(x, size=<very_small>, .., log=TRUE) regression, reported by
Martin Morgan.
NEWS 51
CHANGES IN R 4.1.1
NEW FEATURES:
• require(pkg, quietly = TRUE) is quieter and in particular does not warn if the
package is not found.
INSTALLATION:
• make check now works also without a LaTeX installation. (Thanks to Sebastian
Meyer’s PR#18103.)
BUG FIXES:
• make check-devel works again in an R build configured with
‘--without-recommended-packages’.
• qnbinom(p, size, mu) for large size/mu is correct now in a range of cases
(PR#18095); similarly for the (size, prob) parametrization of the negative bino-
mial. Also qpois() and qbinom() are better and or faster for extreme cases. The
underlying C code has been modularized and is common to all four cases of discrete
distributions.
52 NEWS
• [Link] is now part of the axis() arguments which are passed from bxp(), and
hence boxplot(). (Thanks to Martin Smith’s report and suggestions in PR#18109.)
• .First and .Last can again be set from the site profile.
• [Link](from, to, *) and [Link](..) now work better in large range cases
where from-to is infinite where the two boundaries are finite.
• [Link](x,y) now returns TRUE correctly also when several entries of abs(x) and
abs(y) are close to .Machine$[Link], the largest finite numeric.
• [Link]() now clears the object bit when removing the class attribute of a
value via [Link] (PR#18100).
• charClass() now works with multi-character strings on Windows (PR#18104, fixed
by Bill Dunlap).
• encodeString() on Solaris now works again in Latin-1 encoding on characters repre-
sented differently in UTF-8. Support for surrogate pairs on Solaris has been improved.
• [Link]() on Windows now works with non-ASCII path names representable in
the current native encoding (PR#18132).
• Embedded R on Windows can now find R home directory via the registry even when
installed only for the current user (PR#18135).
• pretty(x) with finite x now returns finite values also in the case where the extreme x
values are close in size to the maximal representable number .Machine$[Link].
Also, it’s been tweaked for very small ranges and when a boundary is close (or equal)
to zero; e.g., pretty(c(0,1e-317)) no longer has negative numbers, currently still
warning about a very small range, and pretty(2^-(1024 - 2^-1/(c(24,10)))) is
more accurate.
• The error message for not finding vignette files when weaving has correct file sizes
now. (Thanks to Sebastian Meyer’s PR#18154.)
• dnbinom(20, <large>, 1) now correctly gives 0, and similar cases are more accurate
with underflow precaution. (Reported by Francisco Vera Alcivar in PR#18072.)
CHANGES IN R 4.1.0
FUTURE DIRECTIONS:
• It is planned that the 4.1.x series will be the last to support 32-bit Windows, with
production of binary packages for that series continuing until early 2023.
NEW FEATURES:
• ‘[Link]’ is no longer one of the repositories known by default to
setRepositories(). (Nowadays it only provides source packages and is often un-
available.)
• Function package_dependencies() (in package tools) can now use different depen-
dency types for direct and recursive dependencies.
NEWS 53
• The checking of the size of tarball in R CMD check --as-cran <pkg> may be tweaked
via the new environment variable _R_CHECK_CRAN_INCOMING_TARBALL_THRESHOLD_,
as suggested in PR#17777 by Jan Gorecki.
• Using c() to combine a factor with other factors now gives a factor, an ordered factor
when combining ordered factors with identical levels.
• apply() gains a simplify argument to allow disabling of simplification of results.
• The format() method for class "ftable" gets a new option justify. (Suggested by
Thomas Soeiro.)
• New ...names() utility. (Proposed by Neal Fultz in PR#17705.)
• [Link]() now warns when its [Link] argument is not specified, as the help
file always said it should. In that case, the default is changed to TRUE in line with its
change in [Link]() (related to stringsAsFactors) in R 4.0.0.
• When printing list arrays, classed objects are now shown via their format() value if
this is a short enough character string, or by giving the first elements of their class
vector and their length.
• capabilities() gets new entry "Rprof" which is TRUE when R has been configured
with the equivalent of --enable-R-profiling (as it is by default). (Related to
Michael Orlitzky’s report PR#17836.)
• str(xS4) now also shows extraneous attributes of an S4 object xS4.
• Rudimentary support for vi-style tags in rtags() and R CMD rtags has been added.
(Based on a patch from Neal Fultz in PR#17214.)
• checkRdContents() is now exported from tools; it and also checkDocFiles() have a
new option chkInternal allowing to check Rd files marked with keyword "internal"
as well. The latter can be activated for R CMD check via environment variable
_R_CHECK_RD_INTERNAL_TOO_.
• New functions numToBits() and numToInts() extend the raw conversion utilities to
(double precision) numeric.
• Functions URLencode() and URLdecode() in package utils now work on vectors of
URIs. (Based on patch from Bob Rudis submitted with PR#17873.)
• [Link]() can expand ‘~user’ on most Unix-alikes even when readline is not
in use. It tries harder to expand ‘~’, for example should environment variable HOME
be unset.
• For HTML help (both dynamic and static), Rd file links to help pages in external
packages are now treated as references to topics rather than file names, and fall back
to a file link only if the topic is not found in the target package. The earlier rule
which prioritized file names over topics can be restored by setting the environment
variable _R_HELP_LINKS_TO_TOPICS_ to a false value.
• c() now removes NULL arguments before dispatching to methods, thus simplifying the
implementation of c() methods, but for back compatibility keeps NULL when it is the
first argument. (From a report and patch proposal by Lionel Henry in PR#17900.)
• Vectorize()’s result function’s environment no longer keeps unneeded objects.
• Function ...elt() now propagates visibility consistently with ..n. (Thanks to Lionel
Henry’s PR#17905.)
• [Link]() no longer uses non-standard evaluation to evaluate its arguments.
This makes evaluation of functions like [Link]() more consistent. (Thanks
to Lionel Henry’s PR#17907.)
54 NEWS
• New function gregexec() which generalizes regexec() to find all disjoint matches
and all substrings corresponding to parenthesized subexpressions of the given regular
expression. (Contributed by Brodie Gaslam.)
• New function charClass() in package utils to query the wide-character classification
functions in use (such as iswprint).
• The names of quantile()’s result no longer depend on the global
getOption("digits"), but quantile() gets a new optional argument digits
= 7 instead.
• grep(), sub(), regexp and variants work considerably faster for long factors with
few levels. (Thanks to Michael Chirico’s PR#18063.)
• Provide grouping of x11() graphics windows within a window manager such as Gnome
or Unity; thanks to a patch by Ivan Krylov posted to R-devel.
• The split() method for class [Link] now allows the f argument to be specified
as a formula.
• sprintf now warns on arguments unused by the format string.
• New palettes "Rocket" and "Mako" for [Link]() (approximating palettes of the
same name from the viridisLite package).
Contributed by Achim Zeileis.
• The base environment and its namespace are now locked (so one can no longer add
bindings to these or remove from these).
• Rterm handling of multi-byte characters has been improved, allowing use of such
characters when supported by the current locale.
• Rterm now accepts ALT+ +xxxxxxxx sequences to enter Unicode characters as hex
digits.
• Environment variable LC_ALL on Windows now takes precedence over LC_CTYPE and
variables for other supported categories, matching the POSIX behaviour.
• duplicated() and anyDuplicated() are now optimized for integer and real vectors
that are known to be sorted via the ALTREP framework. Contributed by Gabriel
Becker via PR#17993.
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 14 and so packages
that provide graphics devices should be reinstalled.
• Graphics devices should now specify deviceVersion to indicate what version of the
graphics engine they support.
• Graphics devices can now specify deviceClip. If TRUE, the graphics engine will never
perform any clipping of output itself.
The clipping that the graphics engine does perform (for both canClip = TRUE and
canClip = FALSE) has been improved to avoid producing unnecessary artifacts in
clipped output.
• The grid package now allows gpar(fill) to be a linearGradient(), a
radialGradient(), or a pattern(). The viewport(clip) can now also be a grob,
which defines a clipping path, and there is a new viewport(mask) that can also be a
grob, which defines a mask.
These new features are only supported so far on the Cairo-based graphics devices and
on the pdf() device.
56 NEWS
• (Not Windows.) A warning is given when a Cairo-based type is specified for a png(),
jpeg(), tiff() or bmp() device but Cairo is unsupported (so type = "Xlib" is tried
instead).
• grSoftVersion() now reports the versions of FreeType and FontConfig if they are
used directly (not via Pango), as is most commonly done on macOS.
C-LEVEL FACILITIES:
• The standalone ‘libRmath’ math library and R’s C API now provide log1pexp()
again as documented, and gain log1mexp().
INSTALLATION on a UNIX-ALIKE:
• configure checks for a program pkgconf if program pkg-config is not found. These
are now only looked for on the path (like almost all other programs) so if needed
specify a full path to the command in PKG_CONFIG, for example in file ‘[Link]’.
• C99 function iswblank is required – it was last seen missing ca 2003 so the workaround
has been removed.
• There are new configure options ‘--with-internal-iswxxxxx’,
‘--with-internal-towlower’ and ‘--with-internal-wcwidth’ which allows
the system functions for wide-character classification, case-switching and width
(wcwidth and wcswidth) to be replaced by internal ones. The first has long been
used on macOS, AIX (and Windows) but this enables it to be unselected there and
selected for other platforms (it is the new default on Solaris). The second is new in
this version of R and is selected by default on macOS and Solaris. The third has
long been the default and remains so as it contains customizations for East Asian
languages.
System versions of these functions are often minimally implemented (sometimes only
for ASCII characters) and may not cover the full range of Unicode points: for example
Solaris (and Windows) only cover the Basic Multilingual Plane.
• Cairo installations without X11 are more likely to be detected by configure, when
the file-based Cairo graphics devices will be available but not X11(type = "cairo").
• There is a new configure option ‘--with-static-cairo’ which is the default on
macOS. This should be used when only static cairo (and where relevant, Pango)
libraries are available.
• Cairo-based graphics devices on platforms without Pango but with
FreeType/FontConfig will make use of the latter for font selection.
BUILDING R on Windows:
• for GCC ≥ 8, FC_LEN_T is defined in ‘config.h’ and hence character lengths are
passed from C to Fortran in inter alia BLAS and LAPACK calls.
NEWS 57
PACKAGE INSTALLATION:
• The default C++ standard has been changed to C++14 where available (which it
is on all currently checked platforms): if not (as before) C++11 is used if available
otherwise C++ is not supported.
Packages which specify C++11 will still be installed using C++11.
C++14 compilers may give deprecation warnings, most often for
std::random_shuffle (deprecated in C++14 and removed in C++17). Ei-
ther specify C++11 (see ‘Writing R Extensions’) or modernize the code and if
needed specify C++14. The latter has been supported since R 3.4.0 so the package’s
‘DESCRIPTION’ would need to include something like
Depends: R (>= 3.4)
UTILITIES:
• R CMD check can now scan package functions for bogus return statements, which
were possibly intended as return() calls (wish of PR#17180, patch by Sebas-
tian Meyer). This check can be activated via the new environment variable
_R_CHECK_BOGUS_RETURN_, true for --as-cran.
58 NEWS
• R CMD build omits tarballs and binaries of previous builds from the top-level package
directory. (PR#17828, patch by Sebastian Meyer.)
• R CMD check now runs sanity checks on the use of ‘LazyData’, for example that a
‘data’ directory is present and that ‘LazyDataCompression’ is not specified without
‘LazyData’ and has a documented value. For packages with large LazyData databases
without specifying ‘LazyDataCompression’, there is a reference to the code given in
‘Writing R Extensions’ §1.1.6 to test the choice of compression (as in all the CRAN
packages tested a non-default method was preferred).
• R CMD build removes ‘LazyData’ and ‘LazyDataCompression’ fields from the
‘DESCRIPTION’ file of packages without a ‘data’ directory.
ENCODING-RELATED CHANGES:
• The parser now treats ‘\Unnnnnnnn’ escapes larger than the upper limit for Unicode
points (‘\U10FFFF’) as an error as they cannot be represented by valid UTF-8.
Where such escapes are used for outputting non-printable (including unassigned)
characters, 6 hex digits are used (rather than 8 with leading zeros). For clarity,
braces are used, for example ‘\U{0effff}’.
• The parser now looks for non-ASCII spaces on Solaris (as previously on most other
OSes).
• There are warnings (including from the parser) on the use of unpaired surrogate
Unicode points such as ‘\uD834’. (These cannot be converted to valid UTF-8.)
• Functions nchar(), tolower(), toupper() and chartr() and those using regular
expressions have more support for inputs with a marked Latin-1 encoding.
• The character-classification functions used (by default) to replace the system
iswxxxxx functions on Windows, macOS and AIX have been updated to Unicode
13.0.0.
The character-width tables have been updated to include new assignments in Unicode
13.0.0. This included treating all control characters as having zero width.
• The code for evaluating default (extended) regular expressions now uses the same
character-classification functions as the rest of R (previously they differed on Win-
dows, macOS and AIX).
• There is a build-time option to replace the system’s wide-character wctrans C func-
tion by tables shipped with R: use configure option ‘--with-internal-towlower’
or (on Windows) ‘-DUSE_RI18N_CASE’ in ‘CFLAGS’ when building R. This may be
needed to allow tolower() and toupper() to work with Unicode characters beyond
the Basic Multilingual Plane where not supported by system functions (e.g. on Solaris
where it is the new default).
• R is more careful when truncating UTF-8 and other multi-byte strings that are too
long to be printed, passed to the system or libraries or placed into an internal buffer.
Truncation will no longer produce incomplete multibyte characters.
• unsplit() had trouble with tibbles due to unsound use of rep(NA, len)-indexing,
which should use NA_integer_ (Reported to R-devel by Mario Annau.)
• pnorm(x, log.p = TRUE) underflows to -Inf slightly later.
• show(<hidden S4 generic>) prints better and without quotes for non-hidden S4
generics.
• [Link]() and relatives treated an "NA" column name as missing when
[Link] = FALSE PR#18007.
• Parsing strings containing UTF-16 surrogate pairs such as "\uD834\uDD1E"
works better on some (uncommon) platforms. sprintf("%X",
utf8ToInt("\uD834\uDD1E")) should now give "1D11E" on all platforms.
• identical(x,y) is no longer true for differing DOTSXP objects, fixing PR#18032.
• str() now works correctly for DOTSXP and related exotics, even when these are
doomed.
Additionally, it no longer fails for lists with a class and “irregular” method defini-
tions such that e.g. lapply(*) will necessarily fail, as currently for different igraph
objects.
• Message translation domains, e.g., for errors and warnings, are now correctly deter-
mined also when e.g., a base function is called from “top-level” function (i.e., defined
in globalenv()), thanks to a patch from Joris Goosen fixing PR#17998.
• Too long lines in environment files (e.g., ‘Renviron’) no longer crash R. This limit
has been increased to 100,000 bytes. (PR#18001.)
• There is a further workaround for FreeType giving incorrect italic font faces with
cairo-based graphics devices on macOS.
• add_datalist(*, force = TRUE) (from package tools) now actually updates an exist-
ing ‘data/datalist’ file for new content. (Thanks to a report and patch by Sebastian
Meyer in PR#18048.)
• [Link]() and [Link]() could produce an empty last interval for breaks =
"months" or breaks = "years". (Reported as PR#18053 by Christopher Carbone.)
• Detection of the encoding of ‘regular’ macOS locales such as ‘en_US’ (which is UTF-
8) had been broken by a macOS change: fortunately these are now rarely used with
‘en_US.UTF-8’ being preferred.
• sub() and gsub(pattern, repl, x, *) now keep attributes of x such as names()
also when pattern is NA (PR#18079).
• Time differences ("difftime" objects) get a replacement and a rep() method to keep
"units" consistent. (Thanks to a report and patch by Nicolas Bennett in PR#18066.)
• The \RdOpts macro, setting defaults for \Sexpr options in an Rd file, had been
ineffective since R 2.12.0: it now works again. (Thanks to a report and patch by
Sebastian Meyer in PR#18073.)
• mclapply and pvec no longer accidentally terminate parallel processes started before
by mcparallel or related calls in package parallel (PR#18078).
• grep and other functions for evaluating (extended) regular expressions handle in
Unicode also strings not explicitly flagged UTF-8, but flagged native when running
in UTF-8 locale.
• Fixed a crash in fifo implementation on Windows (PR#18031).
• Binary mode in fifo on Windows is now properly detected from argument open
(PR#15600, PR#18031).
NEWS 61
CHANGES IN R 4.0.5
BUG FIXES:
• The change to the internal table in R 4.0.4 for iswprint has been reverted: it con-
tained some errors in printability of ‘East Asian’ characters.
• For packages using ‘LazyData’, R CMD build ignored the ‘--resave-data’ option and
the ‘BuildResaveData’ field of the ‘DESCRIPTION’ file (in R versions 4.0.0 to 4.0.4).
CHANGES IN R 4.0.4
NEW FEATURES:
• File ‘share/texmf/tex/latex/[Link]’ has been updated to work with LaTeX ver-
sions since Oct 2020.
• Unicode character width tables (as used by nchar(, type = "w")) have been updated
to Unicode 12.1 by Brodie Gaslam (PR#17781), including many emoji.
• The internal table for iswprint (used on Windows, macOS and AIX) has been up-
dated to include many recent Unicode characters.
INSTALLATION on a UNIX-ALIKE:
• If an external BLAS is specified by ‘--with-blas=foo’ or via environment vari-
able BLAS_LIBS is not found, this is now a configuration error. The previous be-
haviour was not clear from the documentation: it was to continue the search as if
‘--with-blas=yes’ was specified.
BUG FIXES:
• [Link](x,y) now “sees” the two different NAs in factors, thanks to Bill Dunlap
and others in PR#17897.
• (~ NULL)[1] and similar formula subsetting now works, thanks to a report and patch
by Henrik Bengtsson in PR#17935. Additionally, subsetting leaving an empty for-
mula now works too, thanks to suggestions by Suharto Anggono.
• .traceback(n) keeps source references again, as before R 4.0.0, fixing a regression;
introduced by the PR#17580, reported including two patch proposals by Brodie
Gaslam.
• unlist(plst, recursive=FALSE) no longer drops content for pairlists with list com-
ponents, thanks to the report and patch by Suharto Anggono in PR#17950.
• iconvlist() now also works on MUSL based (Linux) systems, from a report and
patch suggestion by Wesley Chan in PR#17970.
• round() and signif() no longer tolerate wrong argument names, notably in 1-
argument calls; reported by Shane Mueller on R-devel (mailing list); later reported
as PR#17976.
• .Machine has longdouble.* elements only if capabilities("[Link]") is true,
as documented. (Previously they were included if the platform had long double
identical to double, as ARM does.)
• [Link](numeric(), n=0) now works, fixing PR#18002.
62 NEWS
• identical(x,y) no longer prints "Unknown Type .." for typeof(x) == "..." ob-
jects.
• Fix (auto-)print()ing of named complex vectors, see PR#17868 and PR#18019.
• [Link](<language>, <...>) now works, fixing PR#18029.
• [Link](L, [Link]=NULL) now behaves in line with [Link](),
disregarding names of components of L, fixing PR#18034, reported by Kevin Tappe.
• checkRdaFiles(ff)$version is now correct also when ff contains files of different
versions, thanks to a report and patch from Sebastian Meyer in PR#18041.
• macOS: Quartz device live drawing could fail (no plot is shown) if the system changes
the drawing context after view update (often the case since macOS Big Sur). System
log may show "CGContextDelegateCreateForContext: invalid context" error.
CHANGES IN R 4.0.3
NEW FEATURES:
• On platforms using configure option ‘--with-internal-tzcode’, additional values
"internal" and (on macOS only) "macOS" are accepted for the environment variable
TZDIR. (See ?TZDIR.)
On macOS, "macOS" is used by default if the system timezone database is a newer
version than that in the R installation.
• When [Link](type = "source") fails to find a package in a repository
it mentions package versions which are excluded by their R version requirement and
links to hints on why a package might not be found.
• The default value for options("timeout") can be set from environment variable
R_DEFAULT_INTERNET_TIMEOUT, still defaulting to 60 (seconds) if that is not set or
invalid.
This may be needed when child R processes are doing downloads, for example during
the installation of source packages which download jars or other forms of data.
BUG FIXES:
• The code mitigating stack overflow with PCRE regexps on very long strings is enabled
for PCRE2 < 10.30 also when JIT is enabled, since stack overflows have been seen in
that case.
NEWS 63
• Fix to correctly show the group labels in dotchart() (which where lost in the ylab
improvement for R 4.0.0).
• addmargins(*, ..) now also works when fn() is a local function, thanks to bug
report and patch PR#17124 from Alex Bertram.
• rank(x) and hence sort(x) now work when x is an object (as per [Link](x)) of
type "raw" and provides a valid `[` method, e.g., for gmp::[Link](.) numbers.
• [Link](*, [Link]=TRUE) and r2dtable() now work correctly for
large table entries (in the millions). Reported by Sebastian Meyer and investigated
by more helpers in PR#16184.
• Low-level socket read/write operations have been fixed to correctly signal communi-
cation errors. Previously, such errors could lead to a segfault due to invalid memory
access. Reported and debugged by Dmitriy Selivanov in PR#17850.
• quantile(x, pr) works more consistently for pr values slightly outside [0,1], thanks
to Suharto Anggono’s PR#17891.
Further, quantile(x, prN, names=FALSE) now works even when prN contains NAs,
thanks to Anggono’s PR#17892. Ditto for ordered factors or Date objects when type
= 1 or 3, thanks to PR#17899.
• Internet access based on libcurl, including curlGetHeaders(), was not respecting
the "timeout" option. If this causes unanticipated timeouts, consider increasing the
default by setting R_DEFAULT_INTERNET_TIMEOUT.
• [Link](<char>) now also works with an initial "", thanks to Michael Chirico’s
PR#17909.
• isS3stdGeneric(f) now detects an S3 generic also when it is trace()d, thanks to
Gabe Becker’s PR#17917.
• R_allocLD() has been fixed to return memory aligned for long double type
PR#16534.
• [Link]() no longer segfaults when called again after its internal stack has been
exceeded PR#17904.
• Accessing a long vector represented by a compact integer sequence no longer segfaults
(reported and debugged by Hugh Parsonage).
• duplicated() now works also for strings with multiple encodings inside a single
vector PR#17809.
• phyper(11, 15, 0, 12, log.p=TRUE) no longer gives NaN; reported as PR#17271 by
Alexey Stukalov.
• Fix incorrect calculation in [Link]() PR#16100, patch from Sebastian Meyer.
• A very old bug could cause a segfault in [Link]() when terms involved logical
variables. Part of PR#17879.
• [Link]() allowed data = 1, leading to involuntary variable capture
(rest of PR#17879).
• tar() no longer skips non-directory files, thanks to a patch by Sebastian Meyer, fixing
the remaining part of PR#16716.
CHANGES IN R 4.0.2
UTILITIES:
64 NEWS
BUG FIXES:
• Paths with non-ASCII characters caused problems for package loading on Windows
PR#17833.
• Using tcltk widgets no longer crashes R on Windows.
• source(*, echo=TRUE) no longer fails in some cases with empty lines; reported by
Bill Dunlap in PR#17769.
• [Link]() now correctly matches named arguments, thanks to PR#17815 (including
patch) by Brodie Gaslam.
• regexpr(*, perl=TRUE) no longer returns incorrect positions into text containing
characters outside of the Unicode Basic Multilingual Plane on Windows.
CHANGES IN R 4.0.1
NEW FEATURES:
• paste() and paste0() gain a new optional argument recycle0. When set to
true, zero-length arguments are recycled leading to character(0) after the sep-
concatenation, i.e., to the empty string "" if collapse is a string and to the zero-
length value character(0) when collapse = NULL.
A package whose code uses this should depend on ‘R (>= 4.0.1)’.
• The summary(<warnings>) method now maps the counts correctly to the warning
messages.
BUG FIXES:
• aov(frml, ...) now also works where the formula deparses to more than 500 char-
acters, thanks to a report and patch proposal by Jan Hauffa.
• Fix a dozen places (code, examples) as [Link]() returns the new rather than
the previous setting.
• Fix for adding two complex grid units via sum(). Thanks to Gu Zuguang for the
report and Thomas Lin Pedersen for the patch.
• Fix parallel::mclapply(..., [Link]=FALSE) to handle raw vector re-
sults correctly. PR#17779
• Computing the base value, i.e., 2, “everywhere”, now uses FLT_RADIX, as the original
‘machar’ code looped indefinitely on the ppc64 architecture for the longdouble case.
• In R 4.0.0, [Link](x) when [Link](x) was true, e.g., for x <- I(letters),
was accidentally using method = "radix". Consequently, e.g., merge(<[Link]>)
was much slower than previously; reported in PR#17794.
• plot(y ~ x, ylab = quote(y[i])) now works, as e.g., for xlab; related to
PR#10525.
• parallel::[Link]([Link] = TRUE) tries a matching OS name before the
other tests (which were intended only for unknown OSes).
• Parse data for raw strings is now recorded correctly. Reported by Gabor Csardi.
NEWS 65
CHANGES IN R 4.0.0
SIGNIFICANT USER-VISIBLE CHANGES:
• Packages need to be (re-)installed under this version (4.0.0) of R.
• matrix objects now also inherit from class "array", so e.g., class(diag(1))
is c("matrix","array"). This invalidates code incorrectly assuming that
class(matrix_obj)) has length one.
S3 methods for class "array" are now dispatched for matrix objects.
• There is a new syntax for specifying raw character constants similar to the one used
in C++: r"(...)" with ... any character sequence not containing the sequence
‘)"’. This makes it easier to write strings that contain backslashes or both single and
double quotes. For more details see ?Quotes.
• R now uses a ‘stringsAsFactors = FALSE’ default, and hence by default no longer
converts strings to factors in calls to [Link]() and [Link]().
A large number of packages relied on the previous behaviour and so have needed/will
need updating.
• The plot() S3 generic function is now in package base rather than package graphics,
as it is reasonable to have methods that do not use the graphics package. The generic
is currently re-exported from the graphics namespace to allow packages importing it
from there to continue working, but this may change in future.
Packages which define S4 generics for plot() should be re-installed and package code
using such generics from other packages needs to ensure that they are imported rather
than rely on their being looked for on the search path (as in a namespace, the base
namespace has precedence over the search path).
REFERENCE COUNTING:
• Reference counting is now used instead of the NAMED mechanism for determining when
objects can be safely mutated in base C code. This reduces the need for copying in
some cases and should allow further optimizations in the future. It should help make
the internal code easier to maintain.
This change is expected to have almost no impact on packages using supported coding
practices in their C/C++ code.
MIGRATION TO PCRE2:
• This version of R is built against the PCRE2 library for Perl-like regular expressions,
if available. (On non-Windows platforms PCRE1 can optionally be used if PCRE2
is not available at build time.) The version of PCRE in use can be obtained via
extSoftVersion(): PCRE1 (formerly known as ‘PCRE’) has versions <= 8, PCRE2
versions >= 10.
• Making PCRE2 available when building R from source is strongly recommended
(preferably version 10.30 or later) as PCRE1 is no longer developed: version 8.44
is ‘likely to be the final release’.
• PCRE2 reports errors for some regular expressions that were accepted by PCRE1.
A hyphen now has to be escaped in a character class to be interpreted as a literal
(unless first or last in the class definition). ‘\R’, ‘\B’ and ‘\X’ are no longer allowed
in character classes (PCRE1 treated these as literals).
66 NEWS
• Option PCRE_study is no longer used with PCRE2, and is reported as FALSE when
that is in use.
NEW FEATURES:
• assertError() and assertWarning() (in package tools) can now check for specific
error or warning classes via the new optional second argument classes (which is not
back compatible with previous use of an unnamed second argument).
• DF2formula(), the utility for the data frame method of formula(), now works with-
out parsing and explicit evaluation, starting from Suharto Anggono’s suggestion in
PR#17555.
• approxfun() and approx() gain a new argument [Link] defaulting to true. If set to
false, missing y values now propagate into the interpolated values.
• Long vectors are now supported as the seq argument of a for() loop.
• str(x) gets a new [Link] option with a default to speed it up when x is a
large call object.
• The internal traceback object produced when an error is signalled (.Traceback),
now contains the calls rather than the deparse()d calls, deferring the deparsing
to the user-level functions .traceback() and traceback(). This fulfils the wish of
PR#17580, reported including two patch proposals by Brodie Gaslam.
• [Link]() now converts character columns to factors and from this to integers.
• [Link]() now explicitly lists all exports in the ‘NAMESPACE’ file.
• New function .S3method() to register S3 methods in R scripts.
• [Link]() has some support for file paths not in the session encoding, e.g. with
UTF-8 inputs in a non-UTF-8 locale the output is marked as UTF-8.
• Most functions with file-path inputs will give an explicit error if a file-path input in
a marked encoding cannot be translated (to the native encoding or in some cases
on Windows to UTF-8), rather than translate to a different file path using es-
capes. Some (such as [Link](), [Link](), [Link](), [Link](),
[Link](), normalizePath() and [Link]()) treat this like any other non-
existent file, often with a warning.
• There is a new help document accessed by help("file path encoding") detailing
how file paths with marked encodings are handled.
• New function list2DF() for creating data frames from lists of variables.
• iconv() has a new option sub = "Unicode" to translate UTF-8 input invalid in the
‘to’ encoding using ‘<U+xxxx>’ escapes.
• There is a new function infoRDS() providing information about the serialization
format of a serialized object.
• S3 method lookup now by default skips the elements of the search path between the
global and base environments.
• Added an argument add_datalist(*, [Link] = 0) to allow the creation of a
‘data/datalist’ file even when the total size of the data sets is small.
• The backquote function bquote() has a new argument splice to enable splicing a
computed list of values into an expression, like ,@ in LISP’s backquote.
• The formula interface to [Link]() and [Link]() has been extended to handle
one-sample and paired tests.
NEWS 67
• The palette() function has a new default set of colours (which are less saturated
and have better accessibility properties). There are also some new built-in palettes,
which are listed by the new [Link]() function. These include the old default
palette under the name "R3". Finally, the new [Link]() function allows a
subset of colours to be selected from any of the built-in palettes.
• n2mfrow() gains an option asp = 1 to specify the aspect ratio, fulfilling the wish and
extending the proposal of Michael Chirico in PR#17648.
• For head(x, n) and tail() the default and other S3 methods notably for vector n,
e.g. to get a “corner” of a matrix, has been extended to array’s of higher dimension
thanks to the patch proposal by Gabe Becker in PR#17652. Consequently, optional
argument addrownums is deprecated and replaced by the (more general) argument
keepnums. An invalid second argument n now leads to typically more easily readable
error messages.
• New function .class2() provides the full character vector of class names used for S3
method dispatch.
• Printing methods(..) now uses a new format() method.
• [Link](x) now works for non-atomic objects x and method = "auto" (the default)
or "radix" in cases order(x) works, typically via a xtfrm() method.
• Where they are available, writeBin() allows long vectors.
• New function deparse1() produces one string, wrapping deparse(), to be used typ-
ically in deparse1(substitute(*)), e.g., to fix PR#17671.
• [Link]() enhancements: In the (non-paired) two-sample case, Inf values are
treated as very large for robustness consistency. If exact computations are used, the
result now has "exact" in the method element of its return value. New arguments
[Link] and [Link] where the latter may be used for stability to treat very
close numbers as ties.
• readBin() and writeBin() now report an error for an invalid endian value. The
affected code needs to be fixed with care as the old undocumented behavior was to
swap endianness in such cases.
• sequence() is now an S3 generic with an internally implemented default method,
and gains arguments to generate more complex sequences. Based on code from the
S4Vectors Bioconductor package and the advice of Hervé Pagès.
• print()’s default method and many other methods (by calling the default eventually
and passing ...) now make use of a new optional width argument, avoiding the need
for the user to set and reset options("width").
• memDecompress() supports the RFC 1952 format (e.g. in-memory copies of gzip-
compressed files) as well as RFC 1950.
• memCompress() and memDecompress() support long raw vectors for types "gzip" and
"zx".
• sweep() and [Link]() can now use names of dimnames for their MARGIN argu-
ment (apply has had this for almost a decade).
• New function proportions() and marginSums(). These should replace the unfortu-
nately named [Link]() and [Link](). They are drop-in replacements,
but also add named-margin functionality. The old function names are retained as
aliases for back-compatibility.
• Functions rbinom(), rgeom(), rhyper(), rpois(), rnbinom(), rsignrank() and
rwilcox() which have returned integer since R 3.0.0 and hence NA when the numbers
68 NEWS
would have been outside the integer range, now return double vectors (without NAs,
typically) in these cases.
• matplot(x,y) (and hence matlines() and matpoints()) now call the corresponding
methods of plot() and lines(), e.g, when x is a "Date" or "POSIXct" object;
prompted by Spencer Graves’ suggestion.
• stopifnot() now allows customizing error messages via argument names, thanks to
a patch proposal by Neal Fultz in PR#17688.
• unlink() gains a new argument expand to disable wildcard and tilde expansion.
Elements of x of value "~" are now ignored.
• mle() in the stats4 package has had its interface extended so that arguments to the
negative log-likelihood function can be one or more vectors, with similar conventions
applying to bounds, start values, and parameter values to be kept fixed. This required
a minor extension to class "mle", so saved objects from earlier versions may need to
be recomputed.
• The default for pdf() is now useDingbats = FALSE.
• The default fill colour for hist() and boxplot() is now col = "lightgray".
• The default order of the levels on the y-axis for spineplot() and cdplot() has been
reversed.
• If the R_ALWAYS_INSTALL_TESTS environment variable is set to a true value, R CMD
INSTALL behaves as if the ‘--install-tests’ option is always specified. Thanks to
Reinhold Koch for the suggestion.
• New function R_user_dir() in package tools suggests paths appropriate for storing
R-related user-specific data, configuration and cache files.
• capabilities() gains a new logical option Xchk to avoid warnings about X11-related
capabilities.
• The internal implementation of grid units has changed, but the only visible effects at
user-level should be
– a slightly different print format for some units (especially unit arithmetic),
– faster performance (for unit operations) and
– two new functions unitType() and [Link]().
Based on code contributed by Thomas Lin Pedersen.
• When internal dispatch for [Link]() and rep_len() fails, there is an attempt to
dispatch on the equivalent call to rep().
• Object .Machine now contains new longdouble.* entries (when R uses long doubles
internally).
• news() has been enhanced to cover the news on R 3.x and 2.x.
• For consistency, N <- NULL; N[[1]] <- val now turns N into a list also when val)
has length one. This enables dimnames(r1)[[1]] <- "R1" for a 1-row matrix r1,
fixing PR#17719 reported by Serguei Sokol.
• deparse(..), dump(..), and dput(x, control = "all") now include control option
"digits17" which typically ensures 1:1 invertibility. New option control = "exact"
ensures numeric exact invertibility via "hexNumeric".
• When loading data sets via [Link](), data() now uses ‘LC_COLLATE=C’ to ensure
locale-independent results for possible string-to-factor conversions.
NEWS 69
Windows:
• Rterm now works also when invoked from MSYS2 terminals. Line editing is possible
when command winpty is installed.
• normalizePath() now resolves symbolic links and normalizes case of long names of
path elements in case-insensitive folders (PR#17165).
• md5sum() supports UTF-8 file names with characters that cannot be translated to
the native encoding (PR#17633).
• Rterm gains a new option ‘--workspace’ to specify the workspace to be restored.
This allows equals to be part of the name when opening via Windows file associations
(reported by Christian Asseburg).
• Rterm now accepts ALT+xxx sequences also with NumLock on. Tilde can be pasted
with an Italian keyboard (PR#17679).
• R falls back to copying when junction creation fails during package checking (patch
from Duncan Murdoch).
C-LEVEL FACILITIES:
• installChar is now remapped in ‘Rinternals.h’ to installTrChar, of which it
has been a wrapper since R 3.6.0. Neither are part of the API, but packages using
installChar can replace it if they depend on ‘R >= 3.6.2’.
• Header ‘R_ext/Print.h’ defines ‘R_USE_C99_IN_CXX’ and hence exposes Rvprintf
and REvprintf if used with a C++11 (or later) compiler.
• There are new Fortran subroutines dblepr1, realpr1 and intpr1 to print a scalar
variable (gfortran 10 enforces the distinction between scalars and length-one arrays).
Also labelpr to print just a label.
• R_withCallingErrorHandler is now available for establishing a calling handler in C
code for conditions inheriting from class error.
INSTALLATION on a UNIX-ALIKE:
• User-set ‘DEFS’ (e.g., in ‘[Link]’) is now used for compiling packages (including
base packages).
• There is a new variant option ‘--enable-lto=check’ for checking consistency of
BLAS/LAPACK/LINPACK calls — see ‘Writing R Extensions’.
• A C++ compiler default is set only if the C++11 standard is supported: it no longer
falls back to C++98.
• PCRE2 is used if available. To make use of PCRE1 if PCRE2 is unavailable, configure
with option ‘--with-pcre1’.
• The minimum required version of libcurl is now 7.28.0 (Oct 2012).
• New make target distcheck checks
– R can be rebuilt from the tarball created by make dist,
– the build from the tarball passes make check-all,
– the build installs and uninstalls,
– the source files are properly cleaned by make distclean.
UTILITIES:
NEWS 71
• R --help now mentions the option --no-echo (renamed from --slave) and its pre-
viously undocumented short form -s.
• R CMD check now optionally checks configure and cleanup scripts for non-Bourne-
shell code (‘bashisms’).
• R CMD check --as-cran now runs \donttest examples (which are run by example())
instead of instructing the tester to do so. This can be temporarily circumvented during
development by setting environment variable _R_CHECK_DONTTEST_EXAMPLES_ to a
false value.
PACKAGE INSTALLATION:
• There is the beginnings of support for the recently approved C++20 standard, spec-
ified analogously to C++14 and C++17. There is currently only limited support for
this in compilers, with flags such as ‘-std=c++20’ and ‘-std=c++2a’. For the time
being the configure test is of accepting one of these flags and compiling C++17
code.
BUG FIXES:
• formula(x) with length(x) > 1 character vectors, is deprecated now. Such use has
been rare, and has ‘worked’ as expected in some cases only. In other cases, wrong x
have silently been truncated, not detecting previous errors.
• Long-standing issue where the X11 device could lose events shortly after startup has
been addressed (PR#16702).
• The [Link] method for rbind() no longer drops <NA> levels from factor columns
by default (PR#17562).
• [Link]() and hence [Link]() now pass their ... ar-
gument to [Link](), fulfilling the wish of PR#17532; subsequently,
[Link]() gets new argument quiet, solving PR#17573.
• stopifnot() gets new argument exprObject to allow an R object of class expression
(or other ‘language’) to work more consistently, thanks to suggestions by Suharto
Anggono.
• conformMethod() now works correctly in cases containing a “&& logic” bug, reported
by Henrik Bengtsson. It now creates methods with "missing" entries in the signature.
Consequently, rematchDefinition() is amended to use appropriate .local() calls
with named arguments where needed.
• [Link](*, scientific = FALSE) now corresponds to a practically most ex-
treme options(scipen = n) setting rather than arbitrary n = 100.
• format([Link]("foo")) now works (returning "foo").
• postscript(.., title = *) now signals an error when the title string contains a
character which would produce corrupt PostScript, thanks to PR#17607 by Daisuko
Ogawa.
• Certain Ops (notably comparison such as ==) now also work for 0-length data frames,
after reports by Hilmar Berger.
• methods(class = class(glm(..))) now warns more usefully and only once.
• [Link]() no longer mangles field names (PR#17589).
• Primitive replacement functions no longer mutate a referenced first argument when
used outside of a complex assignment context.
72 NEWS