From 6b38af7c72e5c23fde024c18c4edafb88b9c9228 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sat, 30 Aug 2025 13:33:19 +0200 Subject: [PATCH 1/8] Add link from ... to chkDots. --- src/library/base/man/dots.Rd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/library/base/man/dots.Rd b/src/library/base/man/dots.Rd index 68427d2cf6d..211989b67f6 100644 --- a/src/library/base/man/dots.Rd +++ b/src/library/base/man/dots.Rd @@ -54,7 +54,7 @@ For more, see the \ifelse{html}{\href{/doc/manual/R-intro.html#The-three-dots-argument}{Introduction to R}}{\sQuote{Introduction to R}} manual for usage of these syntactic elements, - and \link[methods]{dotsMethods} for their use in formal (S4) methods. + and \link[methods]{dotsMethods} for their use in formal (S4) methods and \code{\link{chkDots}} for S3 methods. } \examples{ tst <- function(n, ...) ...elt(n) From 4cb108699a4939899403168564d25ae20021d202 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 11:47:49 +0200 Subject: [PATCH 2/8] Link between regex and zutils page (+example on zutils page) --- src/library/base/man/regex.Rd | 2 ++ src/library/base/man/zutils.Rd | 3 +++ 2 files changed, 5 insertions(+) diff --git a/src/library/base/man/regex.Rd b/src/library/base/man/regex.Rd index aa4eaa40dc6..32f9bfd49fc 100644 --- a/src/library/base/man/regex.Rd +++ b/src/library/base/man/regex.Rd @@ -359,6 +359,8 @@ \code{\link{glob2rx}}, \code{\link{help.search}}, \code{\link{list.files}}, \code{\link{ls}}, \code{\link{strsplit}} and \code{\link{agrep}}. + Examples of regular expressions used by R \code{\link{.standard_regexps}}. + The \href{https://html-preview.github.io/?url=https://raw.githubusercontent.com/laurikari/tre/master/doc/tre-syntax.html}{\I{TRE} regexp syntax}. The POSIX 1003.2 standard at diff --git a/src/library/base/man/zutils.Rd b/src/library/base/man/zutils.Rd index a51ca3c6c92..c7e919a5786 100644 --- a/src/library/base/man/zutils.Rd +++ b/src/library/base/man/zutils.Rd @@ -16,4 +16,7 @@ \code{valid_package_version} with the obvious meanings. The regexps are not anchored. } +\examples{ +.standard_regexps() +} \keyword{utilities} From e5fd160e7ddb6d7936e0ac955a0b295e92889b17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 11:52:04 +0200 Subject: [PATCH 3/8] Add link from connections.Rd to socketSelect.Rd --- src/library/base/man/connections.Rd | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/library/base/man/connections.Rd b/src/library/base/man/connections.Rd index ad5115a167d..595d0f803b4 100644 --- a/src/library/base/man/connections.Rd +++ b/src/library/base/man/connections.Rd @@ -688,6 +688,8 @@ socketTimeout(socket, timeout = -1) To flush output to the Windows and macOS consoles, see \code{\link{flush.console}}. + + \code{\link{socketSelect}} for picking an available socket connection. } \examples{ From a307b54d843e416588f076201a70ca8b223a9ceb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 12:03:29 +0200 Subject: [PATCH 4/8] Add links between mat.or.vec (and output) and matrix --- src/library/base/man/mat.or.vec.Rd | 3 ++- src/library/base/man/matrix.Rd | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/src/library/base/man/mat.or.vec.Rd b/src/library/base/man/mat.or.vec.Rd index ad91702a7c4..82f3e21eae3 100644 --- a/src/library/base/man/mat.or.vec.Rd +++ b/src/library/base/man/mat.or.vec.Rd @@ -13,10 +13,11 @@ mat.or.vec(nr, nc) \item{nr, nc}{numbers of rows and columns.} } \description{ - \code{mat.or.vec} creates an \code{nr} by \code{nc} zero matrix if + \code{mat.or.vec} creates an \code{nr} by \code{nc} zero \link{matrix} if \code{nc} is greater than 1, and a zero vector of length \code{nr} if \code{nc} equals 1. } +\value{A vector or a matrix filled with 0.} \examples{ mat.or.vec(3, 1) mat.or.vec(3, 2) diff --git a/src/library/base/man/matrix.Rd b/src/library/base/man/matrix.Rd index 26498b18421..52f92841052 100644 --- a/src/library/base/man/matrix.Rd +++ b/src/library/base/man/matrix.Rd @@ -103,6 +103,8 @@ is.matrix(x) A matrix is the special case of a two-dimensional \code{\link{array}}. \code{\link{inherits}(m, "array")} is true for a \code{matrix} \code{m}. + + \code{\link{mat.or.vec}} for creating numeric vectors or matrices. } \examples{ is.matrix(as.matrix(1:10)) From 304928e07e61f4e82cd90d912199a3888b1ce645 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 12:11:54 +0200 Subject: [PATCH 5/8] Add link between det and matrix --- src/library/base/man/det.Rd | 2 +- src/library/base/man/matrix.Rd | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/src/library/base/man/det.Rd b/src/library/base/man/det.Rd index b098ca4770e..6f752363cb6 100644 --- a/src/library/base/man/det.Rd +++ b/src/library/base/man/det.Rd @@ -13,7 +13,7 @@ det(x, \dots) determinant(x, logarithm = TRUE, \dots) } \description{ - \code{det} calculates the determinant of a matrix. \code{determinant} + \code{det} calculates the determinant of a \link{matrix}. \code{determinant} is a generic function that returns separately the modulus of the determinant, optionally on the logarithm scale, and the sign of the determinant. } diff --git a/src/library/base/man/matrix.Rd b/src/library/base/man/matrix.Rd index 52f92841052..10867fc83c5 100644 --- a/src/library/base/man/matrix.Rd +++ b/src/library/base/man/matrix.Rd @@ -101,10 +101,12 @@ is.matrix(x) \code{\link{data.matrix}}, which attempts to convert to a numeric matrix. + A matrix is the special case of a two-dimensional \code{\link{array}}. \code{\link{inherits}(m, "array")} is true for a \code{matrix} \code{m}. \code{\link{mat.or.vec}} for creating numeric vectors or matrices. + \code{\link{\%*\%}}, \code{\link{det}} for operations with numeric matrices. } \examples{ is.matrix(as.matrix(1:10)) From 1ee2db062d69efeb1757439520c83755fe283c43 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 12:26:41 +0200 Subject: [PATCH 6/8] Links between c and append --- src/library/base/man/append.Rd | 3 +++ src/library/base/man/c.Rd | 2 ++ 2 files changed, 5 insertions(+) diff --git a/src/library/base/man/append.Rd b/src/library/base/man/append.Rd index d098d0c84c3..cf267866310 100644 --- a/src/library/base/man/append.Rd +++ b/src/library/base/man/append.Rd @@ -24,6 +24,9 @@ append(x, values, after = length(x)) \references{ \bibshow{R:Becker+Chambers+Wilks:1988} } +\seealso{ + \code{\link{c}} for combining vectors. +} \examples{ append(1:5, 0:1, after = 3) } diff --git a/src/library/base/man/c.Rd b/src/library/base/man/c.Rd index 50f190bc55c..d72236be2b0 100644 --- a/src/library/base/man/c.Rd +++ b/src/library/base/man/c.Rd @@ -66,6 +66,8 @@ c(\dots) \seealso{ \code{\link{unlist}} and \code{\link{as.vector}} to produce attribute-free vectors. + + \code{\link{append}} to add values to a vector. } \examples{ c(1, 7:9) From 2af81fee0c6c5ef105ad1b75a87e3e7801640989 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 12:27:12 +0200 Subject: [PATCH 7/8] Add links on asplit and link to it from split --- src/library/base/man/asplit.Rd | 2 +- src/library/base/man/split.Rd | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/src/library/base/man/asplit.Rd b/src/library/base/man/asplit.Rd index 4f15aa961c5..b64abcf7185 100644 --- a/src/library/base/man/asplit.Rd +++ b/src/library/base/man/asplit.Rd @@ -6,7 +6,7 @@ asplit(x, MARGIN, drop = FALSE) } \arguments{ - \item{x}{an array, including a matrix.} + \item{x}{an \link{array}, including a \link{matrix}.} \item{MARGIN}{a vector giving the margins to split by. E.g., for a matrix \code{1} indicates rows, \code{2} indicates columns, \code{c(1, 2)} indicates rows and columns. diff --git a/src/library/base/man/split.Rd b/src/library/base/man/split.Rd index c4336f39e29..2e35d3d1c3a 100644 --- a/src/library/base/man/split.Rd +++ b/src/library/base/man/split.Rd @@ -22,7 +22,7 @@ split(x, f, drop = FALSE, \dots) \method{split}{default}(x, f, drop = FALSE, sep = ".", lex.order = FALSE, \dots) -split(x, f, drop = FALSE, \dots) <- value +split(x, f, drop = FALSE, \dots) <- values unsplit(value, f, drop = FALSE) } \arguments{ @@ -84,6 +84,9 @@ unsplit(value, f, drop = FALSE) \code{\link{cut}} to categorize numeric values. \code{\link{strsplit}} to split strings. + + \code{\link{asplit}} to split matrices and arrays. + } \references{ \bibshow{R:Becker+Chambers+Wilks:1988} From dd7a855c43eedaa5206ff5f01baf8b4dd51172e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Sun, 31 Aug 2025 12:41:25 +0200 Subject: [PATCH 8/8] Add example on replace and links to and from it on Extract.Rd --- src/library/base/man/Extract.Rd | 1 + src/library/base/man/replace.Rd | 14 +++++++++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/src/library/base/man/Extract.Rd b/src/library/base/man/Extract.Rd index ec1951e2a6b..6f5cbe551fb 100644 --- a/src/library/base/man/Extract.Rd +++ b/src/library/base/man/Extract.Rd @@ -328,6 +328,7 @@ x$name <- value \code{\link{Syntax}} for operator precedence, and the \sQuote{R Language Definition} manual about indexing details. + \code{\link{replace}} for replacing without modyfying the original object. \code{\link{NULL}} for details of indexing null objects. } diff --git a/src/library/base/man/replace.Rd b/src/library/base/man/replace.Rd index ff1185634d2..b50b7ad3e1b 100644 --- a/src/library/base/man/replace.Rd +++ b/src/library/base/man/replace.Rd @@ -16,7 +16,7 @@ If necessary, the values in \code{values} are recycled. } \arguments{ \item{x}{a vector.} - \item{list}{an index vector.} + \item{list}{an index \link{vector}.} \item{values}{replacement values.} } \value{ @@ -28,4 +28,16 @@ If necessary, the values in \code{values} are recycled. \note{ \code{x} is unchanged: remember to assign the result. } +\seealso{ + \link{Extract} to replace in objects. +} +\value{ + x <- 1:5 + (y <- replace(x, c(2, 5), c(8, 9))) + x # Not modified + + # Works with any vector + z <- list(A = "a", B = 2, C = diag(5)) + replace(z, c(1, 2, 3), list(5, diag(3), "A")) +} \keyword{manip}