summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew Gallant <jamslam@gmail.com>2018-02-18 10:31:12 -0500
committerAndrew Gallant <jamslam@gmail.com>2018-02-18 10:32:53 -0500
commitd6748a34457c3bd2eca8f9a731303cfadf8a292a (patch)
treebb4adabeb5c1d6e6e1d5d0f4a979cd5f2d8b1fd7
parent9b7f420faa7fbf21db07afbdeadb0828f6752d2f (diff)
doc: add .deb installation instructions
Generating a Debian binary package was pretty easy using `cargo deb`, so it is now part of the release. This commit updates the README's installation methods to reference it. I did look into setting up a PPA for Ubuntu, but my eyes glazed over while reading the documentation. Providing a binary Debian package is likely a faux pas, but it is extraordinarily convenient.
-rw-r--r--README.md16
1 files changed, 13 insertions, 3 deletions
diff --git a/README.md b/README.md
index 047ca06c..5956af9c 100644
--- a/README.md
+++ b/README.md
@@ -172,8 +172,8 @@ The binary name for ripgrep is `rg`.
**[Archives of precompiled binaries for ripgrep are available for Windows,
macOS and Linux.](https://github.com/BurntSushi/ripgrep/releases)** Users of
-platforms not explicitly mentioned below (such as Debian) are advised
-to download one of these archives.
+platforms not explicitly mentioned below are advised to download one of these
+archives.
Linux binaries are static executables. Windows binaries are available either as
built with MinGW (GNU) or with Microsoft Visual C++ (MSVC). When possible,
@@ -243,13 +243,23 @@ $ nix-env --install ripgrep
$ # (Or using the attribute name, which is also ripgrep.)
```
+If you're a **Debian** or an **Ubuntu** user, then ripgrep can be installed
+using a binary `.deb` file provided in each
+[ripgrep release](https://github.com/BurntSushi/ripgrep/releases). Note that
+ripgrep is not in the official Debian or Ubuntu repositories.
+
+```
+$ curl -LO https://github.com/BurntSushi/ripgrep/releases/download/0.8.0/ripgrep_0.8.0_amd64.deb
+$ sudo dpkg -i ripgrep-0.8.0_amd64.deb
+```
+
If you're an **Ubuntu** user, ripgrep can be installed from the `snap` store.
* Note that if you are using `16.04 LTS` or later, snap is already installed.
* For older versions you can install snap using
[this guide](https://docs.snapcraft.io/core/install-ubuntu).
```
-sudo snap install rg
+$ sudo snap install rg
```
If you're a **Rust programmer**, ripgrep can be installed with `cargo`.