Skip to content

Commit

Permalink
Deploying to gh-pages from @ c75dd79 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
andrie committed Mar 17, 2024
1 parent be51a5e commit 8fc7cce
Show file tree
Hide file tree
Showing 12 changed files with 22 additions and 21 deletions.
4 changes: 2 additions & 2 deletions r-admin/Configuration-on-a-Unix-alike.html
Original file line number Diff line number Diff line change
Expand Up @@ -530,8 +530,8 @@ <h2 class="section anchored" data-number="B.7" data-anchor-id="compile-and-load-
<h2 class="section anchored" data-number="B.8" data-anchor-id="maintainer-mode"><span class="header-section-number">B.8</span> Maintainer mode</h2>
<p>There are several files that are part of the R sources but can be re-generated from their own sources by configuring with option <code>--enable-maintainer-mode</code> and then running <code>make</code> in the build directory. This requires other tools to be installed, discussed in the rest of this section.</p>
<p>File <code>configure</code> is created from <code>configure.ac</code> and the files under <code>m4</code> by <code>autoconf</code> and <code>aclocal</code> (part of the <strong>automake</strong> package). There is a formal version requirement on <code>autoconf</code> of 2.71 or later, but it is unlikely that anything other than the most recent versions<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a> have been thoroughly tested.</p>
<div class="no-row-height column-margin column-container"><div id="fn2"><p><sup>2</sup>&nbsp;at the time of revision of this para in late 2021, <strong>autoconf-2.71</strong> and <strong>automake-1.16.5</strong>. Subsequently <strong>autoconf-2.72</strong> has been tested.</p></div></div><p>File <code>src/include/config.h</code> is created by <code>autoheader</code> (part of <strong>autoconf</strong>).</p>
<p>Grammar files <code>*.y</code> are converted to C sources by an implementation of <code>yacc</code>, usually <code>bison -y</code>: these are found in <code>src/main</code> and <code>src/library/tools/src</code>. It is known that earlier versions of <code>bison</code> generate code which reads (and in some cases writes) outside array bounds: <code>bison</code> 2.6.1 was found to be satisfactory.</p>
<div class="no-row-height column-margin column-container"><div id="fn2"><p><sup>2</sup>&nbsp;at the time of revision of this para in early 2024, <strong>autoconf-2.72</strong> and <strong>automake-1.16.5</strong>. Previously <strong>autoconf-2.71</strong> was used.</p></div></div><p>File <code>src/include/config.h</code> is created by <code>autoheader</code> (part of <strong>autoconf</strong>).</p>
<p>Grammar files <code>*.y</code> are converted to C sources by an implementation of <code>yacc</code>, usually <code>bison -y</code>: these are found in <code>src/main</code> and <code>src/library/tools/src</code>. It is known that earlier versions of <code>bison</code> generate code which reads (and in some cases writes) outside array bounds: <code>bison</code> 3.8.2 is currently used.</p>
<p>The ultimate sources for package <strong>compiler</strong> are in its <code>noweb</code> directory. To re-create the sources from <code>src/library/compiler/noweb/compiler.nw</code>, the command <code>notangle</code> is required. Some Linux distributions include this command in package <strong>noweb</strong>. It can also be installed from the sources at <a href="https://www.cs.tufts.edu/~nr/noweb/" class="uri">https://www.cs.tufts.edu/~nr/noweb/</a><a href="#fn3" class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</sup></a>. The package sources are only re-created even in maintainer mode if <code>src/library/compiler/noweb/compiler.nw</code> has been updated.</p>
<div class="no-row-height column-margin column-container"><div id="fn3"><p><sup>3</sup>&nbsp;The links there have proved difficult to access, in which case grab the copy made available at <a href="https://developer.r-project.org/noweb-2.11b.tgz" class="uri">https://developer.r-project.org/noweb-2.11b.tgz</a>.</p></div></div><p>Footnotes</p>

Expand Down
5 changes: 3 additions & 2 deletions r-admin/Installing-R-under-Windows.html
Original file line number Diff line number Diff line change
Expand Up @@ -345,8 +345,9 @@ <h2 class="section anchored" data-number="3.1" data-anchor-id="building-from-sou
<p>It is possible to use other 64-bit toolchains (including ‘MSYS2’) with UCRT support to build R, but this manual only documents that used for binary distributions of R 4.2.x and later. When using other toolchains, makefiles of R and packages may need to be adapted.</p>
<section id="the-windows-toolset" class="level3 subsection" data-number="3.1.1">
<h3 class="subsection anchored" data-number="3.1.1" data-anchor-id="the-windows-toolset"><span class="header-section-number">3.1.1</span> The Windows toolset</h3>
<p>The binary distribution of R is currently built with tools from <a href="https://CRAN.R-project.org/bin/windows/Rtools/rtools43/rtools.html">Rtools43 for Windows</a>. See <a href="https://CRAN.R-project.org/bin/windows/base/howto-R-devel.html">Building R and packages</a> for more details on how to use it.</p>
<p>The toolset includes compilers (GCC version 12.2.0 with selected additional patches) and runtime libraries from <a href="http://mingw-w64.org/">the ‘MinGW-w64’ project</a> and a number of pre-compiled static libraries and headers used by R and R packages, compiled by <a href="https://mxe.cc/">‘MXE’</a> (M cross environment, with updates maintained by Tomas Kalibera). The toolset also includes build tools from the <a href="https://www.msys2.org/">the ‘MSYS2’ project</a>. Additional build tools packaged by ‘MSYS2’ may be installed via a package manager (<code>pacman</code>).</p>
<p>The binary distribution of R is currently built with tools from <a href="https://CRAN.R-project.org/bin/windows/Rtools/rtools44/rtools.html">Rtools44 for Windows</a>. See <a href="https://CRAN.R-project.org/bin/windows/base/howto-R-devel.html">Building R and packages</a> for more details on how to use it.</p>
<p>The toolset includes compilers (GCC version 13.2.0 with selected additional patches) and runtime libraries from <a href="http://mingw-w64.org/">the ‘MinGW-w64’ project</a> and a number of pre-compiled static libraries and headers used by R and R packages, compiled by <a href="https://mxe.cc/">‘MXE’</a> (M cross environment, with updates maintained by Tomas Kalibera). The toolset also includes build tools from the <a href="https://www.msys2.org/">the ‘MSYS2’ project</a>. Additional build tools packaged by ‘MSYS2’ may be installed via a package manager (<code>pacman</code>).</p>
<p>There is also an experimental variant of Rtools44 with support for 64-bit ARM CPUs (aarch64) via LLVM 17 toolchain using clang/flang-new compilers, lld linker, and libc++.</p>
<p>The toolsets used for 64-bit Windows from 2008 to 2022 were based on MinGW-w64. The assistance of Yu Gong at a crucial step in porting R to MinGW-w64 is gratefully acknowledged, as well as help from Kai Tietz, the lead developer of the MinGW-w64 project and from Martin Storsjo.</p>
</section>
<section id="latex" class="level3 subsection page-columns page-full" data-number="3.1.2">
Expand Down
2 changes: 1 addition & 1 deletion r-admin/Installing-R-under-macOS.html
Original file line number Diff line number Diff line change
Expand Up @@ -333,7 +333,7 @@ <h1 class="title"><span class="chapter-number">4</span>&nbsp; <span class="chapt
<p>[The rest of this paragraph is only relevant after release.] The front page of a CRAN site has a link ‘Download R for (Mac) OS X’ which takes you to a new page. Two files are offered for download, <code>R-4.4.0 Under development-arm64.pkg</code> and <code>R-4.4.0 Under development.pkg</code>. Both are for macOS 11 or later (Big Sur, Monterey, Ventura, Sonoma, …).</p>
<p>The first is for ‘Apple Silicon’ (<em>aka</em> ‘M1’, ‘M2’ or ‘M3’) Macs, the second for older Macs with an <code>x86_64</code> (Intel) CPU.</p>
<p>Package <code>R-4.4.0 Under development.pkg</code> also be installed on ‘Apple Silicon’ CPUs using ‘Rosetta’ emulation<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a>, but the native build is preferred. It is a little faster (and for some tasks, considerably so) but may give different numerical results from the more common <code>x86_64</code> platforms (on Windows, Linux, … as well as macOS) as ARM hardware lacks extended-precision floating-point operations.</p>
<div class="no-row-height column-margin column-container"><div id="fn1"><p><sup>1</sup>&nbsp;You may be asked to install Rosetta at first use – <a href="https://support.apple.com/en-us/HT211861" class="uri">https://support.apple.com/en-us/HT211861</a> – which may need administrator privileges.</p></div></div><p>It is important that if you use a binary installer package that your OS is fully updated: look at ‘Software Update’ in ‘System Preferences’ to be sure.</p>
<div class="no-row-height column-margin column-container"><div id="fn1"><p><sup>1</sup>&nbsp;You may be asked to install Rosetta at first use – <a href="https://support.apple.com/en-us/102527" class="uri">https://support.apple.com/en-us/102527</a> – which may need administrator privileges.</p></div></div><p>It is important that if you use a binary installer package that your OS is fully updated: look at ‘Software Update’ in ‘System Preferences’ to be sure.</p>
<p>To install, just double-click on the icon of the file you downloaded. At the ‘Installation Type’ stage, note the option to ‘Customize’. This currently shows four components: everyone will need the ‘R Framework’ component: the remaining components are optional. (The ‘Tcl/Tk’ component is needed to use package <strong>tcltk</strong>. The ‘Texinfo’ component is only needed by those installing source packages or R from its sources.)</p>
<p>Note for Ventura users: installation from the <code>Downloads</code> folder may not be allowed or may require additional authorization, so we suggest you download somewhere else such as your desktop or home folder.</p>
<p>These are Apple Installer packages. If you encounter any problem during the installation, please check the Installer log by clicking on the “Window” menu and item “Installer Log”. The full output (select “Show All Log”) is useful for tracking down problems. Note that the installer is clever enough to try to upgrade the last-installed version of the application where you installed it (which may not be where you want this time …).</p>
Expand Down
4 changes: 2 additions & 2 deletions r-admin/search.json
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@
"href": "Installing-R-under-Windows.html#building-from-source",
"title": "3  Installing R under Windows",
"section": "",
"text": "3.1.1 The Windows toolset\nThe binary distribution of R is currently built with tools from Rtools43 for Windows. See Building R and packages for more details on how to use it.\nThe toolset includes compilers (GCC version 12.2.0 with selected additional patches) and runtime libraries from the ‘MinGW-w64’ project and a number of pre-compiled static libraries and headers used by R and R packages, compiled by ‘MXE’ (M cross environment, with updates maintained by Tomas Kalibera). The toolset also includes build tools from the the ‘MSYS2’ project. Additional build tools packaged by ‘MSYS2’ may be installed via a package manager (pacman).\nThe toolsets used for 64-bit Windows from 2008 to 2022 were based on MinGW-w64. The assistance of Yu Gong at a crucial step in porting R to MinGW-w64 is gratefully acknowledged, as well as help from Kai Tietz, the lead developer of the MinGW-w64 project and from Martin Storsjo.\n\n\n3.1.2 LaTeX\nBoth building R and checking packages need a distribution of LaTeX installed, with the directory containing pdflatex on the path.\nThe MiKTeX (https://miktex.org/) distribution of LaTeX is that used on CRAN. This can be set up to install extra packages ‘on the fly’ (without asking), which is the simplest way to use it. The ‘basic’ version of MiKTeX will need to add some packages.1 In any case ensure that the inconsolata package is installed—you can check with the MiKTeX Package Manager.\n1 There are reports of segfaults when MiKTeX installs additional packages when making NEWS.pdf: re-running make seems to solve this.It is also possible to use the TeX Live distribution from https://www.tug.org/texlive/. (The CRAN package tinytex can install and manage a subset of TeX Live.)",
"text": "3.1.1 The Windows toolset\nThe binary distribution of R is currently built with tools from Rtools44 for Windows. See Building R and packages for more details on how to use it.\nThe toolset includes compilers (GCC version 13.2.0 with selected additional patches) and runtime libraries from the ‘MinGW-w64’ project and a number of pre-compiled static libraries and headers used by R and R packages, compiled by ‘MXE’ (M cross environment, with updates maintained by Tomas Kalibera). The toolset also includes build tools from the the ‘MSYS2’ project. Additional build tools packaged by ‘MSYS2’ may be installed via a package manager (pacman).\nThere is also an experimental variant of Rtools44 with support for 64-bit ARM CPUs (aarch64) via LLVM 17 toolchain using clang/flang-new compilers, lld linker, and libc++.\nThe toolsets used for 64-bit Windows from 2008 to 2022 were based on MinGW-w64. The assistance of Yu Gong at a crucial step in porting R to MinGW-w64 is gratefully acknowledged, as well as help from Kai Tietz, the lead developer of the MinGW-w64 project and from Martin Storsjo.\n\n\n3.1.2 LaTeX\nBoth building R and checking packages need a distribution of LaTeX installed, with the directory containing pdflatex on the path.\nThe MiKTeX (https://miktex.org/) distribution of LaTeX is that used on CRAN. This can be set up to install extra packages ‘on the fly’ (without asking), which is the simplest way to use it. The ‘basic’ version of MiKTeX will need to add some packages.1 In any case ensure that the inconsolata package is installed—you can check with the MiKTeX Package Manager.\n1 There are reports of segfaults when MiKTeX installs additional packages when making NEWS.pdf: re-running make seems to solve this.It is also possible to use the TeX Live distribution from https://www.tug.org/texlive/. (The CRAN package tinytex can install and manage a subset of TeX Live.)",
"crumbs": [
"<span class='chapter-number'>3</span>  <span class='chapter-title'>Installing R under Windows</span>"
]
Expand Down Expand Up @@ -536,7 +536,7 @@
"href": "Configuration-on-a-Unix-alike.html#maintainer-mode",
"title": "Appendix B — Configuration on a Unix-alike",
"section": "B.8 Maintainer mode",
"text": "B.8 Maintainer mode\nThere are several files that are part of the R sources but can be re-generated from their own sources by configuring with option --enable-maintainer-mode and then running make in the build directory. This requires other tools to be installed, discussed in the rest of this section.\nFile configure is created from configure.ac and the files under m4 by autoconf and aclocal (part of the automake package). There is a formal version requirement on autoconf of 2.71 or later, but it is unlikely that anything other than the most recent versions2 have been thoroughly tested.\n2 at the time of revision of this para in late 2021, autoconf-2.71 and automake-1.16.5. Subsequently autoconf-2.72 has been tested.File src/include/config.h is created by autoheader (part of autoconf).\nGrammar files *.y are converted to C sources by an implementation of yacc, usually bison -y: these are found in src/main and src/library/tools/src. It is known that earlier versions of bison generate code which reads (and in some cases writes) outside array bounds: bison 2.6.1 was found to be satisfactory.\nThe ultimate sources for package compiler are in its noweb directory. To re-create the sources from src/library/compiler/noweb/compiler.nw, the command notangle is required. Some Linux distributions include this command in package noweb. It can also be installed from the sources at https://www.cs.tufts.edu/~nr/noweb/3. The package sources are only re-created even in maintainer mode if src/library/compiler/noweb/compiler.nw has been updated.\n3 The links there have proved difficult to access, in which case grab the copy made available at https://developer.r-project.org/noweb-2.11b.tgz.Footnotes",
"text": "B.8 Maintainer mode\nThere are several files that are part of the R sources but can be re-generated from their own sources by configuring with option --enable-maintainer-mode and then running make in the build directory. This requires other tools to be installed, discussed in the rest of this section.\nFile configure is created from configure.ac and the files under m4 by autoconf and aclocal (part of the automake package). There is a formal version requirement on autoconf of 2.71 or later, but it is unlikely that anything other than the most recent versions2 have been thoroughly tested.\n2 at the time of revision of this para in early 2024, autoconf-2.72 and automake-1.16.5. Previously autoconf-2.71 was used.File src/include/config.h is created by autoheader (part of autoconf).\nGrammar files *.y are converted to C sources by an implementation of yacc, usually bison -y: these are found in src/main and src/library/tools/src. It is known that earlier versions of bison generate code which reads (and in some cases writes) outside array bounds: bison 3.8.2 is currently used.\nThe ultimate sources for package compiler are in its noweb directory. To re-create the sources from src/library/compiler/noweb/compiler.nw, the command notangle is required. Some Linux distributions include this command in package noweb. It can also be installed from the sources at https://www.cs.tufts.edu/~nr/noweb/3. The package sources are only re-created even in maintainer mode if src/library/compiler/noweb/compiler.nw has been updated.\n3 The links there have proved difficult to access, in which case grab the copy made available at https://developer.r-project.org/noweb-2.11b.tgz.Footnotes",
"crumbs": [
"Appendices",
"<span class='chapter-number'>B</span>  <span class='chapter-title'>Configuration on a Unix-alike</span>"
Expand Down
2 changes: 1 addition & 1 deletion r-admin/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion r-data/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion r-exts/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion r-intro/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion r-ints/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion r-lang/site_libs/bootstrap/bootstrap.min.css

Large diffs are not rendered by default.

Loading

0 comments on commit 8fc7cce

Please sign in to comment.