From af5de1a034bde8af2d1037d5b913fa3a817afd90 Mon Sep 17 00:00:00 2001 From: Thomas Staudinger Date: Fri, 7 Jun 2024 19:07:48 +0200 Subject: [PATCH] rstudio: Use correct package installation command and Solus dependencies Remove additional dependencies that are already covered by `curl-devel` Additional small fixes Signed-off-by: Thomas Staudinger --- .../software/development/r-and-rstudio.md | 32 ++++++++----------- 1 file changed, 13 insertions(+), 19 deletions(-) diff --git a/docs/user/software/development/r-and-rstudio.md b/docs/user/software/development/r-and-rstudio.md index 64123f0b0..d7693c284 100644 --- a/docs/user/software/development/r-and-rstudio.md +++ b/docs/user/software/development/r-and-rstudio.md @@ -5,42 +5,36 @@ summary: Quick start guide for R and RStudio on Solus # R and RStudio -Covers the basics of how to install R and RStudio on Solus and also covers how to install required dependencies for installing additional CRAN libraries. +Covers the basics of how to install R and RStudio on Solus and how to install required dependencies for installing additional CRAN libraries. ## Downloading R It is recommended to download R before downloading RStudio. This can be accomplished easily in any of three ways. **NOTE:** Both R and RStudio are available natively on Solus thanks to their amazing maintainers, it is not necessary to go to either software's respective website. -- The easiest way to do this is to search for R within the **Software Center** +- The easiest way to do this is to search for "R" within the **Software Center** - Alternatively you can enter the **Software Center**, select **Programming Languages & Tools**, then select **Programming** and scroll down until you see **r**. _The list itself is in alphabetical order so it will be near the bottom._ -- The third option for install is to open your terminal and enter the command `sudo eopkg it r` +- The third option for installation is to open your terminal and enter the command `sudo eopkg it r` ## Downloading RStudio The first step in setting up RStudio is to download and install it. This can be accomplished in the same ways as R in the prior step. -- The easiest way to do this is to search for RStudio within the **Software Center** -- Alternatively you can enter the **Software Center**, select **Programming Languages & Tools**, then select **Integrated Development Environments** and scroll down until you see **r**. _The list itself is in alphabetical order so it will be near the bottom._ -- The third option for install is to open your terminal and enter the command `sudo eopkg it rstudio` +- The easiest way to do this is to search for "RStudio" within the **Software Center** +- Alternatively you can enter the **Software Center**, select **Programming Languages & Tools**, then select **Integrated Development Environments** and scroll down until you see **RStudio**. _The list itself is in alphabetical order so it will be near the bottom._ +- The third option for installation is to open your terminal and enter the command `sudo eopkg it rstudio` -### How to use `install.package()` on Solus +### How to use `install.packages()` on Solus -Unless you are only going to use base R functions, you will need to make use of `install.package()` within R to install additional libraries. To use this function within R you need to install certain development packages which vary depending on the library you are trying to enable within R. +Unless you are only going to use base R functions, you will need to make use of `install.packages()` within R to install additional libraries. To use this function you need to install certain development packages which vary depending on the library you are trying to enable within R. On other Linux distros (like Debian, Ubuntu, and Fedora) this is accomplished through the installation of r-devel. However since Solus does not have an r-devel package these dependencies have to be installed through other means. -There two main solus packages that will include many of the dependencies required that allow you to install most R CRAN packages. These are `system.devel` and `curl-devel`. +There are three main Solus packages that will include many of the dependencies required that allow you to install most CRAN packages. These are `system.devel`, `curl-devel` and `fontconfig-devel`. -- `system.devel` can **ONLY** be installed from within terminal by running the command `sudo eopkg it -c system.devel` -- `curl-devel` can be found by searching in the **Software Center** or by running the command `sudo eopkg it curl-devel` +- `system.devel` is a component containing several packages and can **ONLY** be installed from within a terminal by running the command `sudo eopkg it -c system.devel` +- `curl-devel` and `fontconfig-devel` can be found by searching in the **Software Center** or by running the command `sudo eopkg it curl-devel fontconfig-devel` -Once these two Solus packages are installed `install.package()` will work as usual within R for most packages like `tidyverse`. +Once these two Solus packages are installed `install.packages()` will work as usual within R for most packages like `tidyverse`. -If when you try to install a CRAN library with `install.package()` from within R and you are presented with an error that says `...exited with non zero exit status` this is most likely because one of the required dependencies, _which will be listed within the R console detailing the error_, is contained within a Solus devel package you have not yet installed. - -#### Additional discovered dependencies - -This section should be edited to help future users to know what Solus devel packages are needed to install additional, more specialized CRAN packages. - -- To successfully run `install.package("RCurl")` within R requires `nghttp2-devel`, `libssh2-devel`, and `kerberos-devel` to be installed from the Solus **Software Center** +If you try to install a CRAN library with `install.packages()` from within R and you are presented with an error that says `...exited with non zero exit status` this is most likely because one of the required dependencies, _which will be listed within the R console detailing the error_, is contained within a Solus devel package you have not yet installed.