Skip to content

Commit

Permalink
rstudio: Use correct package installation command and Solus dependencies
Browse files Browse the repository at this point in the history
Remove additional dependencies that are already covered by `curl-devel`

Additional small fixes

Signed-off-by: Thomas Staudinger <[email protected]>
  • Loading branch information
Staudey committed Jun 7, 2024
1 parent 8d11c38 commit af5de1a
Showing 1 changed file with 13 additions and 19 deletions.
32 changes: 13 additions & 19 deletions docs/user/software/development/r-and-rstudio.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

Check warning on line 33 in docs/user/software/development/r-and-rstudio.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (fontconfig)

- `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`

Check warning on line 36 in docs/user/software/development/r-and-rstudio.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (fontconfig)

Check warning on line 36 in docs/user/software/development/r-and-rstudio.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (fontconfig)

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.

0 comments on commit af5de1a

Please sign in to comment.