diff --git a/README.md b/README.md index 84687eb..ca69dce 100644 --- a/README.md +++ b/README.md @@ -17,18 +17,28 @@ Install, remove, configure R versions. ## 🚀  Features -- Works on macOS, Windows and Linux (Ubuntu LTS and Debian, x86_64 and - aarch64). +- Works on macOS, Windows and Linux. +- Supports many Linux distributions, see [list + below](#supported-linux-distributions). - Easy installation and update, no system requirements on any platform. - Install multiple R versions. - Select the default R version, for the terminal and RStudio. - Select R version to install using symbolic names: `devel`, `next`, `release`, `oldrel`, etc. +- List R versions available to install. - Run multiple versions *at the same* time using quick links. E.g. `R-4.1` or `R-4.1.2` starts R 4.1.x. Quick links are automatically added to the user’s path. -- On M1 macs select between x86_64 and arm64 versions or R, or install - both. +- On macOS it comes with a menu bar app that shows the default R version + and lets to select it interactively. [See + below](#id-macos-menu-bar-app). +- On arm64 macs select between x86_64 and arm64 versions or R, or + install both. +- Sets up the default CRAN mirror and + [PPM](https://packagemanager.posit.co/). +- Installs [pak](https://pak.r-lib.org) and set up automatic [system + requirements + installation](https://pak.r-lib.org/dev/reference/sysreqs.html). - Creates and configures user level package libraries. - Restricts permissions to the system library. (On macOS, not needed on Windows and Linux). @@ -38,13 +48,12 @@ Install, remove, configure R versions. - Installs the appropriate Rtools versions on Windows and sets them up. - Cleans up stale R-related entries from the Windows registry. - Switches to root/administrator user as needed. +- Supports JSON output for scripting. ## 🐞  Known Issues - On macOS, R.app often does not work if you install multiple R versions. -- On Windows you need to restart your shell or terminal after installing - Rtools, for the changes to take effect. - On Windows, `rig rstudio` changes the R version in the registry temporarily before starting RStudio and then changes it back after a short wait. If RStudio starts up very slowly, then the wait might be @@ -145,15 +154,20 @@ If you are running Linux on arm64, download the arm64 build: curl -Ls https://github.com/r-lib/rig/releases/download/latest/rig-linux-arm64-latest.tar.gz | sudo tar xz -C /usr/local -Supported Linux distributions: +#### Supported Linux distributions: -- Ubuntu LTS from - [r-builds](https://github.com/rstudio/r-builds#r-builds), currently - 20.04, 22.04. -- Debian from [r-builds](https://github.com/rstudio/r-builds#r-builds), - currently 10, 11 and 12. +- Debian 10, 11, 12, +- Ubuntu 18.04, 20.04, 22.04, +- Fedora Linux 37, 38, +- OpenSUSE 15.3, 15.4, +- SUSE Linux Enterprise 15 SP3, SP4, +- CentOS 7, +- Red Hat Enterprise Linux 7, 8, 9, +- AlmaLinux 8, 9, +- Rocky Linux 8, 9. -Other Linux distributions are coming soon. +We use the R builds from the Posit [R-builds +project](https://github.com/rstudio/r-builds#r-builds). ### Auto-complete @@ -178,6 +192,8 @@ Use `rig list` to list the currently installed R versions, and Run `rig` to see all commands and examples. +Run `rig --help` and `rig --help` to see the documentation. + ### Command list: rig add -- install a new R version [alias: install] @@ -217,6 +233,7 @@ Run `rig --help` for information about a subcommand. ### Linux `rig system` subcommands + rig system detect-platform -- detect operating system version and distribution rig system add-pak -- install or update pak for an R version rig system make-links -- create R-* quick links rig system setup-user-lib -- set up automatic user package libraries [alias: create-lib] @@ -251,13 +268,13 @@ R-devel. It is available for x86_64 and arm64 systems: > docker run ghcr.io/r-lib/rig/r rig ls * name version aliases ------------------------------------------ - 3.5.3 3.6.3 4.0.5 - 4.1.3 oldrel - * 4.2.2 release - devel (R 4.3.0) - next (R 4.2.2) + 4.1.3 + 4.2.3 oldrel + * 4.3.1 release + devel (R 4.4.0) + next (R 4.3.1) ### Docker container features: