From 790c46a8d5c32ff80f2d20b53a4058ced45b0005 Mon Sep 17 00:00:00 2001 From: hornik Date: Thu, 15 Feb 2024 13:19:07 +0000 Subject: [PATCH] Tweaks. git-svn-id: https://svn.r-project.org/R/trunk@85908 00db46b3-68df-0310-9c12-caf00c1e9a41 --- doc/NEWS.Rd | 120 +++++++++---------- src/library/base/man/Memory-limits.Rd | 12 +- src/library/base/man/Quotes.Rd | 2 +- src/library/base/man/Sys.glob.Rd | 2 +- src/library/base/man/UTF8filepaths.Rd | 6 +- src/library/base/man/browserText.Rd | 4 +- src/library/base/man/connections.Rd | 4 +- src/library/base/man/dynload.Rd | 8 +- src/library/base/man/file.info.Rd | 4 +- src/library/base/man/files.Rd | 8 +- src/library/base/man/files2.Rd | 2 +- src/library/base/man/gc.time.Rd | 6 +- src/library/base/man/gctorture.Rd | 12 +- src/library/base/man/gettext.Rd | 4 +- src/library/base/man/iconv.Rd | 4 +- src/library/base/man/libcurlVersion.Rd | 6 +- src/library/base/man/normalizePath.Rd | 4 +- src/library/base/man/parse.Rd | 2 +- src/library/base/man/sQuote.Rd | 2 +- src/library/base/man/save.Rd | 4 +- src/library/base/man/seek.Rd | 2 +- src/library/base/man/serialize.Rd | 4 +- src/library/base/man/timezones.Rd | 6 +- src/library/compiler/man/compile.Rd | 14 +-- src/library/datasets/man/DNase.Rd | 4 +- src/library/datasets/man/PlantGrowth.Rd | 5 +- src/library/datasets/man/ToothGrowth.Rd | 4 +- src/library/datasets/man/UCBAdmissions.Rd | 4 +- src/library/datasets/man/airquality.Rd | 2 +- src/library/datasets/man/attenu.Rd | 2 +- src/library/datasets/man/co2.Rd | 4 +- src/library/datasets/man/npk.Rd | 2 +- src/library/datasets/man/pressure.Rd | 4 +- src/library/datasets/man/randu.Rd | 6 +- src/library/datasets/man/sunspot.month.Rd | 4 +- src/library/datasets/man/sunspot.year.Rd | 4 +- src/library/datasets/man/swiss.Rd | 4 +- src/library/grDevices/man/Devices.Rd | 2 +- src/library/grDevices/man/make.rgb.Rd | 10 +- src/library/grDevices/man/pdf.Rd | 6 +- src/library/grDevices/man/plotmath.Rd | 8 +- src/library/grDevices/man/postscript.Rd | 2 +- src/library/grDevices/man/postscriptFonts.Rd | 4 +- src/library/grDevices/man/unix/png.Rd | 18 +-- src/library/grDevices/man/windows.Rd | 2 +- src/library/grDevices/man/windows/png.Rd | 10 +- src/library/graphics/man/par.Rd | 6 +- src/library/graphics/man/screen.Rd | 2 +- src/library/grid/man/grid.grab.Rd | 4 +- src/library/grid/man/unit.Rd | 2 +- src/library/parallel/man/detectCores.Rd | 2 +- src/library/parallel/man/makeCluster.Rd | 4 +- src/library/stats/man/KalmanLike.Rd | 6 +- src/library/stats/man/SSD.Rd | 2 +- src/library/stats/man/StructTS.Rd | 4 +- src/library/stats/man/anova.mlm.Rd | 4 +- src/library/stats/man/extractAIC.Rd | 2 +- src/library/stats/man/hclust.Rd | 4 +- src/library/stats/man/loglin.Rd | 4 +- src/library/stats/man/mauchly.test.Rd | 4 +- src/library/stats/man/stlmethods.Rd | 2 +- src/library/tools/man/checkRdaFiles.Rd | 4 +- src/library/utils/R/aspell.R | 9 +- src/library/utils/man/BATCH.Rd | 4 +- src/library/utils/man/Rprof.Rd | 2 +- src/library/utils/man/aspell.Rd | 2 +- src/library/utils/man/browseURL.Rd | 4 +- src/library/utils/man/clipboard.Rd | 38 +++--- src/library/utils/man/dataentry.Rd | 4 +- src/library/utils/man/download.file.Rd | 4 +- src/library/utils/man/object.size.Rd | 18 +-- src/library/utils/man/read.DIF.Rd | 9 +- src/library/utils/man/savehistory.Rd | 2 +- src/library/utils/man/untar.Rd | 2 +- 74 files changed, 283 insertions(+), 224 deletions(-) diff --git a/doc/NEWS.Rd b/doc/NEWS.Rd index 8922162c85c..0a0b80fd461 100644 --- a/doc/NEWS.Rd +++ b/doc/NEWS.Rd @@ -317,7 +317,7 @@ \item A new \command{configure} option \option{--with-newAccelerate} makes use of Apple's \sQuote{new} BLAS / LAPACK interfaces in their Accelerate framework. Those interfaces are only available in macOS - 13.3 or later, and building requires SDK 13.3 or later (from the + 13.3 or later, and building requires \abbr{SDK} 13.3 or later (from the Command Line Tools or Xcode 14.3 or later). By default the option uses new Accelerate for BLAS calls: to also @@ -439,7 +439,7 @@ \item The \pkg{methods} package is more robust to not being attached to the search path. More work needs to be done. - \item \code{pairwise.t.test()} misbehaved when subgroups had 0 DF + \item \code{pairwise.t.test()} misbehaved when subgroups had 0 \abbr{DF}o for variance, even with \code{pool.sd = TRUE}. (\PR{18594} by Jack Berry). @@ -514,7 +514,7 @@ \item \code{kappa()} and \code{rcond()} work correctly in more cases; \code{kappa(., norm = "2")} now warns that it computes the 1-norm with - (default) \code{exact = FALSE}; prompted by Mikael Jagan's quite + (default) \code{exact = FALSE}; prompted by \I{Mikael Jagan}'s quite comprehensive \PR{18543}. \item Rd skeletons generated by \code{prompt()} or @@ -547,12 +547,12 @@ \item For \code{cbind()} and \code{rbind()}, the optional \code{deparse.level} argument is now properly passed to methods, - thanks to Mikael Jagan's \PR{18579} and comments there. + thanks to \I{Mikael Jagan}'s \PR{18579} and comments there. \item Some error and warning messages for large (\sQuote{long vector}) \code{matrix(v, nr, nc)} and \code{dim(m) <- d} are now correct about sizes, using \code{long long} formatting, fixing - \PR{18612} (and more) reported by Mikael Jagan. + \PR{18612} (and more) reported by \I{Mikael Jagan}. \item \code{readChar(useBytes = TRUE)} now terminates strings even when the underlying connection uses extra spaces in the input buffer. This @@ -574,7 +574,7 @@ unintentional) setting more predictable. \item \code{drop.terms(*)} now drops response as by default, - \code{keep.response = FALSE}, fixing \PR{18564} thanks to Mikael Jagan. + \code{keep.response = FALSE}, fixing \PR{18564} thanks to \I{Mikael Jagan}. \item \code{dummy.coef(.)} now also works for \code{lm()}-models with \code{character} categorical predictor variables rather than @@ -643,7 +643,7 @@ when used as a Quartz-based bitmap device. It now gives an error. \item \code{rank()} now works, fixing \PR{18617}, thanks to - Ilia Kats. + \I{Ilia Kats}. \item \code{seq.int()} did not adequately check its \code{length.out} argument. @@ -653,11 +653,11 @@ \I{Bastian Klein}. \item \code{drop.terms(*, dropx = <0-length>)} now works, fixing - \PR{18563} as proposed by Mikael Jagan. + \PR{18563} as proposed by \I{Mikael Jagan}. \item \code{drop.terms(*)} keeps \code{ + offset(.)} terms when it should, \PR{18565}, and \code{drop.terms()} no longer makes up a response, - \PR{18566}, fixing both bugs thanks to Mikael Jagan. + \PR{18566}, fixing both bugs thanks to \I{Mikael Jagan}. \item \code{getS3method("t", "test")} no longer finds the \code{t.test()} function, fixing \PR{18627}. @@ -674,7 +674,7 @@ \item \code{rank(x)} no longer overflows during integer addition, when computing rank average for largish but not-yet long vector \code{x}, - fixing \PR{18630}, thanks to Ilia Kats. + fixing \PR{18630}, thanks to \I{Ilia Kats}. \item \code{list.files()} on Windows now returns also files with names longer that 260 bytes (the Windows limit is 260 characters). @@ -682,11 +682,11 @@ characters were omitted. \item \code{cov2cor(<0 x 0>)} now works, fixing \PR{18423} thanks to - Mikael Jagan and Elin Warning. + \I{Mikael Jagan} and \I{Elin Waring}. \item \code{cov2cor()} and similar now give one warning instead of two, with better wording, fixing \PR{18424} thanks - to Mikael Jagan. + to \I{Mikael Jagan}. \item \pkg{tools}\code{:: startDynamicHelp()} now ensures \code{port} is in proper range, fixing \PR{18645}. @@ -729,12 +729,12 @@ \subsection{INSTALLATION on a UNIX-ALIKE}{ \itemize{ - \item There is some support for building with Intel's LLVM-based + \item There is some support for building with Intel's \I{LLVM}-based compilers on \samp{x86_64} Linux, such as (C) \command{icx}, (C++) \command{ipcx} and (Fortran) \command{ifx} from oneAPI 2023.x.y. - \item There is support for using LLVM's \command{flang-new} as the - Fortran compiler from LLVM 16.0.x (preferably 17.0.0 + \item There is support for using \I{LLVM}'s \command{flang-new} as the + Fortran compiler from \I{LLVM} 16.0.x (preferably 17.0.0 or later). } } @@ -758,7 +758,7 @@ \item \code{contrib.url(character())} now returns 0-length \code{character()} as documented, which also avoids spurious - warnings from \code{available.packages()} et al.\sspace{}in the + warnings from \code{available.packages()} \I{et al.}\sspace{}in the edge case of an empty vector of repository URLs. \item \code{readChar(., 4e8)} no longer fails, thanks to Kodi Arfer's @@ -773,14 +773,14 @@ functions \code{read()}/\code{write()} on pipes (seen on macOS where a restriction to \code{INT_MAX} bytes is documented, without doing a partial read unlike Linux). The payload is now split into - 1Gb chunks to avoid that problem. (\PR{18571}) + 1\abbr{Gb} chunks to avoid that problem. (\PR{18571}) \item \code{qqplot(x,y, conf.level=.)} gives better confidence bounds when \code{length(x) != length(y)}, thanks to Alexander Ploner's report and patch proposal (\PR{18557}). \item \code{norm(<0-length>, "2")} now gives zero instead of an - error, as all the other norm types, thanks to Mikael Jagan's \PR{18542}. + error, as all the other norm types, thanks to \I{Mikael Jagan}'s \PR{18542}. \item Build-stage Rd macros \verb{\packageAuthor} and \verb{\packageMaintainer} now process \samp{Authors@R}, @@ -880,13 +880,13 @@ \item \code{na.contiguous(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. + reported to R-devel, including a fix, by \I{Georgi Boshnakov}. Further, by default, it modifies only an existing \code{attr(*,"tsp")} but otherwise no longer sets one. \item \code{chol(, pivot = )} now gives a correct error or warning message (depending on \code{pivot}), thanks to - Mikael Jagan's (\PR{18541}). + \I{Mikael Jagan}'s (\PR{18541}). } } } @@ -1021,7 +1021,7 @@ Other options include \code{rankdeficient = "NA"}, predicting \code{NA} for non-estimable \code{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. + proposal and discussions in \PR{16158} also by David Firth and \I{Elin Waring}. Still somewhat experimental. \item \command{Rgui} console implementation now works better with the @@ -1311,7 +1311,7 @@ calls -- see \sQuote{Writing R Extensions} §6.6.1. %% g++ 11 supported c++23. - %% 2022-09 Recent LLVM (>= 13?) and Apple (>= 13?) clang support c++2b. + %% 2022-09 Recent \I{LLVM} (>= 13?) and Apple (>= 13?) clang support c++2b. \item There is initial support for C++23 as several compilers are now supporting \code{-std=c++23} or \code{-std=c++2b} or similar. As for C++20, there no additional \command{configure} checks for @@ -1344,7 +1344,7 @@ be useful if a package assumes them if C17 is specified and they are not implemented.} \item{USE_C23}{Use C23 (or in future, later). Compiler/library - support for C23 is still being implemented, but LLVM clang + support for C23 is still being implemented, but \I{LLVM} clang from 15.0.0 and GCC from 13 have quite extensive support. } } @@ -1404,7 +1404,7 @@ and used in a few places in the \R sources. \item ALTREP now supports \code{VECSXP} vectors. Contributed by - Gabor Csardi in \PR{17620}. + \I{Gabor Csardi} in \PR{17620}. \item The \code{Rcomplex} definition (in header \file{R_ext/Complex.h}) has been extended to prevent possible @@ -1418,7 +1418,7 @@ standards but are available in \command{g++} and \command{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). + compilers (GCC, Apple/\I{LLVM} clang, Intel). It is intended to change the inclusion of header \file{R_ext/Complex.h} by other \R{} headers, so C/C++ code files @@ -1473,7 +1473,7 @@ specification can probably be removed. \item \command{R CMD INSTALL} reports the compilers (and on - macOS, the SDK) used, and this is copied to the output of + macOS, the \abbr{SDK}) used, and this is copied to the output of \command{R CMD check}. Where a C++ standard is specified, it is reported. @@ -1517,7 +1517,7 @@ \item \code{library()} now passes its \code{lib.loc} argument when requiring \code{Depends} packages; reported (with fix) in \PR{18331} - by Mikael Jagan. + by \I{Mikael Jagan}. \item \command{R CMD Stangle}: improved message about \sQuote{Output} files. @@ -1537,7 +1537,7 @@ \item \code{c(a = 1, 2)[[]]} no longer matches \code{2} but rather signals a \emph{classed} error. Reported and analysed by Davis Vaughan in - \PR{18367}, a duplicate of \PR{18004}, by Jan Meis et al. + \PR{18367}, a duplicate of \PR{18004}, by Jan Meis \I{et al.} For consistency, \code{NULL[[]]} is also erroneous now. \code{x[[]] <- v} gives an error of the same class \code{"MissingSubscriptError"}. @@ -1605,7 +1605,7 @@ of which fixes \PR{18422}, reported by Benjamin Feakins. \item \code{Sys.timezone()} queries \command{timedatectl} only if - \command{systemd} is loaded; addressing a report by Jan Gorecki in + \command{systemd} is loaded; addressing a report by \I{Jan Gorecki} in \PR{17421}. \item The formula method of \code{cor.test()} had scoping problems @@ -1764,14 +1764,14 @@ \item 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 + macOS 13 \abbr{SDK} (\PR{18426}). This also addresses an issue where the currently used font in the Quartz device context was not correctly retained. \item (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. + due to which the symbol \abbr{charset} was not used with \I{TT Symbol} font face. \item (Windows) Installing a package with a \file{src/Makefile.\{win,ucrt\}} file includes @@ -1781,7 +1781,7 @@ \item \code{format(, "....\%OS")} with \eqn{n > 0} no longer accidentally uses the unbalanced seconds, - thanks to Suharto Anggono's report (including patch) in \PR{18448}. + thanks to \I{Suharto Anggono}'s report (including patch) in \PR{18448}. \item \code{solve.default(a, b)} works around issues with some versions of LAPACK when \code{a} contains \code{NA} or @@ -1815,7 +1815,7 @@ \env{R_LIBCURL_SSL_REVOKE_BEST_EFFORT} can be used to switch to only \sQuote{best-effort} \abbr{SSL} certificate revocation checks with the default \code{"libcurl"} download method. This reduces - security, but may be needed for downloads to work with MITM + security, but may be needed for downloads to work with \abbr{MITM} proxies (\PR{18379}). \item (macOS) The run-time check for libraries from XQuartz for @@ -1842,12 +1842,12 @@ target \command{make compact-pdf} (at the top level or in directory \file{doc/manual}). - \item There is now \command{configure} support for LLVM clang 15 + \item There is now \command{configure} support for \I{LLVM} clang 15 on Linux, which defaults to position-independent (PIE) executables whereas \command{gfortran} does not. \item Many small changes to ease compilation (and suppress - warnings) with LLVM \command{clang} 15. + warnings) with \I{LLVM} \command{clang} 15. } } @@ -1864,7 +1864,7 @@ \item When \code{isGeneric(f, fdef=*)} is used with mismatching names, the warning is better understandable; reported (with fix) in - \PR{18370} by Gabe Becker. + \PR{18370} by \I{Gabe Becker}. \item \code{poly(x, n)} now works again (and is now documented) when \code{x} is a \code{"Date"} or \code{"POSIXct"} object, or of @@ -2182,7 +2182,7 @@ \item \code{plot()} gains a \code{extend.ylim.f} argument, in partial response to \PR{15285}; further \PR{17784} is fixed thanks to - several contributors and a patch by Elin Waring. + several contributors and a patch by \I{Elin Waring}. The Cook's dist contours get customizable via \code{cook.col} and \code{cook.lty} with a different default color and their legend is nicer by default and customizable via \code{cook.legendChanges}. @@ -2382,7 +2382,7 @@ \command{gcc} 10.3 MinGW-W64 UCRT toolchain. \item \file{Rtools42} by default uses the Windows security - features ASLR and DEP; hence \abbr{CRAN} builds of \R and packages also + features \I{ASLR} and \I{DEP}; hence \abbr{CRAN} builds of \R and packages also do. \item \R now supports files \file{Makevars.ucrt}, @@ -2669,7 +2669,7 @@ \item Improved determination of the correct translation domain in non-base packages, addressing the combination of \PR{18092} and \PR{17998} (\code{#c6}) with reports and \emph{augmented} patch - #2904 by Suharto Anggono. + #2904 by \I{Suharto Anggono}. Note that \code{"R-base"} is no longer the default domain e.g., for top-level calls to \code{gettext()}; rather translation needs @@ -2708,7 +2708,7 @@ \item \code{x[i]} and \code{x[[i]]} for non-integer \code{i} should now behave in all cases as always documented: the index used is equivalent to \code{as.integer(i)} unless that would overflow where - \code{trunc(i)} is used instead; thanks to Suharto Anggono's report + \code{trunc(i)} is used instead; thanks to \I{Suharto Anggono}'s report and patch proposals in \PR{17977}. \item \code{asOneSidedFormula()} now associates the resulting @@ -2743,14 +2743,14 @@ \item \code{setAs()} finds the correct class for name \code{to} when multiple packages define a class with that name. Thanks to - Gabor Csardi for the report. + \I{Gabor Csardi} for the report. \item 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. + \I{Gabor Csardi} for the report. \item \code{match.arg("", c("", "a", "B"))} gives a better error - message, in part from \PR{17959}, thanks to Elin Waring. + message, in part from \PR{17959}, thanks to \I{Elin Waring}. \item \command{R CMD Sweave --clean} no longer removes pre-existing files or subdirectories (\PR{18242}). @@ -2762,7 +2762,7 @@ \item Deparsing constructs such as \code{quote(1 + `!`(2) + 3)} works again as before R 3.5.0, thanks to the report and patch in \PR{18284} - by Suharto Anggono. + by \I{Suharto Anggono}. \item \code{as.list(f)} for a \code{factor} \code{f} now keeps \code{names(f)}, fixing \PR{18309}. @@ -2840,7 +2840,7 @@ \item Subscripting an array \code{x} without dimnames by a \code{length(dim(x))}-column character matrix gave "random" - non-sense, now an error; reported in \PR{18244} by Mikael Jagan. + non-sense, now an error; reported in \PR{18244} by \I{Mikael Jagan}. \item \code{...names()} now matches \code{names(list(...))} closely, fixing \PR{18247}. @@ -2936,7 +2936,7 @@ \PR{18171}.) \item \verb{\Sexpr{ch}} now preserves \code{Encoding(ch)}. (Thanks to - report and patch by Jeroen Ooms in \PR{18152}.) + report and patch by \I{Jeroen Ooms} in \PR{18152}.) \item Setting the RNG to \code{"Marsaglia-Multicarry"} e.g., by \code{RNGkind()}, now warns in more places, thanks to @@ -3109,7 +3109,7 @@ \command{R CMD check --as-cran } may be tweaked via the new environment variable \env{_R_CHECK_CRAN_INCOMING_TARBALL_THRESHOLD_}, as suggested in - \PR{17777} by Jan Gorecki. + \PR{17777} by \I{Jan Gorecki}. \item Using \code{c()} to combine a factor with other factors now gives a factor, an ordered factor when combining ordered factors @@ -3250,7 +3250,7 @@ \item \code{.libPaths()} gets a new option \code{include.site}, allowing to \emph{not} include the site library. (Thanks to Dario - Strbenac's suggestion and Gabe Becker's \PR{18016}.) + Strbenac's suggestion and \I{Gabe Becker}'s \PR{18016}.) \item Lithuanian translations are now available. (Thanks to Rimantas Žakauskas.) @@ -3675,7 +3675,7 @@ vector consisting entirely of \code{NA} values. \item \code{x[[2^31]] <- v} now works. (Thanks to the report and - patch by Suharto Anggono in \PR{17330}.) + patch by \I{Suharto Anggono} in \PR{17330}.) \item In log-scale graphics, \code{axis()} ticks and label positions are now computed more carefully and symmetrically in their range, @@ -3830,7 +3830,7 @@ \item \code{(~ NULL)[1]} and similar formula subsetting now works, thanks to a report and patch by \I{Henrik Bengtsson} in \PR{17935}. Additionally, subsetting leaving an empty formula now works too, - thanks to suggestions by Suharto Anggono. + thanks to suggestions by \I{Suharto Anggono}. \item \code{.traceback(n)} keeps source references again, as before \R 4.0.0, fixing a regression; introduced by the \PR{17580}, reported @@ -3838,7 +3838,7 @@ \item \code{unlist(plst, recursive=FALSE)} no longer drops content for pairlists with list components, thanks to the report and patch - by Suharto Anggono in \PR{17950}. + by \I{Suharto Anggono} in \PR{17950}. \item \code{iconvlist()} now also works on MUSL based (Linux) systems, from a report and patch suggestion by Wesley Chan in @@ -3962,7 +3962,7 @@ and debugged by \I{Dmitriy Selivanov} in \PR{17850}. \item \code{quantile(x, pr)} works more consistently for \code{pr} - values slightly outside [0,1], thanks to Suharto Anggono's \PR{17891}. + values slightly outside [0,1], thanks to \I{Suharto Anggono}'s \PR{17891}. Further, \code{quantile(x, prN, names=FALSE)} now works even when \code{prN} contains \code{NA}s, thanks to Anggono's \PR{17892}. @@ -3978,7 +3978,7 @@ \code{""}, thanks to Michael Chirico's \PR{17909}. \item \code{isS3stdGeneric(f)} now detects an S3 generic also when - it is \code{trace()}d, thanks to Gabe Becker's \PR{17917}. + it is \code{trace()}d, thanks to \I{Gabe Becker}'s \PR{17917}. \item \code{R_allocLD()} has been fixed to return memory aligned for long double type \PR{16534}. @@ -4070,7 +4070,7 @@ returns the new rather than the previous setting. \item Fix for adding two complex \pkg{grid} units via \code{sum()}. - Thanks to Gu Zuguang for the report and Thomas Lin Pedersen for + Thanks to \I{Gu Zuguang} for the report and \I{Thomas Lin Pedersen} for the patch. \item Fix \code{parallel::mclapply(..., mc.preschedule=FALSE)} @@ -4093,7 +4093,7 @@ for unknown OSes). \item Parse data for raw strings is now recorded correctly. Reported - by Gabor Csardi. + by \I{Gabor Csardi}. } } } @@ -4192,7 +4192,7 @@ \item \code{DF2formula()}, the utility for the data frame method of \code{formula()}, now works without parsing and explicit evaluation, - starting from Suharto Anggono's suggestion in \PR{17555}. + starting from \I{Suharto Anggono}'s suggestion in \PR{17555}. \item \code{approxfun()} and \code{approx()} gain a new argument \code{na.rm} defaulting to true. If set to false, missing @@ -4277,7 +4277,7 @@ \item For \code{head(x, n)} and \code{tail()} the default and other S3 methods notably for \emph{vector} \code{n}, e.g. to get a \dQuote{corner} of a matrix, has been extended to \code{array}'s - of higher dimension thanks to the patch proposal by Gabe Becker in + of higher dimension thanks to the patch proposal by \I{Gabe Becker} in \PR{17652}. Consequently, optional argument \code{addrownums} is deprecated and replaced by the (more general) argument \code{keepnums}. An invalid second argument \code{n} now leads @@ -4480,7 +4480,7 @@ \subsection{Windows}{ \itemize{ - \item \command{Rterm} now works also when invoked from MSYS2 + \item \command{Rterm} now works also when invoked from \abbr{MSYS2} terminals. Line editing is possible when command \command{winpty} is installed. @@ -4642,7 +4642,7 @@ \item \code{stopifnot()} gets new argument \code{exprObject} to allow an \R object of class \code{expression} (or other \sQuote{language}) - to work more consistently, thanks to suggestions by Suharto Anggono. + to work more consistently, thanks to suggestions by \I{Suharto Anggono}. \item \code{conformMethod()} now works correctly in cases containing a \dQuote{\code{&&} logic} bug, reported by \I{Henrik Bengtsson}. It now @@ -4833,7 +4833,7 @@ encoding (at least on Windows 10 they were sometimes omitted, \PR{17632}). - \item \code{scan()} issues with UTF-8 data when running in a DBCS + \item \code{scan()} issues with UTF-8 data when running in a \abbr{DBCS} locale have been resolved (\PR{16520}, \PR{16584}). \item \command{Rterm} now accepts enhanced/arrow keys also with diff --git a/src/library/base/man/Memory-limits.Rd b/src/library/base/man/Memory-limits.Rd index dd3a28f63ce..439100bdc7d 100644 --- a/src/library/base/man/Memory-limits.Rd +++ b/src/library/base/man/Memory-limits.Rd @@ -48,7 +48,7 @@ } \section{Unix}{ The address-space limit is system-specific: 32-bit OSes - imposes a limit of no more than 4Gb: it is often 3Gb. Running + imposes a limit of no more than 4\abbr{Gb}: it is often 3\abbr{Gb}. Running 32-bit executables on a 64-bit OS will have similar limits: 64-bit executables will have an essentially infinite system-specific limit (e.g., 128Tb for Linux on x86_64 CPUs). @@ -62,21 +62,21 @@ \preformatted{limit cputime 10m limit vmemoryuse 4096m } - to limit a process to 10 minutes of CPU time and (around) 4Gb of + to limit a process to 10 minutes of CPU time and (around) 4\abbr{Gb} of virtual memory. (There are other options to set the RAM in use, but they are not generally honoured.) } \section{Windows}{ - The address-space limit is 2Gb under 32-bit Windows unless the OS's - default has been changed to allow more (up to 3Gb). See + The address-space limit is 2\abbr{Gb} under 32-bit Windows unless the OS's + default has been changed to allow more (up to 3\abbr{Gb}). See \url{https://docs.microsoft.com/en-gb/windows/desktop/Memory/physical-address-extension} and \url{https://docs.microsoft.com/en-gb/windows/desktop/Memory/4-gigabyte-tuning}. Under most 64-bit versions of Windows the limit for a 32-bit build - of \R is 4Gb: for the oldest ones it is 2Gb. The limit for a 64-bit + of \R is 4\abbr{Gb}: for the oldest ones it is 2\abbr{Gb}. The limit for a 64-bit build of \R (imposed by the OS) is 8Tb. - It is not normally possible to allocate as much as 2Gb to a single + It is not normally possible to allocate as much as 2\abbr{Gb} to a single vector in a 32-bit build of \R even on 64-bit Windows because of preallocations by Windows in the middle of the address space. } diff --git a/src/library/base/man/Quotes.Rd b/src/library/base/man/Quotes.Rd index 3e0781a96af..789fffd56c3 100644 --- a/src/library/base/man/Quotes.Rd +++ b/src/library/base/man/Quotes.Rd @@ -59,7 +59,7 @@ also supported when reading character strings by \code{\link{scan}} and \code{\link{read.table}} if \code{allowEscapes = TRUE}. Unicode escapes can be used to enter Unicode characters not in the current - locale's charset (when the string will be stored internally in UTF-8). + locale's \abbr{charset} (when the string will be stored internally in UTF-8). The maximum allowed value for \samp{\\nnn} is \samp{\\377} (the same character as \samp{\\xff}). diff --git a/src/library/base/man/Sys.glob.Rd b/src/library/base/man/Sys.glob.Rd index af9aa18eb90..f7a80925eb8 100644 --- a/src/library/base/man/Sys.glob.Rd +++ b/src/library/base/man/Sys.glob.Rd @@ -99,7 +99,7 @@ Sys.glob(paths, dirmark = FALSE) File paths in Windows are interpreted with separator \code{\\} or \code{/}. Paths with a drive but relative (such as \code{c:foo\\bar}) are tricky, but an attempt is made to handle them correctly. An - attempt is made to handle UNC paths starting with a double + attempt is made to handle \abbr{UNC} paths starting with a double backslash. UTF-8-encoded paths not valid in the current locale can be used. #endif diff --git a/src/library/base/man/UTF8filepaths.Rd b/src/library/base/man/UTF8filepaths.Rd index 15595b50d99..9bfe7459f17 100644 --- a/src/library/base/man/UTF8filepaths.Rd +++ b/src/library/base/man/UTF8filepaths.Rd @@ -3,6 +3,8 @@ % Copyright 2019 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{UTF8filepaths} \alias{file path encoding} \alias{UTF-8 file path} @@ -11,7 +13,7 @@ \description{ Most modern file systems store file-path components (names of directories and files) in a character encoding of wide scope: usually - UTF-8 on a Unix-alike and UCS-2/UTF-16 on Windows. However, this was + UTF-8 on a Unix-alike and \I{UCS-2}/UTF-16 on Windows. However, this was not true when \R was first developed and there are still exceptions amongst file systems, e.g.\sspace{}FAT32. @@ -55,7 +57,7 @@ \section{Windows}{ Windows provides proprietary entry points to access its file systems, and these gained \sQuote{wide} versions in Windows NT that allowed - file paths in UCS-2/UTF-16 to be accessed from any locale. + file paths in \I{UCS-2}/UTF-16 to be accessed from any locale. Some \R functions use these entry points when file paths are marked as Latin-1 or UTF-8 to allow access to paths not in the current diff --git a/src/library/base/man/browserText.Rd b/src/library/base/man/browserText.Rd index 591cf240f46..7990f3a46f3 100644 --- a/src/library/base/man/browserText.Rd +++ b/src/library/base/man/browserText.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2011 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{browserText} \alias{browserText} \alias{browserCondition} @@ -39,7 +41,7 @@ stack and call \code{browserSetDebug} with \code{n} set to that value. Then, by typing \code{c} at the browser prompt you will cause evaluation to continue, and provided there are no intervening calls to browser or other interrupts, control will halt again once evaluation has returned to -the closure specified. This is similar to the up functionality in gdb +the closure specified. This is similar to the up functionality in \I{GDB} or the "step out" functionality in other debuggers. } \value{ diff --git a/src/library/base/man/connections.Rd b/src/library/base/man/connections.Rd index 96964064246..6da55ae995e 100644 --- a/src/library/base/man/connections.Rd +++ b/src/library/base/man/connections.Rd @@ -574,7 +574,7 @@ socketTimeout(socket, timeout = -1) \code{description} which is marked as being in UTF-8 is passed to Windows as a \sQuote{wide} character string. This allows files with names not in the native encoding to be opened on file systems which - use Unicode file names (such as NTFS but not FAT32). + use Unicode file names (such as \abbr{NTFS} but not FAT32). } \section{\samp{ftp://} URLs}{ @@ -606,7 +606,7 @@ socketTimeout(socket, timeout = -1) on macOS (and Solaris) but 1024 on Linux. The limit can be raised in the shell used to launch \R, for example by \command{ulimit -n}.) File descriptors are used for many other purposes including dynamically - loading DSO/DLLs (see \code{\link{dyn.load}}) which may use up to 60\% + loading \abbr{DSO}/DLLs (see \code{\link{dyn.load}}) which may use up to 60\% of the limit. Windows has a default limit of 512 open C file streams: these are used diff --git a/src/library/base/man/dynload.Rd b/src/library/base/man/dynload.Rd index be50ac62d68..6846021c42d 100644 --- a/src/library/base/man/dynload.Rd +++ b/src/library/base/man/dynload.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2023 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{dyn.load} \alias{dyn.load} \alias{dyn.unload} @@ -64,7 +66,7 @@ is.loaded(symbol, PACKAGE = "", type = "") loadable libraries} (abbreviated to \sQuote{DLL}) on all platforms except macOS, which uses the term for a different sort of object. On Unix-alikes they are also called \sQuote{dynamic - shared objects} (\sQuote{DSO}), or \sQuote{shared objects} for + shared objects} (\sQuote{\abbr{DSO}}), or \sQuote{shared objects} for short. (The POSIX standards use \sQuote{executable object file}, but no one else does.) @@ -202,7 +204,7 @@ is.loaded(symbol, PACKAGE = "", type = "") search order for where a DLL is found (if not given as an absolute path, which is preferred), \emph{and} of where its dependent DLLs will be found. This search path depends on the version of Windows and its - security settings, but for versions since Windows XP SP1 it is + security settings, but for versions since \I{Windows XP SP1} it is \itemize{ \item The directory from which the application was launched. \item The various system directories, @@ -218,7 +220,7 @@ is.loaded(symbol, PACKAGE = "", type = "") (\code{\link{library.dynam}} does that automatically in recent versions of \R), but the DLL search order means that DLLs in the launch directory and in system directories will be preferred. On - Windows XP SP1 and later there is a way to modify the search order. + \I{Windows XP SP1} and later there is a way to modify the search order. If argument \code{DLLpath} is supplied to \code{dyn.load}, the latter makes use of the Windows system call \code{SetDllDirectory} to insert the value of \code{DLLpath} in second place, and removes the current diff --git a/src/library/base/man/file.info.Rd b/src/library/base/man/file.info.Rd index 33c125881fc..f04277a6613 100644 --- a/src/library/base/man/file.info.Rd +++ b/src/library/base/man/file.info.Rd @@ -44,7 +44,7 @@ file.size(\dots) On most systems symbolic links are followed, so information is given about the file to which the link points rather than about the link.} \item{On Windows:}{ - File modes are probably only useful on NTFS file systems, and it seems + File modes are probably only useful on \abbr{NTFS} file systems, and it seems all three digits refer to the file's owner. The execute/search bits are set for directories, and for files based on their extensions (e.g., \file{.exe}, \file{.com}, \file{.cmd} @@ -113,7 +113,7 @@ file.size(\dots) convenience wrappers returning just one of the columns. } \note{ - Some (now old) unix alike systems allow files of more than 2Gb to be created but + Some (now old) unix alike systems allow files of more than 2\abbr{Gb} to be created but not accessed by the \code{stat} system call. Such files may show up as non-readable (and very likely not be readable by any of \R's input functions). diff --git a/src/library/base/man/files.Rd b/src/library/base/man/files.Rd index 230172005ec..e85b20c74bc 100644 --- a/src/library/base/man/files.Rd +++ b/src/library/base/man/files.Rd @@ -115,7 +115,7 @@ Sys.junction(from, to) \code{to} argument can specify a single existing directory. If \code{copy.mode = TRUE} file read/write/execute permissions are copied where possible, restricted by \sQuote{\link{umask}}. (On Windows this - applies only to files.) Other security attributes such as ACLs are not + applies only to files.) Other security attributes such as \abbr{ACL}s are not copied. On a POSIX filesystem the targets of symbolic links will be copied rather than the links themselves, and hard links are copied separately. Using \code{copy.date = TRUE} may or may not copy the @@ -126,9 +126,9 @@ Sys.junction(from, to) on those file systems which support them. For \code{file.symlink} the \code{to} argument can specify a single existing directory. (Unix and macOS native filesystems support both. Windows has hard links to - files on NTFS file systems and concepts related to symbolic links on + files on \abbr{NTFS} file systems and concepts related to symbolic links on recent versions: see the section below on the Windows version of this - help page. What happens on a FAT or SMB-mounted file system is OS-specific.) + help page. What happens on a FAT or \abbr{SMB}-mounted file system is OS-specific.) File arguments with a marked encoding (see \code{\link{Encoding}} are if possible translated to the native encoding, except on Windows where @@ -171,7 +171,7 @@ Sys.junction(from, to) } \section{Symbolic links on Windows}{ Symbolic links in the sense of - POSIX file systems do not exist on Windows: however, NTFS file systems + POSIX file systems do not exist on Windows: however, \abbr{NTFS} file systems support two similar concepts. There are \sQuote{junctions} (or \sQuote{junction points}), diff --git a/src/library/base/man/files2.Rd b/src/library/base/man/files2.Rd index a02e7bcc572..238ae05f381 100644 --- a/src/library/base/man/files2.Rd +++ b/src/library/base/man/files2.Rd @@ -83,7 +83,7 @@ Sys.umask(mode = NA) file. So \R interprets \code{mode} to mean set read-only if and only if \code{(mode & 0200) == 0} (interpreted in octal). Windows has a much more extensive system of file permissions on some file systems - (e.g., versions of NTFS) which are unrelated to this system call. + (e.g., versions of \abbr{NTFS}) which are unrelated to this system call. #endif \code{Sys.umask} sets the \code{umask} and returns the previous value: diff --git a/src/library/base/man/gc.time.Rd b/src/library/base/man/gc.time.Rd index 5f03d5ad3e0..607a49fc6ed 100644 --- a/src/library/base/man/gc.time.Rd +++ b/src/library/base/man/gc.time.Rd @@ -8,19 +8,19 @@ \title{Report Time Spent in Garbage Collection} \description{ This function reports the time spent in garbage collection so far in - the \R session while GC timing was enabled. + the \R session while \abbr{GC} timing was enabled. } \usage{ gc.time(on = TRUE) } \arguments{ - \item{on}{logical; if \code{TRUE}, GC timing is enabled.} + \item{on}{logical; if \code{TRUE}, \abbr{GC} timing is enabled.} } \value{ A numerical vector of length 5 giving the user CPU time, the system CPU time, the elapsed time and children's user and system CPU times (normally both zero), of time spent doing garbage collection whilst - GC timing was enabled. + \abbr{GC} timing was enabled. Times of child processes are not available on Windows and will always be given as \code{NA}. diff --git a/src/library/base/man/gctorture.Rd b/src/library/base/man/gctorture.Rd index f7e5074b7a1..2d10fe32d74 100644 --- a/src/library/base/man/gctorture.Rd +++ b/src/library/base/man/gctorture.Rd @@ -16,10 +16,10 @@ gctorture2(step, wait = step, inhibit_release = FALSE) } \arguments{ \item{on}{logical; turning it on/off.} - \item{step}{integer; run GC every \code{step} allocations; \code{step - = 0} turns the GC torture off.} + \item{step}{integer; run \abbr{GC} every \code{step} allocations; \code{step + = 0} turns the \abbr{GC} torture off.} \item{wait}{integer; number of allocations to wait before starting - GC torture.} + \abbr{GC} torture.} \item{inhibit_release}{logical; do not release free objects for re-use: use with caution.} } @@ -30,9 +30,9 @@ gctorture2(step, wait = step, inhibit_release = FALSE) } \details{ Calling \code{gctorture(TRUE)} instructs the memory manager to force a - full GC on every allocation. \code{gctorture2} provides a more refined - interface that allows the start of the GC torture to be deferred and - also gives the option of running a GC only every \code{step} + full \abbr{GC} on every allocation. \code{gctorture2} provides a more refined + interface that allows the start of the \abbr{GC} torture to be deferred and + also gives the option of running a \abbr{GC} only every \code{step} allocations. The third argument to \code{gctorture2} is only used if R has been diff --git a/src/library/base/man/gettext.Rd b/src/library/base/man/gettext.Rd index 096d6b66d41..1dbcea375e1 100644 --- a/src/library/base/man/gettext.Rd +++ b/src/library/base/man/gettext.Rd @@ -91,12 +91,12 @@ Sys.setLanguage(lang, unset = "en") name: your system may have a \command{man} page for it. With a non-\code{NULL} \code{dirname} it specifies where to look for message catalogues: with \code{dirname = NULL} it returns the current location. - If NLS is not enabled, \code{bindtextdomain(*,*)} returns \code{NULL}. + If \abbr{NLS} is not enabled, \code{bindtextdomain(*,*)} returns \code{NULL}. %% The special case \code{bindtextdomain(NULL)} calls C level \code{textdomain(textdomain(NULL))} for the purpose of flushing (i.e., emptying) the cache of already translated strings; it returns \code{TRUE} - when NLS is enabled. + when \abbr{NLS} is enabled. The utility \code{Sys.setlanguage(lang)} combines setting the \env{LANGUAGE} environment variable with flushing the translation cache diff --git a/src/library/base/man/iconv.Rd b/src/library/base/man/iconv.Rd index c2c00efd9c8..500f3934b41 100644 --- a/src/library/base/man/iconv.Rd +++ b/src/library/base/man/iconv.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2023 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{iconv} \alias{iconv} \alias{iconvlist} @@ -135,7 +137,7 @@ iconvlist() Encodings using character units which are more than one byte in size can be written on a file in either big-endian or little-endian order: - this applies most commonly to UCS-2, UTF-16 and UTF-32/UCS-4 + this applies most commonly to \I{UCS-2}, UTF-16 and UTF-32/\I{UCS-4} encodings. Some systems will write the Unicode character \code{U+FEFF} at the beginning of a file in these encodings and perhaps also in UTF-8. In that usage the character is known as a \abbr{BOM}, diff --git a/src/library/base/man/libcurlVersion.Rd b/src/library/base/man/libcurlVersion.Rd index 3e097d3fb93..2d6c4ceb74a 100644 --- a/src/library/base/man/libcurlVersion.Rd +++ b/src/library/base/man/libcurlVersion.Rd @@ -3,6 +3,8 @@ % Copyright 2015-2021 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{libcurlVersion} \alias{libcurlVersion} \title{ @@ -50,9 +52,9 @@ libcurlVersion() \url{https://curl.se/docs/ssl-compared.html} for more details on \abbr{SSL} versions (the current standard being known as \abbr{TLS}). Normally \code{libcurl} used with \R uses SecureTransport on macOS, OpenSSL on - Windows and GnuTLS, NSS or OpenSSL on Unix-alikes. (At the time of + Windows and GnuTLS, \I{NSS} or OpenSSL on Unix-alikes. (At the time of writing Debian-based Linuxen use GnuTLS and RedHat-based ones use - OpenSSL, having previously used NSS.) + OpenSSL, having previously used \I{NSS}.) } \examples{ libcurlVersion() diff --git a/src/library/base/man/normalizePath.Rd b/src/library/base/man/normalizePath.Rd index e23ce9278e0..093609e1b05 100644 --- a/src/library/base/man/normalizePath.Rd +++ b/src/library/base/man/normalizePath.Rd @@ -43,8 +43,8 @@ normalizePath(path, winslash = "\\\\", mustWork = NA) insufficient permissions) it currently falls back to the \R 3.6 (and older) implementation, which relies on \code{GetFullPathName} and \code{GetLongPathName} with limitations described in the Notes section. - An attempt is made not to introduce UNC paths in presence of mapped drives - or symbolic links: if \code{GetFinalPathNameByHandle} returns a UNC path, + An attempt is made not to introduce \abbr{UNC} paths in presence of mapped drives + or symbolic links: if \code{GetFinalPathNameByHandle} returns a \abbr{UNC} path, but \code{GetLongPathName} returns a path starting with a drive letter, R falls back to the \R 3.6 (and older) implementation. UTF-8-encoded paths not valid in the current locale can be used. diff --git a/src/library/base/man/parse.Rd b/src/library/base/man/parse.Rd index 2bcb7b502cd..db0db653a9b 100644 --- a/src/library/base/man/parse.Rd +++ b/src/library/base/man/parse.Rd @@ -88,7 +88,7 @@ str2expression(text) When input is taken from the console, \code{n = NULL} is equivalent to \code{n = 1}, and \code{n < 0} will read until an \abbr{EOF} character is - read. (The \abbr{EOF} character is Ctrl-Z for the Windows front-ends.) The + read. (The \abbr{EOF} character is \abbr{Ctrl}-Z for the Windows front-ends.) The line-length limit is 4095 bytes when reading from the console (which may impose a lower limit: see \sQuote{An Introduction to R}). diff --git a/src/library/base/man/sQuote.Rd b/src/library/base/man/sQuote.Rd index ec96b272ac4..8ac5421c90d 100644 --- a/src/library/base/man/sQuote.Rd +++ b/src/library/base/man/sQuote.Rd @@ -65,7 +65,7 @@ dQuote(x, q = getOption("useFancyQuotes")) quotes. #ifdef windows This is particularly troublesome in Windows \sQuote{Command Prompt} - windows, which by default are set up to run in the so-called OEM + windows, which by default are set up to run in the so-called \abbr{OEM} codepage, which in most locales uses a different encoding from Windows. Further, if the codepage is changed (with \code{chcp.exe}, e.g.\sspace{}to 1252 in a Western European language), the default raster fonts diff --git a/src/library/base/man/save.Rd b/src/library/base/man/save.Rd index 2f0ba813689..27600f65f3d 100644 --- a/src/library/base/man/save.Rd +++ b/src/library/base/man/save.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2020 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{save} \alias{save} \alias{save.image} @@ -76,7 +78,7 @@ save.image(file = ".RData", version = NULL, ascii = FALSE, promises are saved (together with their evaluation environments). (Promises embedded in objects are always saved unevaluated.) - All \R platforms use the XDR (bigendian) representation of C ints and + All \R platforms use the \I{XDR} (bigendian) representation of C ints and doubles in binary save-d files, and these are portable across all \R platforms. diff --git a/src/library/base/man/seek.Rd b/src/library/base/man/seek.Rd index 156a8685159..a7d8eead5fd 100644 --- a/src/library/base/man/seek.Rd +++ b/src/library/base/man/seek.Rd @@ -72,7 +72,7 @@ truncate(con, \dots) \code{truncate} truncates a file opened for writing at its current position. It works only for \code{file} connections, and is not implemented on all platforms: on others (including Windows) it will - not work for large (> 2Gb) files. + not work for large (> 2\abbr{Gb}) files. None of these should be expected to work on text-mode connections with re-encoding selected. diff --git a/src/library/base/man/serialize.Rd b/src/library/base/man/serialize.Rd index 3b997af1102..d50d0f04d05 100644 --- a/src/library/base/man/serialize.Rd +++ b/src/library/base/man/serialize.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2018 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{serialize} \alias{serialize} \alias{unserialize} @@ -25,7 +27,7 @@ unserialize(connection, refhook = NULL) representation is written; otherwise (default) a binary one. See also the comments in the help for \code{\link{save}}.} \item{xdr}{a logical: if a binary representation is used, should a - big-endian one (XDR) be used?} + big-endian one (\I{XDR}) be used?} \item{version}{the workspace format version to use. \code{NULL} specifies the current default version (3). The only other supported value is 2, the default from \R 1.4.0 to \R 3.5.0.} diff --git a/src/library/base/man/timezones.Rd b/src/library/base/man/timezones.Rd index 186b81d3efa..5f5fee6555b 100644 --- a/src/library/base/man/timezones.Rd +++ b/src/library/base/man/timezones.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2023 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{timezones} \alias{Sys.timezone} \alias{OlsonNames} @@ -205,7 +207,7 @@ OlsonNames(tzdir = NULL) as \sQuote{Local Mean Time} and abbreviated as \samp{LMT} in the databases: in many countries that was codified with a specific name before the switch to a standard time. For example, Paris codified its - LMT as \sQuote{Paris Mean Time} in 1891 (to be used throughout + \abbr{LMT} as \sQuote{Paris Mean Time} in 1891 (to be used throughout mainland France) and switched to \samp{GMT+0} in 1911. %% it is a ksh script so could well pop up elsewhere. @@ -301,7 +303,7 @@ OlsonNames(tzdir = NULL) \item \sQuote{Modern} Linux systems use \code{systemd} which provides mechanisms to set and retrieve the time zone (amongst other things). There is a command \command{timedatectl} to give details. - (Unfortunately RHEL/Centos 6.x were not \sQuote{modern}.) + (Unfortunately \I{RHEL}/Centos 6.x were not \sQuote{modern}.) \item Debian-derived systems since \emph{ca} 2007 have supplied a file \file{/etc/timezone}. Its format is undocumented but diff --git a/src/library/compiler/man/compile.Rd b/src/library/compiler/man/compile.Rd index 770a5feabf8..227a377195c 100644 --- a/src/library/compiler/man/compile.Rd +++ b/src/library/compiler/man/compile.Rd @@ -43,7 +43,7 @@ setCompilerOptions(...) \item{chdir}{logical; change directory before evaluation?} \item{code}{byte code expression or compiled closure} \item{e}{expression to compile.} - \item{level}{integer; the JIT level to use (\code{0} to \code{3}, or + \item{level}{integer; the \abbr{JIT} level to use (\code{0} to \code{3}, or negative to \emph{return} it).} \item{enable}{logical; enable compiling packages if \code{TRUE}.} \item{name}{character string; name of option to return.} @@ -72,17 +72,17 @@ setCompilerOptions(...) \code{disassemble} produces a printed representation of the code that may be useful to give a hint of what is going on. - \code{enableJIT} enables or disables just-in-time (JIT) - compilation. JIT is disabled if the argument is 0. If \code{level} is + \code{enableJIT} enables or disables just-in-time (\abbr{JIT}) + compilation. \abbr{JIT} is disabled if the argument is 0. If \code{level} is 1 then larger closures are compiled before their first use. If \code{level} is 2, then some small closures are also compiled before their second use. If \code{level} is 3 then in addition - all top level loops are compiled before they are executed. JIT level - 3 requires the compiler option \code{optimize} to be 2 or 3. The JIT + all top level loops are compiled before they are executed. \abbr{JIT} level + 3 requires the compiler option \code{optimize} to be 2 or 3. The \abbr{JIT} level can also be selected by starting \R with the environment variable \code{R_ENABLE_JIT} set to one of these values. Calling - \code{enableJIT} with a negative argument returns the current JIT - level. The default JIT level is \code{3}. + \code{enableJIT} with a negative argument returns the current \abbr{JIT} + level. The default \abbr{JIT} level is \code{3}. \code{compilePKGS} enables or disables compiling packages when they are installed. This requires that the package uses lazy loading as diff --git a/src/library/datasets/man/DNase.Rd b/src/library/datasets/man/DNase.Rd index c063e957923..d8c92e0e303 100644 --- a/src/library/datasets/man/DNase.Rd +++ b/src/library/datasets/man/DNase.Rd @@ -6,11 +6,11 @@ \name{DNase} \docType{data} \alias{DNase} -\title{Elisa assay of DNase} +\title{Elisa assay of \abbr{DNase}} \description{ The \code{DNase} data frame has 176 rows and 3 columns of data obtained during development of an ELISA assay for the recombinant - protein DNase in rat serum. + protein \abbr{DNase} in rat serum. } \usage{DNase} \format{ diff --git a/src/library/datasets/man/PlantGrowth.Rd b/src/library/datasets/man/PlantGrowth.Rd index 54084f846e7..491bbea60e6 100644 --- a/src/library/datasets/man/PlantGrowth.Rd +++ b/src/library/datasets/man/PlantGrowth.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2007 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{PlantGrowth} \docType{data} \alias{PlantGrowth} @@ -21,7 +23,8 @@ [, 2] \tab \code{group} \tab factor } - The levels of \code{group} are \sQuote{ctrl}, \sQuote{trt1}, and \sQuote{trt2}. + The levels of \code{group} are \sQuote{\I{ctrl}}, \sQuote{\I{trt1}}, + and \sQuote{\I{trt2}}. } \examples{ ## One factor ANOVA example from Dobson's book, cf. Table 7.4: diff --git a/src/library/datasets/man/ToothGrowth.Rd b/src/library/datasets/man/ToothGrowth.Rd index 325771f9eab..389ad3a23c5 100644 --- a/src/library/datasets/man/ToothGrowth.Rd +++ b/src/library/datasets/man/ToothGrowth.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2018 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{ToothGrowth} \docType{data} \alias{ToothGrowth} @@ -19,7 +21,7 @@ A data frame with 60 observations on 3 variables. \tabular{rlll}{ [,1] \tab \code{len} \tab numeric \tab Tooth length\cr - [,2] \tab \code{supp} \tab factor \tab Supplement type (VC or OJ).\cr + [,2] \tab \code{supp} \tab factor \tab Supplement type (\I{VC} or \I{OJ}).\cr [,3] \tab \code{dose} \tab numeric \tab Dose in milligrams/day } } diff --git a/src/library/datasets/man/UCBAdmissions.Rd b/src/library/datasets/man/UCBAdmissions.Rd index 16d57fdd441..ce2c4ad9994 100644 --- a/src/library/datasets/man/UCBAdmissions.Rd +++ b/src/library/datasets/man/UCBAdmissions.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2018 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{UCBAdmissions} \docType{data} \alias{UCBAdmissions} @@ -26,7 +28,7 @@ } \details{ This data set is frequently used for illustrating Simpson's paradox, - see Bickel \emph{et al} (1975). At issue is whether the data show evidence + see \I{Bickel} \emph{\I{et al}} (1975). At issue is whether the data show evidence of sex bias in admission practices. There were 2691 male applicants, of whom 1198 (44.5\%) were admitted, compared with 1835 female applicants of whom 557 (30.4\%) were admitted. This gives a sample diff --git a/src/library/datasets/man/airquality.Rd b/src/library/datasets/man/airquality.Rd index a239f97606e..1f2cf94ec4c 100644 --- a/src/library/datasets/man/airquality.Rd +++ b/src/library/datasets/man/airquality.Rd @@ -15,7 +15,7 @@ A data frame with 153 observations on 6 variables. \tabular{rlll}{ - \code{[,1]} \tab \code{Ozone} \tab numeric \tab Ozone (ppb)\cr + \code{[,1]} \tab \code{Ozone} \tab numeric \tab Ozone (\abbr{ppb})\cr \code{[,2]} \tab \code{Solar.R} \tab numeric \tab Solar R (\abbr{lang})\cr \code{[,3]} \tab \code{Wind} \tab numeric \tab Wind (mph)\cr \code{[,4]} \tab \code{Temp} \tab numeric \tab Temperature (degrees F)\cr diff --git a/src/library/datasets/man/attenu.Rd b/src/library/datasets/man/attenu.Rd index bc17ad762f2..422b68d8217 100644 --- a/src/library/datasets/man/attenu.Rd +++ b/src/library/datasets/man/attenu.Rd @@ -26,7 +26,7 @@ \source{ Joyner, W.B., D.M. Boore and R.D. Porcella (1981). Peak horizontal acceleration and velocity from strong-motion records including - records from the 1979 Imperial Valley, California earthquake. USGS + records from the 1979 Imperial Valley, California earthquake. \abbr{USGS} Open File report 81-365. Menlo Park, Ca. } \references{ diff --git a/src/library/datasets/man/co2.Rd b/src/library/datasets/man/co2.Rd index b3a04d83ff6..72e809fa153 100644 --- a/src/library/datasets/man/co2.Rd +++ b/src/library/datasets/man/co2.Rd @@ -9,7 +9,7 @@ \title{Mauna Loa Atmospheric CO2 Concentration} \description{ Atmospheric concentrations of CO\eqn{_2}{2} are expressed in parts per - million (ppm) and reported in the preliminary 1997 SIO manometric mole + million (ppm) and reported in the preliminary 1997 \abbr{SIO} manometric mole fraction scale. } \usage{co2} @@ -23,7 +23,7 @@ } \source{ Keeling, C. D. and Whorf, T. P., - Scripps Institution of Oceanography (SIO), + Scripps Institution of Oceanography (\abbr{SIO}), University of California, La Jolla, California USA 92093-0220. diff --git a/src/library/datasets/man/npk.Rd b/src/library/datasets/man/npk.Rd index 0950d1f0850..7f941aab665 100644 --- a/src/library/datasets/man/npk.Rd +++ b/src/library/datasets/man/npk.Rd @@ -11,7 +11,7 @@ \description{ A classical N, P, K (nitrogen, phosphate, potassium) factorial experiment on the growth of peas conducted on 6 blocks. Each half of a - fractional factorial design confounding the NPK interaction was used + fractional factorial design confounding the \abbr{NPK} interaction was used on 3 of the plots. } \usage{ diff --git a/src/library/datasets/man/pressure.Rd b/src/library/datasets/man/pressure.Rd index 0a9135837b4..c0c2cb7fd2f 100644 --- a/src/library/datasets/man/pressure.Rd +++ b/src/library/datasets/man/pressure.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2007 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{pressure} \docType{data} \alias{pressure} @@ -22,7 +24,7 @@ \source{ Weast, R. C., ed. (1973) \emph{Handbook of Chemistry and Physics}. - CRC Press. + \I{CRC Press}. } \references{ McNeil, D. R. (1977) diff --git a/src/library/datasets/man/randu.Rd b/src/library/datasets/man/randu.Rd index 57fde6fd767..664b32954ee 100644 --- a/src/library/datasets/man/randu.Rd +++ b/src/library/datasets/man/randu.Rd @@ -3,13 +3,15 @@ % Copyright 1995-2007 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{randu} \docType{data} \alias{randu} \title{Random Numbers from Congruential Generator RANDU} \description{ 400 triples of successive random numbers were taken from the VAX - FORTRAN function RANDU running under VMS 1.5. + FORTRAN function RANDU running under \I{VMS} 1.5. } \usage{randu} \details{ @@ -21,7 +23,7 @@ they are ((U[5i+1], U[5i+2], U[5i+3]), i= 0, \dots, 399), and they are rounded to 6 decimal places. - Under VMS versions 2.0 and higher, this problem has been fixed. + Under \I{VMS} versions 2.0 and higher, this problem has been fixed. } \format{ A data frame with 400 observations on 3 variables named \code{x}, diff --git a/src/library/datasets/man/sunspot.month.Rd b/src/library/datasets/man/sunspot.month.Rd index 643d621e525..2735e33cfa3 100644 --- a/src/library/datasets/man/sunspot.month.Rd +++ b/src/library/datasets/man/sunspot.month.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2014 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{sunspot.month} \docType{data} \alias{sunspot.month} @@ -26,7 +28,7 @@ sunspot.month dataset). } \source{ - WDC-SILSO, Solar Influences Data Analysis Center (SIDC), + \I{WDC-SILSO}, Solar Influences Data Analysis Center (SIDC), Royal Observatory of Belgium, Av. Circulaire, 3, B-1180 BRUSSELS Currently at \url{http://www.sidc.be/silso/datafiles}% was http://sidc.oma.be/sunspot-data/ } diff --git a/src/library/datasets/man/sunspot.year.Rd b/src/library/datasets/man/sunspot.year.Rd index e5840286ff8..66e1f60fd8f 100644 --- a/src/library/datasets/man/sunspot.year.Rd +++ b/src/library/datasets/man/sunspot.year.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2007 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{sunspot.year} \docType{data} \alias{sunspot.year} @@ -29,7 +31,7 @@ sunspot.year and \code{\link{sunspots}}. Regularly updated yearly sunspot numbers are available from - WDC-SILSO, Royal Observatory of Belgium, at + \I{WDC-SILSO}, Royal Observatory of Belgium, at \url{http://www.sidc.be/silso/datafiles} } \examples{ diff --git a/src/library/datasets/man/swiss.Rd b/src/library/datasets/man/swiss.Rd index 89cbb939918..b0141e27336 100644 --- a/src/library/datasets/man/swiss.Rd +++ b/src/library/datasets/man/swiss.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2019 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{swiss} \docType{data} \alias{swiss} @@ -55,7 +57,7 @@ indicating their source as \dQuote{Data used by permission of Franice van de Walle. Office of Population Research, Princeton University, 1976. Unpublished data - assembled under NICHD contract number No 1-HD-O-2077.} + assembled under NICHD contract number No \I{1-HD-O-2077}.} } \references{ Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) diff --git a/src/library/grDevices/man/Devices.Rd b/src/library/grDevices/man/Devices.Rd index bfc12553f38..9f462b4e983 100644 --- a/src/library/grDevices/man/Devices.Rd +++ b/src/library/grDevices/man/Devices.Rd @@ -54,7 +54,7 @@ It is possible for an \R package (or an \R front-end such as RStudio) to provide further graphics devices and several packages on CRAN do so. These include devices outputting SVG (\CRANpkg{svglite} and - PGF/TiKZ (\CRANpkg{tikzDevice}, TeX-based graphics, see + \abbr{PGF}/TiKZ (\CRANpkg{tikzDevice}, TeX-based graphics, see \url{https://pgf.sourceforge.net/}). } \seealso{ diff --git a/src/library/grDevices/man/make.rgb.Rd b/src/library/grDevices/man/make.rgb.Rd index a2c08ee99b9..03f85d703fe 100644 --- a/src/library/grDevices/man/make.rgb.Rd +++ b/src/library/grDevices/man/make.rgb.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2012 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{make.rgb} \alias{make.rgb} \alias{colorConverter} @@ -18,15 +20,15 @@ make.rgb(red, green, blue, name = NULL, white = "D65", colorConverter(toXYZ, fromXYZ, name, white = NULL, vectorized = FALSE) } \arguments{ - \item{red,green,blue}{Chromaticity (xy or xyY) of RGB primaries} + \item{red,green,blue}{Chromaticity (\I{xy} or \I{xyY}) of RGB primaries} \item{name}{Name for the colour space} \item{white}{Character string specifying the reference white (see \sQuote{Details}.)} \item{gamma}{Display gamma (nonlinearity). A positive number or the string \code{"sRGB"} } - \item{fromXYZ}{Function to convert from XYZ tristimulus coordinates + \item{fromXYZ}{Function to convert from \abbr{XYZ} tristimulus coordinates to this space} - \item{toXYZ}{Function to convert from this space to XYZ tristimulus + \item{toXYZ}{Function to convert from this space to \abbr{XYZ} tristimulus coordinates.} \item{vectorized}{Whether \code{fromXYZ} and \code{toXYZ} are vectorized internally to handle input color matrices.} @@ -44,7 +46,7 @@ colorConverter(toXYZ, fromXYZ, name, white = NULL, vectorized = FALSE) to a gamma of 2.2; \code{gamma = "sRGB"} uses this function. Colour spaces other than RGB can be specified directly by giving - conversions to and from XYZ tristimulus coordinates. + conversions to and from \abbr{XYZ} tristimulus coordinates. The functions should take two arguments. The first is a vector giving the coordinates for one colour. The second argument is the reference white. If a specific reference white is included in the definition of diff --git a/src/library/grDevices/man/pdf.Rd b/src/library/grDevices/man/pdf.Rd index 95348c098a3..31ae7e07c67 100644 --- a/src/library/grDevices/man/pdf.Rd +++ b/src/library/grDevices/man/pdf.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2024 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{pdf} \alias{pdf} \encoding{UTF-8} @@ -57,7 +59,7 @@ pdf(file = if(onefile) "Rplots.pdf" else "Rplot\%03d.pdf", \describe{ \item{on Unix-alikes}{ as \file{"ISOLatin1.enc"} unless the locale is recognized as - corresponding to a language using ISO 8859-\{2,5,7,13,15\} or KOI8-\{R,U\}. + corresponding to a language using ISO 8859-\{2,5,7,13,15\} or \I{KOI8}-\{R,U\}. } \item{on Windows}{ as \file{"CP1250.enc"} (Central European), \code{"CP1251.enc"} (Cyrillic), @@ -75,7 +77,7 @@ pdf(file = if(onefile) "Rplots.pdf" else "Rplot\%03d.pdf", \item{fg}{the initial foreground color to be used. Defaults to \code{"black"}.} \item{pointsize}{the default point size to be used. Strictly - speaking, in bp, that is 1/72 of an inch, but approximately in + speaking, in \abbr{bp}, that is 1/72 of an inch, but approximately in points. Defaults to \code{12}.} \item{pagecentre}{logical: should the device region be centred on the page? -- is only relevant for \code{paper != "special"}. diff --git a/src/library/grDevices/man/plotmath.Rd b/src/library/grDevices/man/plotmath.Rd index 5646338d4bd..b8557de0404 100644 --- a/src/library/grDevices/man/plotmath.Rd +++ b/src/library/grDevices/man/plotmath.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2022 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{plotmath} \alias{plotmath} \alias{symbol}% also for R symbols aka names in ../../base/man/name.Rd @@ -109,9 +111,9 @@ \code{tilde(x)} \tab x with a tilde \cr \code{dot(x)} \tab x with a dot \cr \code{ring(x)} \tab x with a ring \cr - \code{bar(xy)} \tab xy with bar \cr - \code{widehat(xy)} \tab xy with a wide circumflex \cr - \code{widetilde(xy)} \tab xy with a wide tilde \cr + \code{bar(xy)} \tab \I{xy} with bar \cr + \code{widehat(xy)} \tab \I{xy} with a wide circumflex \cr + \code{widetilde(xy)} \tab \I{xy} with a wide tilde \cr \code{x \%<->\% y} \tab x double-arrow y \cr \code{x \%->\% y} \tab x right-arrow y \cr \code{x \%<-\% y} \tab x left-arrow y \cr diff --git a/src/library/grDevices/man/postscript.Rd b/src/library/grDevices/man/postscript.Rd index 4f2ab187361..65a268146df 100644 --- a/src/library/grDevices/man/postscript.Rd +++ b/src/library/grDevices/man/postscript.Rd @@ -72,7 +72,7 @@ postscript(file = if(onefile) "Rplots.ps" else "Rplot\%03d.ps", Defaults to true, that is landscape orientation on paper sizes with width less than height.} \item{pointsize}{the default point size to be used. Strictly - speaking, in bp, that is 1/72 of an inch, but approximately in + speaking, in \abbr{bp}, that is 1/72 of an inch, but approximately in points. Defaults to \code{12}.} \item{paper}{the size of paper in the printer. The choices are \code{"a4"}, \code{"letter"} (or \code{"us"}), \code{"legal"} and diff --git a/src/library/grDevices/man/postscriptFonts.Rd b/src/library/grDevices/man/postscriptFonts.Rd index ea3b50ba7a4..fd7bdc5f02c 100644 --- a/src/library/grDevices/man/postscriptFonts.Rd +++ b/src/library/grDevices/man/postscriptFonts.Rd @@ -71,7 +71,7 @@ pdfFonts(\dots) The fonts are not embedded in the resulting PostScript or PDF file, so software including the PostScript or PDF plot file should either embed the font outlines (usually from \file{.pfb} or \file{.pfa} files) or - use DSC comments to instruct the print spooler or including + use \abbr{DSC} comments to instruct the print spooler or including application to do so (see also \code{\link{embedFonts}}). A font family has both an \R-level name, the argument name used when @@ -107,7 +107,7 @@ pdfFonts(\dots) Korea1deb (PDF) \tab \code{HYGothic-Medium-Acro}\cr \tab from Adobe Reader 4.0 Korean Font Pack\cr GB1 (PS) \tab \code{BousungEG-Light-GB}\cr \tab TrueType font found on some Linux systems\cr GB1 (PDF) \tab \code{STSong-Light-Acro}\cr \tab from Adobe Reader 7.0 Simplified Chinese Font Pack\cr - CNS1 (PS) \tab \code{MOESung-Regular}\cr \tab Ken Lunde's CJKV resources\cr + CNS1 (PS) \tab \code{MOESung-Regular}\cr \tab Ken Lunde's \abbr{CJKV} resources\cr CNS1 (PDF) \tab \code{MSungStd-Light-Acro}\cr \tab from Adobe Reader 7.0 Traditional Chinese Font Pack\cr } % \code{Baekmuk-Batang} was found at \url{ftp://ftp.mizi.com/pub/baekmuk/}. diff --git a/src/library/grDevices/man/unix/png.Rd b/src/library/grDevices/man/unix/png.Rd index 37dc18fb0cd..a6513162076 100644 --- a/src/library/grDevices/man/unix/png.Rd +++ b/src/library/grDevices/man/unix/png.Rd @@ -53,7 +53,7 @@ tiff(filename = "Rplot\%03d.tiff", given. Can be \code{px} (pixels, the default), \code{in} (inches), \code{cm} or \code{mm}.} \item{pointsize}{the default pointsize of plotted text, interpreted as - big points (1/72 inch) at \code{res} ppi.} + big points (1/72 inch) at \code{res} \abbr{ppi}.} \item{bg}{the initial background colour: can be overridden by setting par("bg").} \item{quality}{the \sQuote{quality} of the \abbr{JPEG} image, as a @@ -63,7 +63,7 @@ tiff(filename = "Rplot\%03d.tiff", numeric value supported by the underlying \code{libtiff} library : see its \file{tiff.h} header file. Ignored with a warning for \code{type = "quartz"}.} - \item{res}{The nominal resolution in ppi which will be recorded in the + \item{res}{The nominal resolution in \abbr{ppi} which will be recorded in the bitmap file, if a positive integer. Also used for \code{units} other than the default, and to convert points to pixels.} \item{\dots}{for \code{type = "Xlib"} only, additional arguments to @@ -136,13 +136,13 @@ tiff(filename = "Rplot\%03d.tiff", \code{\link{capabilities}("aqua")}). By default no resolution is recorded in the file, except for \abbr{BMP}. - Viewers will often assume a nominal resolution of 72 ppi when none is + Viewers will often assume a nominal resolution of 72 \abbr{ppi} when none is recorded. As resolutions in \abbr{PNG} files are recorded in pixels/metre, - the reported ppi value will be changed slightly. + the reported \abbr{ppi} value will be changed slightly. For graphics parameters that make use of dimensions in inches (including font sizes in points) the resolution used is \code{res} (or - 72 ppi if unset). + 72 \abbr{ppi} if unset). \code{png} will normally use a palette if there are less than 256 colours on the page, and record a 24-bit RGB file otherwise (or a @@ -156,7 +156,7 @@ tiff(filename = "Rplot\%03d.tiff", recorded with a dark grey matte which will show up in some viewers, including \command{Preview} on macOS. - Unknown resolutions in \abbr{BMP} files are recorded as 72 ppi. + Unknown resolutions in \abbr{BMP} files are recorded as 72 \abbr{ppi}. } \value{ @@ -177,7 +177,7 @@ tiff(filename = "Rplot\%03d.tiff", devices. \itemize{ \item On Windows, devices based on plotting to a hidden screen using - Windows' GDI calls. + Windows' \abbr{GDI} calls. \item On platforms with support for X11, plotting to a hidden X11 display. @@ -244,9 +244,9 @@ tiff(filename = "Rplot\%03d.tiff", \itemize{ \item The default device size is in pixels. - \item Font sizes are in big points interpreted at \code{res} ppi. + \item Font sizes are in big points interpreted at \code{res} \abbr{ppi}. \item The default font family is Helvetica. - \item Line widths in 1/96 inch (interpreted at \code{res} ppi), + \item Line widths in 1/96 inch (interpreted at \code{res} \abbr{ppi}), minimum one pixel for \code{type = "Xlib"}, 0.01 for \code{type = "cairo"}. \item For \code{type = "Xlib"} circle radii are in pixels with diff --git a/src/library/grDevices/man/windows.Rd b/src/library/grDevices/man/windows.Rd index 1ab1efc7b38..dbd1cccd7df 100644 --- a/src/library/grDevices/man/windows.Rd +++ b/src/library/grDevices/man/windows.Rd @@ -212,7 +212,7 @@ win.print(width = 7, height = 7, pointsize = 12, printer = "", How the fonts look depends on the antialiasing settings, both through the \code{antialias} argument and the machine settings. These are - hints to Windows GDI that may not be able to be followed, but + hints to Windows \abbr{GDI} that may not be able to be followed, but \code{antialias = "none"} should ensure that no antialiasing is used. For a screen device the default depends on the machine settings: it will be \code{"cleartype"} if that has been enabled. Note that the diff --git a/src/library/grDevices/man/windows/png.Rd b/src/library/grDevices/man/windows/png.Rd index bdeea144e33..cb0c40e5ba0 100644 --- a/src/library/grDevices/man/windows/png.Rd +++ b/src/library/grDevices/man/windows/png.Rd @@ -70,11 +70,11 @@ tiff(filename = "Rplot\%03d.tif", text and line widths.} \item{family}{A length-one character vector specifying the default font family. The default means to use the font numbers on the - Windows GDI versions and \code{"sans"} on the cairographics + Windows \abbr{GDI} versions and \code{"sans"} on the cairographics versions.} \item{restoreConsole}{See the \sQuote{Details} section of \code{\link{windows}}. For \code{type == "windows"} only.} - \item{type}{Should be plotting be done using Windows GDI or cairographics?} + \item{type}{Should be plotting be done using Windows \abbr{GDI} or cairographics?} \item{antialias}{Length-one character vector. For allowed values and their effect on fonts with \code{type = @@ -101,8 +101,8 @@ tiff(filename = "Rplot\%03d.tif", appropriate) values uncompressed---such files are widely accepted, which is their main virtue over \abbr{PNG}. - Windows GDI imposes limits on the size of bitmaps: these are not - documented in the SDK and may depend on the version of Windows. + Windows \abbr{GDI} imposes limits on the size of bitmaps: these are not + documented in the \abbr{SDK} and may depend on the version of Windows. It seems that \code{width} and \code{height} are each limited to \eqn{2^{15}-1}{2^15-1}. In addition, there are limits on the total number of pixels which depend on the graphics hardware. @@ -164,7 +164,7 @@ tiff(filename = "Rplot\%03d.tif", devices. \itemize{ \item On Windows, devices based on plotting to a hidden screen using - Windows' GDI calls. + Windows' \abbr{GDI} calls. \item On platforms with support for X11, plotting to a hidden X11 display. diff --git a/src/library/graphics/man/par.Rd b/src/library/graphics/man/par.Rd index 34c02957ba5..0a3368b27d5 100644 --- a/src/library/graphics/man/par.Rd +++ b/src/library/graphics/man/par.Rd @@ -310,7 +310,7 @@ par(\dots, no.readonly = FALSE) Specification}. A few devices have an argument to set the initial value, which is otherwise \code{"black"}.} \item{\code{fig}}{A numerical vector of the form \code{c(x1, x2, y1, - y2)} which gives the (NDC) coordinates of the figure region in + y2)} which gives the (\abbr{NDC}) coordinates of the figure region in the display region of the device. If you set this, unlike S, you start a new plot, so to add to an existing plot use \code{new = TRUE} as well.} @@ -465,7 +465,7 @@ par(\dots, no.readonly = FALSE) \if{latex}{\figure{oma.pdf}{options: width=6cm}} } \item{\code{omd}}{A vector of the form \code{c(x1, x2, y1, y2)} - giving the region \emph{inside} outer margins in NDC (= + giving the region \emph{inside} outer margins in \abbr{NDC} (= normalized device coordinates), i.e., as a fraction (in \eqn{[0, 1]}) of the device region.} \item{\code{omi}}{A vector of the form \code{c(bottom, left, top, @@ -494,7 +494,7 @@ par(\dots, no.readonly = FALSE) and \code{omi}). What is meant by \sQuote{point size} is device-specific, but most - devices mean a multiple of 1bp, that is 1/72 of an inch. + devices mean a multiple of 1\abbr{bp}, that is 1/72 of an inch. } \item{\code{pty}}{A character specifying the type of plot region to be used; \code{"s"} generates a square plotting region and diff --git a/src/library/graphics/man/screen.Rd b/src/library/graphics/man/screen.Rd index b6276ee3f02..9e34cc986d2 100644 --- a/src/library/graphics/man/screen.Rd +++ b/src/library/graphics/man/screen.Rd @@ -19,7 +19,7 @@ close.screen(n, all.screens = FALSE) \item{figs}{a two-element vector describing the number of rows and the number of columns in a screen matrix \emph{or} a matrix with 4 columns. If a matrix, then each row describes a screen with values for the left, - right, bottom, and top of the screen (in that order) in NDC units, + right, bottom, and top of the screen (in that order) in \abbr{NDC} units, that is 0 at the lower left corner of the device surface, and 1 at the upper right corner.} \item{screen}{a number giving the screen to be split. It defaults to diff --git a/src/library/grid/man/grid.grab.Rd b/src/library/grid/man/grid.grab.Rd index 5969356654f..79574be7a1f 100644 --- a/src/library/grid/man/grid.grab.Rd +++ b/src/library/grid/man/grid.grab.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2007 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{grid.grab} \alias{grid.grab} \alias{grid.grabExpr} @@ -58,7 +60,7 @@ grid.grabExpr(expr, warn = 2, wrap = wrap.grobs, wrap.grobs = FALSE, the display list (including those that are popped) and every grob on the display list as a child of the new - gTree; each child has a vpPath in the vp slot so that it is + gTree; each child has a vpPath in the \I{vp} slot so that it is drawn in the appropriate viewport. In other words, the gTree contains all elements on the display list, but in a slightly altered form. diff --git a/src/library/grid/man/unit.Rd b/src/library/grid/man/unit.Rd index 42a4f94b8d5..9a89199d8b6 100644 --- a/src/library/grid/man/unit.Rd +++ b/src/library/grid/man/unit.Rd @@ -42,7 +42,7 @@ is.unit(x) \item{\code{"mm"}}{Millimetres. 10 mm = 1 cm.} \item{\code{"points"}}{Points. 72.27 pt = 1 in.} \item{\code{"picas"}}{Picas. 1 \abbr{pc} = 12 pt.} - \item{\code{"bigpts"}}{Big Points. 72 bp = 1 in.} + \item{\code{"bigpts"}}{Big Points. 72 \abbr{bp} = 1 in.} \item{\code{"dida"}}{Dida. 1157 dd = 1238 pt.} \item{\code{"cicero"}}{Cicero. 1 cc = 12 dd.} \item{\code{"scaledpts"}}{Scaled Points. 65536 \abbr{sp} = 1 pt.} diff --git a/src/library/parallel/man/detectCores.Rd b/src/library/parallel/man/detectCores.Rd index 6f5b29df511..8436965f4d2 100644 --- a/src/library/parallel/man/detectCores.Rd +++ b/src/library/parallel/man/detectCores.Rd @@ -47,7 +47,7 @@ detectCores(all.tests = FALSE, logical = TRUE) Where virtual machines are in use, one would hope that the result for \code{logical = TRUE} represents the number of CPUs available (or - potentially available) to that particular VM. + potentially available) to that particular \abbr{VM}. } \author{ Simon Urbanek and Brian Ripley diff --git a/src/library/parallel/man/makeCluster.Rd b/src/library/parallel/man/makeCluster.Rd index c69ed8238c8..f8a40d32c76 100644 --- a/src/library/parallel/man/makeCluster.Rd +++ b/src/library/parallel/man/makeCluster.Rd @@ -3,6 +3,8 @@ % Copyright 2003-2023 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{makeCluster} \alias{makeCluster} \alias{makePSOCKcluster} @@ -105,7 +107,7 @@ getDefaultCluster() load the \pkg{methods} package: not loading it saves ca 30\% of the startup CPU time of the cluster.} \item{\code{useXDR}}{Logical. If true (default) serialization will - use XDR: where large amounts of data are to be transferred and + use \I{XDR}: where large amounts of data are to be transferred and all the nodes are little-endian, communication may be substantially faster if this is set to false.} \item{\code{setup_strategy}}{Character. If \code{"parallel"} (default) diff --git a/src/library/stats/man/KalmanLike.Rd b/src/library/stats/man/KalmanLike.Rd index 54816eeac67..5179be366c8 100644 --- a/src/library/stats/man/KalmanLike.Rd +++ b/src/library/stats/man/KalmanLike.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2018 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{KalmanLike} \alias{KalmanLike}%-> ../R/Kalman.R \alias{KalmanRun} @@ -73,7 +75,7 @@ makeARIMA(phi, theta, Delta, kappa = 1e6, \code{makeARIMA} constructs the state-space model for an ARIMA model, see also \code{\link{arima}}. - The state-space initialization has used Gardner \emph{et al}'s method + The state-space initialization has used Gardner \emph{\I{et al}}'s method (\code{SSinit = "Gardner1980"}), as only method for years. However, that suffers sometimes from deficiencies when close to non-stationarity. For this reason, it may be replaced as default in the future and only @@ -86,7 +88,7 @@ makeARIMA(phi, theta, Delta, kappa = 1e6, It computes the covariance matrix of \eqn{(X_{t-1},...,X_{t-p},Z_t,...,Z_{t-q})} by the method of difference equations (page 93 of Brockwell and Davis), - apparently suggested by a referee of Gardner \emph{et al} (see p.314 of + apparently suggested by a referee of Gardner \emph{\I{et al}} (see p.314 of their paper). } diff --git a/src/library/stats/man/SSD.Rd b/src/library/stats/man/SSD.Rd index c1c01906666..7a650317ca4 100644 --- a/src/library/stats/man/SSD.Rd +++ b/src/library/stats/man/SSD.Rd @@ -6,7 +6,7 @@ \name{SSD} \alias{SSD} \alias{estVar} -\title{SSD Matrix and Estimated Variance Matrix in Multivariate Models} +\title{\abbr{SSD} Matrix and Estimated Variance Matrix in Multivariate Models} \description{ Functions to compute matrix of residual sums of squares and products, or the estimated variance matrix for multivariate linear models. diff --git a/src/library/stats/man/StructTS.Rd b/src/library/stats/man/StructTS.Rd index 906a04d3d04..3cde8e3cae0 100644 --- a/src/library/stats/man/StructTS.Rd +++ b/src/library/stats/man/StructTS.Rd @@ -18,7 +18,7 @@ StructTS(x, type = c("level", "trend", "BSM"), init = NULL, \arguments{ \item{x}{a univariate numeric time series. Missing values are allowed.} - \item{type}{the class of structural model. If omitted, a BSM is used + \item{type}{the class of structural model. If omitted, a \abbr{BSM} is used for a time series with \code{frequency(x) > 1}, and a local trend model otherwise. Can be abbreviated.} @@ -73,7 +73,7 @@ StructTS(x, type = c("level", "trend", "BSM"), init = NULL, }{s[t+1] = -s[t] - \dots - s[t - s + 2] + w[t], w[t] ~ N(0, \sigma^2_w)} The boundary case \eqn{\sigma^2_\omega = 0}{\sigma^2_w = 0} corresponds to a deterministic (but arbitrary) seasonal pattern. (This is - sometimes known as the \sQuote{dummy variable} version of the BSM.) + sometimes known as the \sQuote{dummy variable} version of the \abbr{BSM}.) } \value{ A list of class \code{"StructTS"} with components: diff --git a/src/library/stats/man/anova.mlm.Rd b/src/library/stats/man/anova.mlm.Rd index 52ea53fb662..b983fb9a668 100644 --- a/src/library/stats/man/anova.mlm.Rd +++ b/src/library/stats/man/anova.mlm.Rd @@ -61,7 +61,7 @@ model formulas with respect to \code{idata} (the tests will be invariant to parametrization of the quotient space \code{M/X}). - As with \code{anova.lm}, all test statistics use the SSD matrix from + As with \code{anova.lm}, all test statistics use the \abbr{SSD} matrix from the largest model considered as the (generalized) denominator. Contrary to other \code{anova} methods, the intercept is not excluded @@ -74,7 +74,7 @@ } \note{ The Huynh--Feldt epsilon differs from that calculated by SAS (as of - v.\sspace{}8.2) except when the DF is equal to the number of observations + v.\sspace{}8.2) except when the \abbr{DF} is equal to the number of observations minus one. This is believed to be a bug in SAS, not in \R. } diff --git a/src/library/stats/man/extractAIC.Rd b/src/library/stats/man/extractAIC.Rd index b8f216155b0..d275659e69b 100644 --- a/src/library/stats/man/extractAIC.Rd +++ b/src/library/stats/man/extractAIC.Rd @@ -60,7 +60,7 @@ extractAIC(fit, scale, k = 2, \dots) assumptions this makes. \code{k = 2} corresponds to the traditional AIC, using \code{k = - log(n)} provides the BIC (Bayesian IC) instead. + log(n)} provides the BIC (Bayesian \abbr{IC}) instead. Note that the methods for this function may differ in their assumptions from those of methods for \code{\link{AIC}} (usually diff --git a/src/library/stats/man/hclust.Rd b/src/library/stats/man/hclust.Rd index b4b73a4e9e1..669403d774f 100644 --- a/src/library/stats/man/hclust.Rd +++ b/src/library/stats/man/hclust.Rd @@ -26,8 +26,8 @@ hclust(d, method = "complete", members = NULL) \item{method}{the agglomeration method to be used. This should be (an unambiguous abbreviation of) one of \code{"ward.D"}, \code{"ward.D2"}, \code{"single"}, \code{"complete"}, - \code{"average"} (= UPGMA), \code{"mcquitty"} (= WPGMA), - \code{"median"} (= WPGMC) or \code{"centroid"} (= UPGMC).} + \code{"average"} (= \abbr{UPGMA}), \code{"mcquitty"} (= \abbr{WPGMA}), + \code{"median"} (= \abbr{WPGMC}) or \code{"centroid"} (= \abbr{UPGMC}).} \item{members}{\code{NULL} or a vector with length size of \code{d}. See the \sQuote{Details} section.} diff --git a/src/library/stats/man/loglin.Rd b/src/library/stats/man/loglin.Rd index b961f9b0a77..8e4f365518f 100644 --- a/src/library/stats/man/loglin.Rd +++ b/src/library/stats/man/loglin.Rd @@ -75,10 +75,10 @@ loglin(table, margin, start = rep(1, length(table)), fit = FALSE, Ratio Test and Pearson test statistics have an asymptotic chi-squared distribution with \code{df} degrees of freedom. - Note that the IPF steps are applied to the factors in the order given + Note that the \abbr{IPF} steps are applied to the factors in the order given in \code{margin}. Hence if the model is decomposable and the order given in \code{margin} is a running intersection property ordering - then IPF will converge in one iteration. + then \abbr{IPF} will converge in one iteration. Package \CRANpkg{MASS} contains \code{loglm}, a front-end to \code{loglin} which allows the log-linear model to be specified and diff --git a/src/library/stats/man/mauchly.test.Rd b/src/library/stats/man/mauchly.test.Rd index e269a27fd7c..69692dbc0ce 100644 --- a/src/library/stats/man/mauchly.test.Rd +++ b/src/library/stats/man/mauchly.test.Rd @@ -35,7 +35,7 @@ mauchly.test(object, ...) The basic method is for objects of class \code{SSD} the method for \code{mlm} objects just extracts the - SSD matrix and invokes the corresponding method with the same options + \abbr{SSD} matrix and invokes the corresponding method with the same options and arguments. The \code{T} argument is used to transform the observations prior to @@ -53,7 +53,7 @@ mauchly.test(object, ...) compound symmetry in the untransformed covariance matrix. Notice that the defaults involve \code{p}, which is calculated - internally as the dimension of the SSD matrix, and a couple of hidden + internally as the dimension of the \abbr{SSD} matrix, and a couple of hidden functions in the \pkg{stats} namespace, namely \code{proj} which calculates projection matrices from design matrices or model formulas and \code{Thin.row} which removes linearly dependent rows from a diff --git a/src/library/stats/man/stlmethods.Rd b/src/library/stats/man/stlmethods.Rd index 9392d215874..d307dc00526 100644 --- a/src/library/stats/man/stlmethods.Rd +++ b/src/library/stats/man/stlmethods.Rd @@ -5,7 +5,7 @@ \name{stlmethods} \alias{plot.stl} -\title{Methods for STL Objects} +\title{Methods for \abbr{STL} Objects} \description{ Methods for objects of class \code{stl}, typically the result of \code{\link{stl}}. The \code{plot} method does a multiple figure plot diff --git a/src/library/tools/man/checkRdaFiles.Rd b/src/library/tools/man/checkRdaFiles.Rd index c26bd082a55..a674cc550a2 100644 --- a/src/library/tools/man/checkRdaFiles.Rd +++ b/src/library/tools/man/checkRdaFiles.Rd @@ -3,6 +3,8 @@ % Copyright 2009-2021 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{checkRdaFiles} \alias{checkRdaFiles} \alias{resaveRdaFiles} @@ -11,7 +13,7 @@ } \description{ This reports for each of the files produced by \code{save} the size, - if it was saved in ASCII or XDR binary format, and if it was + if it was saved in ASCII or \I{XDR} binary format, and if it was compressed (and if so in what format). Usually such files have extension \file{.rda} or \file{.RData}, hence diff --git a/src/library/utils/R/aspell.R b/src/library/utils/R/aspell.R index 61f89318ce9..789386c3265 100644 --- a/src/library/utils/R/aspell.R +++ b/src/library/utils/R/aspell.R @@ -371,7 +371,7 @@ function(x) } format.aspell_inspect_context <- -function(x, ..., byfile = FALSE) +function(x, ..., byfile = FALSE, indent = 2L) { chunks <- if(byfile) { chunks <- split(x, x$File) @@ -385,9 +385,13 @@ function(x, ..., byfile = FALSE) names(chunks), chunks) } else { - y <- sprintf(" %s:%s:%s\n %s%s%s\n %s%s", + p <- strrep(" ", indent) + y <- sprintf("%s%s:%s:%s\n%s%s%s%s\n%s%s%s", + p, x$File, x$Line, x$Column, + p, x$Left, x$Original, x$Right, + p, strrep(" ", as.integer(x$Column) - 1L), strrep("^", nchar(x$Original))) chunks <- split(y, x$Original) @@ -1499,6 +1503,7 @@ function(which, new = character()) readLines(txt, encoding = "UTF-8"), enc2utf8(new))) new <- new[order(tolower(new), new)] + new <- new[nzchar(new)] writeLines(new, txt, useBytes = TRUE) saveRDS(new, rds) } diff --git a/src/library/utils/man/BATCH.Rd b/src/library/utils/man/BATCH.Rd index b6805bf04ca..f1df3b8f029 100644 --- a/src/library/utils/man/BATCH.Rd +++ b/src/library/utils/man/BATCH.Rd @@ -31,8 +31,8 @@ suppress this behavior, add \code{options(echo = FALSE)} at the beginning of \code{infile}, or use option \option{--no-echo}. - The \code{infile} can have end of line marked by LF or CRLF (but not - just CR), and files with an incomplete last line (missing end of line + The \code{infile} can have end of line marked by \abbr{LF} or \abbr{CRLF} (but not + just \abbr{CR}), and files with an incomplete last line (missing end of line (\abbr{EOL}) mark) are processed correctly. A final expression \samp{proc.time()} will be executed after the input diff --git a/src/library/utils/man/Rprof.Rd b/src/library/utils/man/Rprof.Rd index 97192768a7e..d508b25a51f 100644 --- a/src/library/utils/man/Rprof.Rd +++ b/src/library/utils/man/Rprof.Rd @@ -28,7 +28,7 @@ Rprof(filename = "Rprof.out", append = FALSE, interval = 0.02, real: distance (time interval) between samples in seconds. } \item{memory.profiling}{logical: write memory use information to the file?} - \item{gc.profiling}{logical: record whether GC is running?} + \item{gc.profiling}{logical: record whether \abbr{GC} is running?} \item{line.profiling}{logical: write line locations to the file?} \item{filter.callframes}{logical: filter out intervening call frames of the call tree. See the filtering out call frames section.} diff --git a/src/library/utils/man/aspell.Rd b/src/library/utils/man/aspell.Rd index d446b856919..e934e407a88 100644 --- a/src/library/utils/man/aspell.Rd +++ b/src/library/utils/man/aspell.Rd @@ -45,7 +45,7 @@ aspell(files, filter, control = list(), encoding = "unknown", obtaining the Aspell, Hunspell and (International) Ispell programs and dictionaries. - On Windows, Aspell is available via MSYS2. One should use a non-Cygwin + On Windows, Aspell is available via \abbr{MSYS2}. One should use a non-Cygwin version, e.g. package \code{mingw-w64-x86_64-aspell}. The version built against the Cygwin runtime (package \code{aspell}) requires Unix line endings in files and Unix-style paths, which is incompatible with diff --git a/src/library/utils/man/browseURL.Rd b/src/library/utils/man/browseURL.Rd index c899d8619c5..b584ac986d4 100644 --- a/src/library/utils/man/browseURL.Rd +++ b/src/library/utils/man/browseURL.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2022 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{browseURL} \alias{browseURL} \title{Load URL into an HTML Browser} @@ -51,7 +53,7 @@ browseURL(url, browser = getOption("browser"), it, the URL is opened in any already-running browser or a new one if necessary. This mechanism currently is available for browsers which support the \code{"-remote openURL(...)"} interface (which includes - Mozilla and Opera), Galeon, KDE konqueror (\emph{via} kfmclient) and + Mozilla and Opera), Galeon, \I{KDE} konqueror (\emph{via} kfmclient) and the GNOME interface to Mozilla. (Firefox has dropped support, but defaults to using an already-running browser.) Note that the type of browser is determined from its name, so this mechanism will only be diff --git a/src/library/utils/man/clipboard.Rd b/src/library/utils/man/clipboard.Rd index f72b3acb8a9..433ec703460 100644 --- a/src/library/utils/man/clipboard.Rd +++ b/src/library/utils/man/clipboard.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2022 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{clipboard} \Rdversion{1.1} \alias{getClipboardFormats} @@ -33,23 +35,23 @@ writeClipboard(str, format = 13) The standard formats include \tabular{lrl}{ - CF_TEXT \tab 1 \tab Text in the machine's locale\cr - CF_BITMAP \tab 2 \tab \cr - CF_METAFILEPICT \tab 3 \tab Metafile picture\cr - CF_SYLK \tab 4 \tab Symbolic link\cr - CF_DIF \tab 5 \tab Data Interchange Format\cr - CF_TIFF \tab 6 \tab Tagged-Image File Format\cr - CF_OEMTEXT \tab 7 \tab Text in the OEM codepage\cr - CF_DIB \tab 8 \tab Device-Independent Bitmap\cr - CF_PALETTE \tab 9 \tab \cr - CF_PENDATA \tab 10 \tab \cr - CF_RIFF \tab 11 \tab Audio data\cr - CF_WAVE \tab 12 \tab Audio data\cr - CF_UNICODETEXT \tab 13 \tab Text in Unicode (UCS-2)\cr - CF_ENHMETAFILE \tab 14 \tab Enhanced metafile\cr - CF_HDROP \tab 15 \tab Drag-and-drop data\cr - CF_LOCALE \tab 16 \tab Locale for the text on the clipboard\cr - CF_MAX \tab 17 \tab Shell-oriented formats\cr + \I{CF_TEXT} \tab 1 \tab Text in the machine's locale\cr + \I{CF_BITMAP} \tab 2 \tab \cr + \I{CF_METAFILEPICT} \tab 3 \tab Metafile picture\cr + \I{CF_SYLK} \tab 4 \tab Symbolic link\cr + \I{CF_DIF} \tab 5 \tab Data Interchange Format\cr + \I{CF_TIFF} \tab 6 \tab Tagged-Image File Format\cr + \I{CF_OEMTEXT} \tab 7 \tab Text in the \abbr{OEM} codepage\cr + \I{CF_DIB} \tab 8 \tab Device-Independent Bitmap\cr + \I{CF_PALETTE} \tab 9 \tab \cr + \I{CF_PENDATA} \tab 10 \tab \cr + \I{CF_RIFF} \tab 11 \tab Audio data\cr + \I{CF_WAVE} \tab 12 \tab Audio data\cr + \I{CF_UNICODETEXT} \tab 13 \tab Text in Unicode (\I{UCS-2})\cr + \I{CF_ENHMETAFILE} \tab 14 \tab Enhanced metafile\cr + \I{CF_HDROP} \tab 15 \tab Drag-and-drop data\cr + \I{CF_LOCALE} \tab 16 \tab Locale for the text on the clipboard\cr + \I{CF_MAX} \tab 17 \tab Shell-oriented formats\cr } Applications normally make data available in one or more of these and possibly additional private formats. Use \code{raw = TRUE} to read binary @@ -61,7 +63,7 @@ writeClipboard(str, format = 13) based on \code{CF_LOCALE}, if available.) The \code{writeClipboard} function will write a character vector as - text or Unicode text with standard CR-LF line terminators. It will + text or Unicode text with standard \abbr{CRLF} line terminators. It will copy a raw vector directly to the clipboard without any changes. It is recommended to use Unicode text (the default) instead of text to avoid interoperability problems. (Note that \R 4.2 and newer on recent systems uses UTF-8 as the diff --git a/src/library/utils/man/dataentry.Rd b/src/library/utils/man/dataentry.Rd index 88d1ceef87b..a4216cef09e 100644 --- a/src/library/utils/man/dataentry.Rd +++ b/src/library/utils/man/dataentry.Rd @@ -3,6 +3,8 @@ % Copyright 1995-2009 R Core Team % Distributed under GPL 2 or later +\newcommand{\I}{#1} + \name{dataentry} \title{Spreadsheet Interface for Entering Data} \usage{ @@ -85,7 +87,7 @@ de(\dots, Modes = list(), Names = NULL) Using any other key starts an editing process on the currently selected cell: moving away from that cell enters the edited value - whereas Esc cancels the edit and restores the previous value. When + whereas \I{Esc} cancels the edit and restores the previous value. When the editing process starts the cell is cleared. #ifdef windows The cursor changes to an I-beam to indicate that the cell is in enter mode. diff --git a/src/library/utils/man/download.file.Rd b/src/library/utils/man/download.file.Rd index 8b36c3dbd27..8cc2365cd37 100644 --- a/src/library/utils/man/download.file.Rd +++ b/src/library/utils/man/download.file.Rd @@ -181,7 +181,7 @@ download.file(url, destfile, method, quiet = FALSE, mode = "w", \command{wget} (\url{https://www.gnu.org/software/wget/}) is commonly installed on Unix-alikes (but not macOS). Windows binaries are - available from MSYS2 and elsewhere. + available from \abbr{MSYS2} and elsewhere. \command{curl} (\url{https://curl.se/}) is installed on macOS and increasingly commonly on Unix-alikes. Windows binaries are available @@ -226,7 +226,7 @@ download.file(url, destfile, method, quiet = FALSE, mode = "w", On Windows with \code{method = "libcurl"}, when \R was linked with \code{libcurl} with \code{Schannel} enabled, the connection fails if it cannot be established that the certificate has not been revoked. Some - MITM proxies present particularly in corporate environments do not work + \abbr{MITM} proxies present particularly in corporate environments do not work with this behavior. It can be changed by setting environment variable \env{R_LIBCURL_SSL_REVOKE_BEST_EFFORT} to \code{TRUE}, with the consequence of reducing security. diff --git a/src/library/utils/man/object.size.Rd b/src/library/utils/man/object.size.Rd index 10f4b271f06..cedd0346d09 100644 --- a/src/library/utils/man/object.size.Rd +++ b/src/library/utils/man/object.size.Rd @@ -87,16 +87,16 @@ object.size(x) Summary of \R's legacy and \acronym{IEC} units: \tabular{lll}{ - \bold{object size} \tab\bold{legacy} \tab\bold{IEC}\cr + \bold{object size} \tab\bold{legacy} \tab\bold{\acronym{IEC}}\cr 1 \tab 1 bytes \tab 1 B \cr - 1024 \tab 1 Kb \tab 1 KiB \cr - 1024^2 \tab 1 Mb \tab 1 MiB \cr - 1024^3 \tab 1 Gb \tab 1 GiB \cr - 1024^4 \tab 1 Tb \tab 1 TiB \cr - 1024^5 \tab 1 Pb \tab 1 PiB \cr + 1024 \tab 1 \abbr{Kb} \tab 1 \abbr{KiB} \cr + 1024^2 \tab 1 \abbr{Mb} \tab 1 \abbr{MiB} \cr + 1024^3 \tab 1 \abbr{Gb} \tab 1 \abbr{GiB} \cr + 1024^4 \tab 1 \abbr{Tb} \tab 1 \abbr{TiB} \cr + 1024^5 \tab 1 \abbr{Pb} \tab 1 \abbr{PiB} \cr 1024^6 \tab \tab 1 \abbr{EiB} \cr - 1024^7 \tab \tab 1 ZiB \cr - 1024^8 \tab \tab 1 YiB \cr + 1024^7 \tab \tab 1 \abbr{ZiB} \cr + 1024^8 \tab \tab 1 \abbr{YiB} \cr } Summary of \acronym{SI} units: @@ -108,7 +108,7 @@ object.size(x) 1000^3 \tab 1 GB \cr 1000^4 \tab 1 TB \cr 1000^5 \tab 1 PB \cr - 1000^6 \tab 1 EB \cr + 1000^6 \tab 1 \abbr{EB} \cr 1000^7 \tab 1 ZB \cr 1000^8 \tab 1 YB \cr 1000^9 \tab 1 RB \cr diff --git a/src/library/utils/man/read.DIF.Rd b/src/library/utils/man/read.DIF.Rd index f77887dd9a7..16ae72a8726 100644 --- a/src/library/utils/man/read.DIF.Rd +++ b/src/library/utils/man/read.DIF.Rd @@ -7,8 +7,9 @@ \alias{read.DIF} \title{Data Input from Spreadsheet} \description{ - Reads a file in Data Interchange Format (DIF) and creates a data frame - from it. DIF is a format for data matrices such as single spreadsheets. + Reads a file in Data Interchange Format (\abbr{DIF}) and creates a + data frame from it. \abbr{DIF} is a format for data matrices such as + single spreadsheets. } \usage{ read.DIF(file, header = FALSE, @@ -24,7 +25,7 @@ read.DIF(file, header = FALSE, or a \link{connection}, or a complete URL. The name \code{"clipboard"} may also be used on Windows, in which - case \code{read.DIF("clipboard")} will look for a DIF format entry + case \code{read.DIF("clipboard")} will look for a \abbr{DIF} format entry in the Windows clipboard. } @@ -115,7 +116,7 @@ read.DIF(file, header = FALSE, \item{transpose}{logical, indicating if the row and column interpretation should be transposed. Microsoft's Excel has been - known to produce (non-standard conforming) DIF files which would + known to produce (non-standard conforming) \abbr{DIF} files which would need \code{transpose = TRUE} to be read correctly.} \item{fileEncoding}{character string: if non-empty declares the diff --git a/src/library/utils/man/savehistory.Rd b/src/library/utils/man/savehistory.Rd index 92ec32beb0b..7a63e3fe66f 100644 --- a/src/library/utils/man/savehistory.Rd +++ b/src/library/utils/man/savehistory.Rd @@ -48,7 +48,7 @@ timestamp(stamp = date(), \item{Windows:}{ The functions described here work in \command{Rgui} and interactive \command{Rterm} but not in batch use of \command{Rterm} nor in - embedded/DCOM versions. + embedded/\abbr{DCOM} versions. } \item{Unix-alikes:}{ The functions described here work under the diff --git a/src/library/utils/man/untar.Rd b/src/library/utils/man/untar.Rd index 21f0336a474..67c4833b98b 100644 --- a/src/library/utils/man/untar.Rd +++ b/src/library/utils/man/untar.Rd @@ -179,7 +179,7 @@ untar(tarfile, files = NULL, list = FALSE, exdir = ".", handles it, and look carefully at the resulting files. There may also be the warning \preformatted{ using pax extended headers} This indicates that additional information may have been discarded, - such as ACLs, encodings \dots. + such as \abbr{ACL}s, encodings \dots. The former standards only supported ASCII filenames (indeed, only alphanumeric plus period, underscore and hyphen). \code{untar} makes