R Installation and Administration Version 3.6.3 Patched (2020-02-29) R Core Team This manual is for R, version 3.6.3 Patched (2020-02-29). Copyright c 2001{2018 R Core Team Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into an- other language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the R Core Team. i Table of Contents 1 Obtaining R :::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.1 Getting and unpacking the sources ::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.2 Getting patched and development versions ::::::::::::::::::::::::::::::::::::::::: 1 1.2.1 Using Subversion and rsync ::::::::::::::::::::::::::::::::::::::::::::::::::: 1 2 Installing R under Unix-alikes :::::::::::::::::::::::::::::::: 3 2.1 Simple compilation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 3 2.2 Help options ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 4 2.3 Making the manuals ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 4 2.4 Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 6 2.5 Uninstallation ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 8 2.6 Sub-architectures :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 8 2.6.1 Multilib::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 9 2.7 Other Options :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 2.7.1 Debugging Symbols :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 2.7.2 OpenMP Support :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 2.7.3 C++ Support:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 2.7.4 Link-Time Optimization ::::::::::::::::::::::::::::::::::::::::::::::::::::: 12 2.8 Testing an Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 12 3 Installing R under Windows ::::::::::::::::::::::::::::::::: 14 3.1 Building from source:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 14 3.1.1 Getting the tools::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 14 3.1.2 Getting the source files::::::::::::::::::::::::::::::::::::::::::::::::::::::: 14 3.1.3 Building the core files :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 15 3.1.4 Building the cairo devices :::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.5 Using ICU for collation :::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.6 Support for libcurl ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.7 Checking the build ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.8 Building the manuals :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 17 3.1.9 Building the Inno Setup installer ::::::::::::::::::::::::::::::::::::::::::::: 17 3.1.10 Building the MSI installer::::::::::::::::::::::::::::::::::::::::::::::::::: 18 3.1.11 64-bit Windows builds :::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 3.2 Testing an Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 4 Installing R under macOS:::::::::::::::::::::::::::::::::::: 20 4.1 Running R under macOS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 20 4.2 Uninstalling under macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 21 4.3 Multiple versions ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 21 5 Running R::::::::::::::::::::::::::::::::::::::::::::::::::::: 23 6 Add-on packages :::::::::::::::::::::::::::::::::::::::::::::: 24 6.1 Default packages:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 6.2 Managing libraries :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 6.3 Installing packages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 ii 6.3.1 Windows :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 25 6.3.2 macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 26 6.3.3 Customizing package compilation::::::::::::::::::::::::::::::::::::::::::::: 28 6.3.4 Multiple sub-architectures:::::::::::::::::::::::::::::::::::::::::::::::::::: 29 6.3.5 Byte-compilation::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 6.3.6 External software :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 6.4 Updating packages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 30 6.5 Removing packages ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 30 6.6 Setting up a package repository ::::::::::::::::::::::::::::::::::::::::::::::::::: 31 6.7 Checking installed source packages :::::::::::::::::::::::::::::::::::::::::::::::: 31 7 Internationalization and Localization:::::::::::::::::::::::: 33 7.1 Locales ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 33 7.1.1 Locales under Unix-alikes :::::::::::::::::::::::::::::::::::::::::::::::::::: 33 7.1.2 Locales under Windows :::::::::::::::::::::::::::::::::::::::::::::::::::::: 33 7.1.3 Locales under macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 34 7.2 Localization of messages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 34 8 Choosing between 32- and 64-bit builds :::::::::::::::::::: 36 9 The standalone Rmath library ::::::::::::::::::::::::::::::: 37 9.1 Unix-alikes ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 37 9.2 Windows ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 38 Appendix A Essential and useful other programs under a Unix-alike :::::::::::::::::::::::::::::::::: 40 A.1 Essential programs and libraries :::::::::::::::::::::::::::::::::::::::::::::::::: 40 A.2 Useful libraries and programs::::::::::::::::::::::::::::::::::::::::::::::::::::: 42 A.2.1 Tcl/Tk:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 43 A.2.2 Java support :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 44 A.2.3 Other compiled languages ::::::::::::::::::::::::::::::::::::::::::::::::::: 45 A.3 Linear algebra:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 45 A.3.1 BLAS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 45 A.3.1.1 ATLAS::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 46 A.3.1.2 OpenBLAS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 47 A.3.1.3 Intel MKL:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 47 A.3.1.4 Shared BLAS::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 48 A.3.2 LAPACK ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 49 A.3.3 Caveats ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 50 Appendix B Configuration on a Unix-alike ::::::::::::::::::: 51 B.1 Configuration options :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 51 B.2 Internationalization support :::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.3 Configuration variables ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.3.1 Setting paper size ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.3.2 Setting the browsers ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.3.3 Compilation flags:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 B.3.4 Making manuals ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 B.4 Setting the shell :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 B.5 Using make :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 B.6 Using Fortran :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 iii B.7 Compile and load flags ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 54 B.8 Maintainer mode ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 55 Appendix C Platform notes :::::::::::::::::::::::::::::::::::: 57 C.1 X11 issues:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 57 C.2 Linux :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 58 C.2.1 Clang ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 60 C.2.2 Intel compilers :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 60 C.3 macOS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 61 C.3.1 Prerequisites :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 61 C.3.1.1 Note for Catalina users ::::::::::::::::::::::::::::::::::::::::::::::::: 63 C.3.2 Recommended C/C++ compilers :::::::::::::::::::::::::::::::::::::::::::: 63 C.3.3 Other libraries::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 64 C.3.4 Tcl/Tk headers and libraries::::::::::::::::::::::::::::::::::::::::::::::::: 64 C.3.5 Java::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 65 C.3.6 Frameworks ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 66 C.3.7 Building R.app ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::