cosmetic changes, comments

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

Author: maechler

etc/Makeconf.in

@@ -1,4 +1,4 @@
-# @configure_input@
+# @configure_input@ -*- Makefile -*-
 #
 # ${R_HOME}/etc/Makeconf
 #

src/library/base/R/connections.R

@@ -155,7 +155,7 @@ textConnection <- function(object, open = "r", local = FALSE,
     env <- if (local) parent.frame() else .GlobalEnv
     type <- match(match.arg(encoding), c("", "bytes", "UTF-8"))
     if(!(is.character(name) && length(name) == 1))
-        stop("'name' must be a single character string")
+        stop(gettextf("'%s' must be a character string", "name"), domain = NA)
     .Internal(textConnection(name, object, open, env, type))
 }
 

src/library/base/man/as.POSIXlt.Rd

@@ -1,6 +1,6 @@
 % File src/library/base/man/as.POSIXlt.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2022 R Core Team
+% Copyright 1995-2024 R Core Team
 % Distributed under GPL 2 or later
 
 \name{as.POSIX*}
@@ -208,7 +208,7 @@ as.POSIXlt(Sys.time(), "Australia/Darwin")
 }
 
 tab <- file.path(R.home("share"), "zoneinfo", "zone1970.tab")
-if(file.exists(tab)) { # typically on Windows; *not* on Linux
+if(file.exists(tab)) { # typically on Windows; on Linux when  `configure --with-internal-tzcode`
   cols <- c("code", "coordinates", "TZ", "comments")
   tmp <- read.delim(tab,
                     header = FALSE, comment.char = "#", col.names = cols)

src/library/base/man/format.Rd

@@ -5,15 +5,16 @@
 % Distributed under GPL 2 or later
 
 \name{format}
+\title{Encode in a Common Format}
 \alias{format}
 \alias{format.AsIs}
 \alias{format.data.frame}
 \alias{format.default}
 \alias{format.factor}
 \description{
-  Format an \R object for pretty printing.
+  Format an \R object for pretty printing, notably encoding vector or
+  column elements into a common format.
 }
-\title{Encode in a Common Format}
 \usage{
 format(x, \dots)
 

src/library/base/man/list.Rd

@@ -1,6 +1,6 @@
 % File src/library/base/man/list.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2022 R Core Team
+% Copyright 1995-2024 R Core Team
 % Distributed under GPL 2 or later
 
 \name{list}
@@ -73,7 +73,7 @@ alist(\dots)
   \code{is.list} returns \code{TRUE} if and only if its argument
   is a \code{list} \emph{or} a \code{pairlist} of \code{length} \eqn{> 0}.
   \code{is.pairlist} returns \code{TRUE} if and only if the argument
-  is a pairlist or \code{NULL} (see below).
+  is a pairlist (or \code{NULL} which \emph{is} a pairlist, see below).
 
   The \code{"\link{environment}"} method for \code{as.list} copies the
   name-value pairs (for names not beginning with a dot) from an

src/library/base/man/qr.Rd

@@ -99,12 +99,12 @@ as.qr(x)
 \value{
   The QR decomposition of the matrix as computed by LINPACK(*) or LAPACK.
   The components in the returned value correspond directly
-  to the values returned by \I{DQRDC}(2)/\I{DGEQP3}/\I{ZGEQP3}.
+  to the values returned by \I{DQRDC(2)}/\I{DGEQP3}/\I{ZGEQP3}.
   \item{qr}{a matrix with the same dimensions as \code{x}.
     The upper triangle contains the \eqn{\bold{R}} of the decomposition
     and the lower triangle contains information on the \eqn{\bold{Q}} of
     the decomposition (stored in compact form).  Note that the storage
-    used by \I{DQRDC} and \I{DGEQP3} differs.}
+    used by \I{DQRDC} (LINPACK) and \I{DGEQP3} (LAPACK) differs.}
   \item{qraux}{a vector of length \code{ncol(x)} which contains
     additional information on \eqn{\bold{Q}}.}
   \item{rank}{the rank of \code{x} as computed by the decomposition(*):

src/library/base/man/source.Rd

@@ -16,7 +16,7 @@
 
   \code{withAutoprint(exprs)} is a wrapper for \code{source(exprs =
   exprs, ..)} with different defaults.  Its main purpose is to evaluate
-  and auto-print expressions as if in a toplevel context, e.g, as in the
+  and auto-print expressions as if in a top-level context, e.g, as in the
   \R console.
 }
 \usage{

src/library/base/man/srcfile.Rd

@@ -1,6 +1,6 @@
 % File src/library/base/man/srcfile.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2016 R Core Team
+% Copyright 1995-2024 R Core Team
 % Distributed under GPL 2 or later
 
 \name{srcfile}
@@ -155,8 +155,8 @@ srcref(srcfile, lloc)
 }
 \seealso{
   \code{\link{getSrcFilename}} for extracting information from a source
-  reference, or \code{\link{removeSource}} to remove it from a
-  (non-primitive) function (aka \sQuote{closure}).
+  reference, or \code{\link{removeSource}} to remove it from a language
+  object or a (non-primitive) function (aka \sQuote{closure}).
 }
 \author{Duncan Murdoch}
 \examples{

src/library/base/man/strsplit.Rd

@@ -1,6 +1,6 @@
 % File src/library/base/man/strsplit.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2023 R Core Team
+% Copyright 1995-2024 R Core Team
 % Distributed under GPL 2 or later
 
 \name{strsplit}
@@ -107,11 +107,12 @@ strsplit(x, split, fixed = FALSE, perl = FALSE, useBytes = FALSE)
 \seealso{
   \code{\link{paste}} for the reverse,
   \code{\link{grep}} and \code{\link{sub}} for string search and
-  manipulation; also \code{\link{nchar}}, \code{\link{substr}}.
+  manipulation; also \code{\link{nchar}}, \code{\link{substr}},
+  \code{\link{startsWith}()}, and \code{endsWith()}.
 
   \sQuote{\link{regular expression}} for the details of the pattern
   specification.
-  
+
   Option \code{PCRE_use_JIT} controls the details when \code{perl = TRUE}.
 }
 \examples{

src/library/base/man/substr.Rd

@@ -89,6 +89,7 @@ substring(text, first, last = 1000000L) <- value
   Wadsworth & Brooks/Cole.  (\code{substring}.)
 }
 \seealso{
+ \code{\link{startsWith}} and \code{endsWith()};
  \code{\link{strsplit}}, \code{\link{paste}}, \code{\link{nchar}}.
 }
 \examples{