From f4e704b90411cfb6fad0fb08a171a03b8032b6c4 Mon Sep 17 00:00:00 2001 From: Pau Amma Date: Mon, 15 Dec 2025 23:42:21 +0100 Subject: [PATCH 1/5] getting_started: minor copyediting Mostly missing or superfluous punctuation --- chapters/getting_started.qmd | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/chapters/getting_started.qmd b/chapters/getting_started.qmd index f6ab562..a3bf23f 100644 --- a/chapters/getting_started.qmd +++ b/chapters/getting_started.qmd @@ -4,11 +4,11 @@ These instructions cover how to install R from source or from binaries. Contributors will typically need to work with the patched or development versions of R. This chapter describes where the source code for these versions can be found and how to install these versions from the source or the binary builds (where available). The tools required to build R and R packages are also discussed. -For the most up to date and complete instructions you can check the [R installation and administration manual](https://cran.r-project.org/doc/manuals/r-devel/R-admin.html) . +For the most up-to-date and complete instructions you can check the [R installation and administration manual](https://cran.r-project.org/doc/manuals/r-devel/R-admin.html) . ## The R source code -R uses [svn](https://subversion.apache.org/ "SVN official page") as a version control tool hosted at and uses a 'major.minor.patchlevel' version numbering scheme[^02-getting_started-1]. +R uses [svn](https://subversion.apache.org/ "SVN official page") as a version-control tool hosted at and uses a 'major.minor.patchlevel' version-numbering scheme[^02-getting_started-1]. [^02-getting_started-1]: Also known as [semantic versioning](https://en.wikipedia.org/wiki/Software_versioning#Semantic_versioning "Wikipedia explanation of semantic versioning") @@ -20,8 +20,7 @@ There are three releases of R available to install: - The development release (`r-devel`) : continually developed version moving from r-release to next major/minor version (x + 1).0.0 or x.(y + 1).0 a few weeks before release (at the start of the "GRAND FEATURE FREEZE"). -The source code of released versions of R can be found at [R/tags](https://svn.r-project.org/R/tags/ "svn release source code folder"), the patched versions are at [R/branch](https://svn.r-project.org/R/branches/ "svn patched source code folder"). - +The source code of released versions of R can be found at [R/tags](https://svn.r-project.org/R/tags/ "svn release source code folder"), and the patched versions are at [R/branch](https://svn.r-project.org/R/branches/ "svn patched source code folder"). The `r-devel` at [R/trunk](https://svn.r-project.org/R/trunk "svn devel source code folder") is the next minor or eventual major release development version of R. Bug fixes and new features are introduced in `r-devel` first. @@ -78,7 +77,7 @@ For this reason we have a `TOP_SRCDIR` variable where the source code goes and t Here are the basic steps intended as a checklist. For complete instructions please see the section in [R-admin](https://cran.r-project.org/doc/manuals/r-devel/R-admin.html#Installing-R-under-Unix_002dalikes). -0. Retrieve R source code via into `TOP_SRCDIR`, note that we retrieve the `r-devel` source code: +0. Retrieve R source code via into `TOP_SRCDIR` (note that we retrieve the `r-devel` source code): ```sh export TOP_SRCDIR="$HOME/Downloads/R" @@ -99,7 +98,7 @@ For complete instructions please see the section in [R-admin](https://cran.r-pro cd "$BUILDDIR" ``` -4. Configure the R installation (with `--enable-R-shlib` so that RStudio IDE can use it): +4. Configure the R installation (with `--enable-R-shlib` so that the RStudio IDE can use it): ```sh "$TOP_SRCDIR/configure" --enable-R-shlib @@ -111,7 +110,6 @@ For complete instructions please see the section in [R-admin](https://cran.r-pro make ``` - 5. Check that R works as expected: ```sh @@ -143,7 +141,6 @@ make check Once you successfully built R from source you can modify the R source code to fix an issue: Prepare a patch (See [this guide](https://www.r-project.org/bugs.html#how-to-submit-patches)) and after checking that R works as intended (`make check-devel`) submit the patch for consideration by R Core. (See the [lifecycle of a patch](#sec-lifecycle-of-a-patch) chapter). - To use the `r-devel` version in RStudio, you can do the following: ```sh @@ -201,7 +198,7 @@ Before installing R from source, some additional programs are needed, as per the svn update ``` - You can also use a SVN client such as TortoiseSVN (, command line tool, and Windows Explorer integration) or SlikSVN (, just the command line tool) so that it can be also found by other tools. + You can also use a SVN client such as TortoiseSVN (, command line tool and Windows Explorer integration) or SlikSVN (, just the command line tool) so that it can be also found by other tools. 2. Download the latest tcl/tk and unzip it in `$TOP_SRCDIR`: From 8097f579fef0d336b2db34d7d4f496ede8c8931e Mon Sep 17 00:00:00 2001 From: Pau Amma Date: Tue, 16 Dec 2025 02:28:25 +0100 Subject: [PATCH 2/5] Update chapters/getting_started.qmd Co-authored-by: Heather Turner --- chapters/getting_started.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/getting_started.qmd b/chapters/getting_started.qmd index a3bf23f..469f1a5 100644 --- a/chapters/getting_started.qmd +++ b/chapters/getting_started.qmd @@ -8,7 +8,7 @@ For the most up-to-date and complete instructions you can check the [R installat ## The R source code -R uses [svn](https://subversion.apache.org/ "SVN official page") as a version-control tool hosted at and uses a 'major.minor.patchlevel' version-numbering scheme[^02-getting_started-1]. +R uses [svn](https://subversion.apache.org/ "SVN official page") as a version control tool hosted at and uses a 'major.minor.patchlevel' version numbering scheme[^02-getting_started-1]. [^02-getting_started-1]: Also known as [semantic versioning](https://en.wikipedia.org/wiki/Software_versioning#Semantic_versioning "Wikipedia explanation of semantic versioning") From d477eeececaf727869ed97250812eafa1387a2f0 Mon Sep 17 00:00:00 2001 From: Pau Amma Date: Tue, 16 Dec 2025 02:29:18 +0100 Subject: [PATCH 3/5] Update chapters/getting_started.qmd Co-authored-by: Heather Turner --- chapters/getting_started.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/getting_started.qmd b/chapters/getting_started.qmd index 469f1a5..d14d55a 100644 --- a/chapters/getting_started.qmd +++ b/chapters/getting_started.qmd @@ -20,7 +20,7 @@ There are three releases of R available to install: - The development release (`r-devel`) : continually developed version moving from r-release to next major/minor version (x + 1).0.0 or x.(y + 1).0 a few weeks before release (at the start of the "GRAND FEATURE FREEZE"). -The source code of released versions of R can be found at [R/tags](https://svn.r-project.org/R/tags/ "svn release source code folder"), and the patched versions are at [R/branch](https://svn.r-project.org/R/branches/ "svn patched source code folder"). +The source code of released versions of R can be found at [R/tags](https://svn.r-project.org/R/tags/ "svn release source code folder") and the patched versions are at [R/branch](https://svn.r-project.org/R/branches/ "svn patched source code folder"). The `r-devel` at [R/trunk](https://svn.r-project.org/R/trunk "svn devel source code folder") is the next minor or eventual major release development version of R. Bug fixes and new features are introduced in `r-devel` first. From c7d12762006a3d55aaec240006d353157498ea4f Mon Sep 17 00:00:00 2001 From: Pau Amma Date: Tue, 16 Dec 2025 02:29:44 +0100 Subject: [PATCH 4/5] Update chapters/getting_started.qmd Co-authored-by: Heather Turner --- chapters/getting_started.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/getting_started.qmd b/chapters/getting_started.qmd index d14d55a..f3226aa 100644 --- a/chapters/getting_started.qmd +++ b/chapters/getting_started.qmd @@ -77,7 +77,7 @@ For this reason we have a `TOP_SRCDIR` variable where the source code goes and t Here are the basic steps intended as a checklist. For complete instructions please see the section in [R-admin](https://cran.r-project.org/doc/manuals/r-devel/R-admin.html#Installing-R-under-Unix_002dalikes). -0. Retrieve R source code via into `TOP_SRCDIR` (note that we retrieve the `r-devel` source code): +0. Retrieve R source code into `TOP_SRCDIR` (note that we retrieve the `r-devel` source code): ```sh export TOP_SRCDIR="$HOME/Downloads/R" From 29ef5b49b3e0c20f8228d5fcdba55b95aa716c4f Mon Sep 17 00:00:00 2001 From: Pau Amma Date: Tue, 16 Dec 2025 02:30:13 +0100 Subject: [PATCH 5/5] Update chapters/getting_started.qmd Co-authored-by: Heather Turner --- chapters/getting_started.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/getting_started.qmd b/chapters/getting_started.qmd index f3226aa..6ecb4f1 100644 --- a/chapters/getting_started.qmd +++ b/chapters/getting_started.qmd @@ -198,7 +198,7 @@ Before installing R from source, some additional programs are needed, as per the svn update ``` - You can also use a SVN client such as TortoiseSVN (, command line tool and Windows Explorer integration) or SlikSVN (, just the command line tool) so that it can be also found by other tools. + You can also use an SVN client such as TortoiseSVN (, a command line tool and Windows Explorer integration) or SlikSVN (, a command line tool) to check out and work with the SVN repository. 2. Download the latest tcl/tk and unzip it in `$TOP_SRCDIR`: