diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2020-11-26 01:34:22 -0700 |
|---|---|---|
| committer | Sarah White <graphitefriction@gmail.com> | 2020-12-08 14:32:53 -0700 |
| commit | ddf574ba80c64d0c77dcd1f533aca874710907b4 (patch) | |
| tree | fc65fe0020abaa5ae88775edf3c7049511d87400 /docs/modules/install | |
| parent | 4d22dd41573291c1ab0a4a9bcb2602f3720ba62f (diff) | |
add additional explicit IDs to content
Diffstat (limited to 'docs/modules/install')
| -rw-r--r-- | docs/modules/install/pages/linux-packaging.adoc | 5 | ||||
| -rw-r--r-- | docs/modules/install/pages/ruby-packaging.adoc | 3 |
2 files changed, 7 insertions, 1 deletions
diff --git a/docs/modules/install/pages/linux-packaging.adoc b/docs/modules/install/pages/linux-packaging.adoc index 5df8c1f0..940fecf3 100644 --- a/docs/modules/install/pages/linux-packaging.adoc +++ b/docs/modules/install/pages/linux-packaging.adoc @@ -40,6 +40,7 @@ To install the package, open a terminal and type: include::partial$success.adoc[] +[#apk] == apk (Alpine Linux) To install the gem on Alpine Linux, open a terminal and type: @@ -48,6 +49,7 @@ To install the gem on Alpine Linux, open a terminal and type: include::partial$success.adoc[] +[#pacman] == pacman (Arch Linux) To install the gem on Arch-based distributions, open a terminal and type: @@ -65,18 +67,21 @@ If you need to upgrade to the latest version immediately, use xref:ruby-packagin TIP: Your Linux system may be configured to automatically update packages, in which case the latest Asciidoctor package will be installed as soon as it becomes available. No further action is required by you. +[#upgrade-apt] === APT On Debian and Debian-based distributions, update the Asciidoctor package using: $ sudo apt-get upgrade -y asciidoctor +[#upgrade-dnf] === DNF On Fedora and other RPM-based distributions, you can update the package using: $ sudo dnf update -y asciidoctor +[#upgrade-apk] === apk (Alpine Linux) On Alpine Linux, update the Asciidoctor package using: diff --git a/docs/modules/install/pages/ruby-packaging.adoc b/docs/modules/install/pages/ruby-packaging.adoc index ea9e0994..a07cfe16 100644 --- a/docs/modules/install/pages/ruby-packaging.adoc +++ b/docs/modules/install/pages/ruby-packaging.adoc @@ -41,13 +41,14 @@ gem 'asciidoctor' To upgrade the gem, specify the new version in the Gemfile and run `bundle` again. Using `bundle update` (without specifying a gem) is *not* recommended as it will also update other gems, which may not be the desired result. +[#gem-update] == Upgrade using gem update [CAUTION] ==== You're advised against using the `gem update` command to update a gem managed by the package manager. Doing so puts the system into an inconsistent state as the package manager can no longer track the files (which get installed under [.path]_/usr/local_). -Simply put, system gems should only be managed by the package manager. +Simply put, system gems should only be updated by the package manager. If you want to use a version of Asciidoctor that is newer than what is installed by the package manager, you should use {url-rvm}[RVM^] to install Ruby in your home directory (i.e., user space). Then, you can safely use the `gem` command to install or update the Asciidoctor gem. |