spelling/markup

git-svn-id: https://svn.r-project.org/R/trunk@87957 00db46b3-68df-0310-9c12-caf00c1e9a41

Author: smeyer

doc/NEWS.2.Rd

@@ -971,7 +971,7 @@
 
       \item \code{plot(<lm>, which=5)} now correctly labels the factor
       level combinations for the special case where all
-      \eqn{h_ii}{h[i,i]} are the same. (\PR{14837})
+      \eqn{h_{ii}}{h[i,i]} are the same. (\PR{14837})
 
       \item \code{Sys.glob()} caused a segfault if the first element of
       \code{path} was \code{NA_character}. (\PR{14990})
@@ -4464,8 +4464,8 @@
       \item \code{tools::texi2dvi()} gains an \code{index} argument,
        mainly for use by \command{R CMD Rd2pdf}.
 
-       It avoids the use of \command{texindy} by \command{texinfo}'s
-       \command{texi2dvi >= 1.157}, since that does not emulate
+       It avoids the use of \command{texindy} by Texinfo's
+       \command{texi2dvi} >= 1.157, since that does not emulate
        'makeindex' well enough to avoid problems with special characters
        (such as \samp{(}, \samp{\{}, \samp{!}) in indices. % )
 
@@ -5479,7 +5479,7 @@
 
       \item The \code{readline} completion backend no longer sorts
        possible completions alphabetically (e.g., function argument
-       names) if \R was built with \code{readline >= 6}.
+       names) if \R was built with \code{readline} >= 6.
 
       \item \code{select.list()} gains a \code{graphics} argument to
        allow Windows/Mac users to choose the text interface.  This

doc/NEWS.3.Rd

@@ -827,7 +827,7 @@
 
       It now checks for duplicated vignette titles (also known as
       \sQuote{index entries}): they are used as hyperlinks on
-      \abbr{CRAN} package pages and so do need to be unique.
+      CRAN package pages and so do need to be unique.
 
       \item \command{R CMD check} has more comprehensive checks on the
       \file{data} directory and the functioning of \code{data()} in a
@@ -1784,7 +1784,7 @@
       possibility to set a \sQuote{timeout} (elapsed-time limit).  For
       serial installs this uses the \code{timeout} argument of
       \code{system2()}: for parallel installs it requires the
-      \command{timeout} utility command from GNU \pkg{coreutils}.
+      \command{timeout} utility command from GNU coreutils.
 
       \item It is now possible to set \sQuote{timeouts} (elapsed-time
       limits) for most parts of \command{R CMD check} \emph{via}
@@ -2008,7 +2008,7 @@
       \item Subassignment with zero length vectors now coerces as
       documented (\PR{17344}).\cr
       Further, \code{x <- numeric(); x[1] <- character()} now signals
-      an error \sQuote{\verb{replacement has length zero}} (or a
+      an error \samp{replacement has length zero} (or a
       translation of that) instead of doing nothing.
 
       \item (Package \pkg{parallel}.)  \code{mclapply()}, \code{pvec()}
@@ -2200,7 +2200,7 @@
 
       \item The default for \code{tools::write_PACKAGES(rds_compress=)}
       has been changed to \code{"xz"} to match the compression used by
-      \abbr{CRAN}.
+      CRAN.
 
       \item \code{c()} and \code{unlist()} are now more efficient in
       constructing the \code{names(.)} of their return value, thanks to
@@ -2685,7 +2685,7 @@
 
       \item Package \pkg{tools} now exports function
       \code{CRAN_package_db()} for obtaining information about current
-      packages in the \abbr{CRAN} package repository, and several
+      packages in the CRAN package repository, and several
       functions for obtaining the check status of these packages.
 
       \item The (default) Stangle driver \code{Rtangle} allows
@@ -2735,15 +2735,15 @@
       is unset.
 
       NB: This can break reproducibility of output, and did for a
-      \abbr{CRAN} package.
+      CRAN package.
 
       \item Methods \code{"wget"} and \code{"curl"} for
       \code{download.file()} now give an \R error rather than a non-zero
       return value when the external command has a non-zero status.
 
       \item Encoding name \code{"utf8"} is mapped to \code{"UTF-8"}.
       Many implementations of \code{iconv} accept \code{"utf8"}, but not
-      GNU \pkg{libiconv} (including the late 2016 version 1.15).
+      GNU \samp{libiconv} (including the late 2016 version 1.15).
 
       \item \code{sessionInfo()} shows the full paths to the library or
       executable files providing the BLAS/LAPACK implementations
@@ -2872,7 +2872,7 @@
       adding native-symbol registration to a package.  See its help and
       §5.4.1 of \sQuote{Writing R Extensions} for how to use it.  (At
       the time it was added it successfully automated adding
-      registration to over 90\% of \abbr{CRAN} packages which lacked
+      registration to over 90\% of CRAN packages which lacked
       it.  Many of the failures were newly-detected bugs in the
       packages, e.g.\sspace50 packages called entry points with varying
       numbers of arguments and 65 packages called entry points not in
@@ -3353,7 +3353,7 @@
 
       \item \code{findMethod()} failed if the active signature had
       expanded beyond what a particular package used. (Example with
-      packages \CRANpkg{XR} and \CRANpkg{XRJulia} on \abbr{CRAN}.)
+      packages \CRANpkg{XR} and \CRANpkg{XRJulia} on CRAN.)
 
       \item \code{qbeta()} underflowed too early in some very asymmetric
       cases.  (\PR{17178})
@@ -4208,7 +4208,7 @@
       \item \code{smooth(x, *)} now also works for long vectors.
 
       \item \code{tools::texi2dvi()} has a workaround for problems with
-      the \command{texi2dvi} script supplied by \pkg{texinfo 6.1}.
+      the \command{texi2dvi} script supplied by Texinfo 6.1.
 
       It extracts more error messages from the LaTeX logs when in
       emulation mode.
@@ -4574,7 +4574,7 @@
       \item \code{cmdscale()} gets new option \code{list.} for increased
       flexibility when a list should be returned.
 
-      \item \command{configure} now supports \code{texinfo} version 6.0,
+      \item \command{configure} now supports Texinfo version 6.0,
       which (unlike the change from 4.x to 5.0) is a minor update.
       (Wish of \PR{16456}.)
 
@@ -5205,15 +5205,15 @@
        versions included in the \R sources if no system versions are
        found or (unlikely) if they are too old.
 
-       Linux users should check that the \code{-devel} or \code{-dev}
-       versions of packages \pkg{zlib}, \pkg{bzip2}/\pkg{libbz2} and
-       \pkg{pcre} as well as \pkg{xz-devel}/\pkg{liblzma-dev} (or
+       Linux users should check that the \samp{-devel} or \samp{-dev}
+       versions of packages \samp{zlib}, \samp{bzip2}/\samp{libbz2} and
+       \samp{pcre} as well as \samp{xz-devel}/\samp{liblzma-dev} (or
        similar names) are installed.
 
        \item \command{configure} by default looks for the
-       \command{texi2any} script from \pkg{texinfo} 5.1 or later, rather
+       \command{texi2any} script from Texinfo 5.1 or later, rather
        than the \command{makeinfo} program.  (\command{makeinfo} is a
-       link to the Perl script \command{texi2any} in \pkg{texinfo} 5.x.)
+       link to the Perl script \command{texi2any} in Texinfo 5.x.)
 
        \item \command{R CMD INSTALL} gains an  option
        \option{--built-timestamp=STAMP} allowing 100\% reproducible
@@ -5311,18 +5311,18 @@
     The following are currently in place.
     \itemize{
       \item Installation using external binary distributions
-      of \pkg{zlib}, \pkg{bzip2}, \pkg{liblzma}, \pkg{pcre},
-      \pkg{libpng}, \pkg{jpeglib} and \pkg{libtiff} is now required,
+      of \samp{zlib}, \samp{bzip2}, \samp{liblzma}, \samp{pcre},
+      \samp{libpng}, \samp{jpeglib} and \samp{libtiff} is now required,
       and the build instructions have been revised.
 
       \item A new \command{make} target \code{rsync-extsoft} has been
       added to obtain copies of the external libraries from
-      \abbr{CRAN}.
+      CRAN.
 
       \item Building the manuals now requires \command{texi2any} from
-      \pkg{texinfo} 5.1 or later.  \abbr{CRAN} binary builds include
+      Texinfo 5.1 or later.  CRAN binary builds include
       the manuals, but by default builds from source will not, and they
-      will be accessed from \abbr{CRAN}.  See the comments in
+      will be accessed from CRAN.  See the comments in
       \file{src/gnuwin32/MkRules.dist} for how to specify the location
       of \command{texi2any}.
 
@@ -5499,7 +5499,7 @@
       \item The included version of PCRE has been updated to 8.36.
 
       \item \command{configure} accepts \samp{MAKEINFO=texi2any} as
-      another way to ensure \pkg{texinfo} 5.x is used when both 5.x and
+      another way to ensure Texinfo 5.x is used when both 5.x and
       4.x are installed.
     }
   }
@@ -5718,8 +5718,8 @@
       \env{LDFLAGS} (and not in \sQuote{your system's library directory}
       as documented). (Wish of \PR{15790}.)
 
-      \item LaTeX package \pkg{upquote} is no longer required for \R's
-      use of \pkg{inconsolata}.
+      \item LaTeX package \samp{upquote} is no longer required for \R's
+      use of \samp{inconsolata}.
 
       \item (Windows only) If both 32- and 64-bit versions of \R are
       installed, the \file{bin/R.exe} and \file{bin/Rscript.exe} executables
@@ -6457,7 +6457,7 @@
       the default in the future.
 
       \item There is a new option \option{--use-system-tre} to use a
-      suitable system \pkg{tre} library: at present this means a version
+      suitable system TRE library: at present this means a version
       from their \command{git} repository, after corrections.
       (Wish of \PR{15660}.)
     }
@@ -6760,10 +6760,10 @@
   \subsection{NEW FEATURES}{
     \itemize{
       \item On Windows there is support for making \file{.texi} manuals
-      using \command{texinfo} 5.0 or later: the setting is in file
+      using Texinfo 5.0 or later: the setting is in file
       \file{src/gnuwin32/MkRules.dist}.
 
-      A packaging of the Perl script and modules for \command{texinfo}
+      A packaging of the Perl script and modules for Texinfo
       5.2 has been made available at
       \url{http://www.stats.ox.ac.uk/pub/Rtools/}.
 
@@ -6812,7 +6812,7 @@
       UTF-8 French month names to be read on (French) Windows.
 
       \item \code{iconv(to = "utf8")} is now accepted on all platforms
-      (some implementations did already, but GNU \pkg{libiconv} did not:
+      (some implementations did already, but GNU \samp{libiconv} did not:
       however converted strings were not marked as being in UTF-8).  The
       official name, \code{"UTF-8"} is still preferred.
 
@@ -7252,9 +7252,8 @@
 
   \subsection{INSTALLATION and INCLUDED SOFTWARE}{
     \itemize{
-      \item The macros used for the texinfo manuals have been changed to
-      work better with the incompatible changes made in \command{texinfo
-      5.x}.
+      \item The macros used for the Texinfo manuals have been changed to
+      work better with the incompatible changes made in Texinfo 5.x.
 
       \item The minimum version for a system \code{xz} library is now
       5.0.3 (was 4.999).  This is in part to avoid 5.0.2, which can
@@ -8071,7 +8070,7 @@
       \item \code{untar()} has a new argument \code{restore_times} which
       if false (not the default) discards the times in the tarball.
       This is useful if they are incorrect (some tarballs submitted to
-      \abbr{CRAN} have times in a local time zone or many years in the
+      CRAN have times in a local time zone or many years in the
       past even though the standard required them to be in UTC).
 
       \item \code{replayplot()} cannot (and will not attempt to) replay
@@ -8313,7 +8312,7 @@
       \samp{universal} or \samp{leopard}): it looks in
       \file{bin/macosx/contrib/3.0} rather than
       \file{bin/macosx/leopard/contrib/2.15}).  This is the type used
-      for the \abbr{CRAN} binary distribution for OS X as from \R
+      for the CRAN binary distribution for OS X as from \R
       3.0.0.
 
       \item File \file{etc/Makeconf} makes more use of the macros

doc/NEWS.Rd

@@ -314,8 +314,8 @@
       \item \code{getMethods(*, table = TRUE)} is deprecated.
 
       \item Building with the bundled (and old) version of
-      \code{libintl} is deprecated and now gives a \command{configure
-      warning}.  This should be selected only if neither the OS's
+      \code{libintl} is deprecated and now gives a \command{configure}
+      warning.  This should be selected only if neither the OS's
       \code{libc} (as on GNU Linux) nor an external \code{libintl}
       library (as on Alpine Linux) provide suitable functions.
 
@@ -430,7 +430,7 @@
 
   \subsection{C-LEVEL API}{
     \itemize{
-      \item The \sQuote{Writing R Extensions} \I{TexInfo} source now
+      \item The \sQuote{Writing R Extensions} \I{Texinfo} source now
       contains very experimental annotations for more clearly
       identifying the API status of C entry points. These annotations
       are used to produce indices for API, experimental API, and

doc/manual/R-admin.texi

@@ -3313,7 +3313,7 @@ with new translations, but otherwise the version of the @code{gettext}
 runtime contained in the R sources will be used if no suitable external
 @code{gettext} is found (possibly from @code{libc}) and @R{} was not
 configured with @option{--disable-nls}.  Use of the bundled
-@code{gettext} runtime is deprecated and will be reoved soon.
+@code{gettext} runtime is deprecated and will be removed soon.
 
 @cindex Cairo
 @cindex @I{Pango}

doc/manual/R-exts.texi

@@ -1481,7 +1481,7 @@ the seed to obtain reproducible results (and it can be helpful to do so
 in all cases, to avoid occasional failures when tests are run).
 
 If directory @file{tests} has a subdirectory @file{Examples} containing
-a file @code{@var{pkg}-Ex.Rout.save}, this is compared to the output
+a file @file{@var{pkg}-Ex.Rout.save}, this is compared to the output
 file for running the examples when the latter are checked.  Reference
 output should be produced without having the @option{--timings} option
 set (and note that @option{--as-cran} sets it).

src/library/base/man/Bessel.Rd

@@ -62,11 +62,11 @@ besselY(x, nu)
   \dQuote{Acknowledgement} and \dQuote{References}, a short summary of
   which is
   \describe{
-    \item{besselI}{based on (code) by David J. Sookne, see Sookne (1973)\dots
+    \item{\code{besselI}}{based on (code by) David J. Sookne, see Sookne (1973)\dots
       Modifications\dots An earlier version was published in Cody (1983).}
-    \item{besselJ}{as \code{besselI}}
-    \item{besselK}{based on (code) by J. B. Campbell (1980)\dots Modifications\dots}
-    \item{besselY}{draws heavily on Temme's Algol program for
+    \item{\code{besselJ}}{as \code{besselI}}
+    \item{\code{besselK}}{based on (code by) J. B. Campbell (1980)\dots Modifications\dots}
+    \item{\code{besselY}}{draws heavily on Temme's Algol program for
       \eqn{Y}\dots and on Campbell's programs for \eqn{Y_\nu(x)}
       \dots. \dots heavily modified.}
   }

src/library/base/man/gettext.Rd

@@ -93,7 +93,7 @@ Sys.setLanguage(lang, unset = "en", C.vs.en = c("msg", "warn", "silent"),
 
   \code{ngettext} is used where the message needs to vary by a single
   integer.  Translating such messages is subject to very specific rules
-  for different languages: see the GNU \I{Gettext} Manual.  The string
+  for different languages: see the GNU \verb{gettext} manual.  The string
   will often contain a single instance of \code{\%d} to be used in
   \code{\link{sprintf}}.  If English is used, \code{msg1} is returned if
   \code{n == 1} and \code{msg2} in all other cases.

src/library/base/man/library.Rd

@@ -99,8 +99,8 @@ conflictRules(pkg, mask.ok = NULL, exclude = NULL)
   obtain just the names of all available packages, and
   \code{\link{installed.packages}()} for even more information.
 
-  \code{library(help = somename)} computes basic information about the
-  package \pkg{somename}, and returns this in an object of class
+  \code{library(help = \var{pkgname})} computes basic information about the
+  package \pkg{\var{pkgname}}, and returns this in an object of class
   \code{"packageInfo"}.  (The structure of this class may change in
   future versions.)  When used with the default value (\code{NULL}) for
   \code{lib.loc}, the attached packages are searched before the libraries.

src/library/grDevices/man/grDevices-defunct.Rd

@@ -11,7 +11,7 @@
 
 \description{
   The functions or variables listed here are no longer part of \R as
-  they are no loinger supported.
+  they are no longer supported.
 }
 \usage{
 # Defunct in R 4.5.0

src/library/tools/man/texi2dvi.Rd

@@ -62,7 +62,7 @@ texi2pdf(file, clean = FALSE, quiet = TRUE,
 
   %% issues included not re-running latex in texinfo 6.1 and bashisms in
   %% the /bin/sh script in <= 6.0.
-  A shell script \command{texi2dvi} is part of GNU's \pkg{texinfo}.
+  A shell script \command{texi2dvi} is part of GNU \I{Texinfo}.
   Several issues have been seen with released versions, so if yours does
   not work correctly try \env{R_TEXI2DVICMD=emulation}.
 #endif