@@ -41,8 +41,6 @@ line.
4141
4242## Linux, macOS, Windows and OpenBSD packaging status
4343
44−Helix is available for Linux, macOS and Windows via the official repositories listed below.
45−
4644[](https://repology.org/project/helix/versions)
4745
4846## Linux
@@ -51,7 +49,7 @@ The following third party repositories are available:
5149
5250### Ubuntu
5351
54−Helix is available via [Maveonair's PPA](https://launchpad.net/~maveonair/+archive/ubuntu/helix-editor):
52+Add the `PPA` for Helix:
5553
5654```sh
5755sudo add-apt-repository ppa:maveonair/helix-editor
@@ -61,7 +59,7 @@ sudo apt install helix
6159
6260### Fedora/RHEL
6361
64−Helix is available via `copr`:
62+Enable the `COPR` repository for Helix:
6563
6664```sh
6765sudo dnf copr enable varlad/helix
@@ -92,8 +90,8 @@ If you are using a version of Nix without flakes enabled,
9290
9391### AppImage
9492
95−Install Helix using [AppImage](https://appimage.org/).
96−Download Helix AppImage from the [latest releases](https://github.com/helix-editor/helix/releases/latest) page.
93+Install Helix using the Linux [AppImage](https://appimage.org/) format.
94+Download the official Helix AppImage from the [latest releases](https://github.com/helix-editor/helix/releases/latest) page.
9795
9896```sh
9997chmod +x helix-*.AppImage # change permission for executable mode
@@ -143,33 +141,37 @@ pacman -S mingw-w64-ucrt-x86_64-helix
143141
144142## Building from source
145143
146−Clone the repository:
144+Requirements:
145+
146+- The [Rust toolchain](https://www.rust-lang.org/tools/install)
147+- The [Git version control system](https://git-scm.com/)
148+- A c++14 compatible compiler to build the tree-sitter grammars, for example GCC or Clang
149+
150+If you are using the `musl-libc` standard library instead of `glibc` the following environment variable must be set during the build to ensure tree-sitter grammars can be loaded correctly:
151+
152+```sh
153+RUSTFLAGS="-C target-feature=-crt-static"
154+```
155+
156+1. Clone the repository:
147157
148158```sh
149159git clone https://github.com/helix-editor/helix
150160cd helix
151161```
152162
153−Compile from source:
163+2. Compile from source:
154164
155165```sh
156166cargo install --path helix-term --locked
157167```
158168
159169This command will create the `hx` executable and construct the tree-sitter
160−grammars in the local `runtime` folder. To build the tree-sitter grammars requires
161−a c++ compiler to be installed, for example `gcc-c++`.
162−
163−> 💡 If you are using the musl-libc instead of glibc the following environment variable must be set during the build
164−> to ensure tree-sitter grammars can be loaded correctly:
165−>
166−> ```sh
167−> RUSTFLAGS="-C target-feature=-crt-static"
168−> ```
170+grammars in the local `runtime` folder.
169171
170172> 💡 Tree-sitter grammars can be fetched and compiled if not pre-packaged. Fetch
171−> grammars with `hx --grammar fetch` (requires `git`) and compile them with
172−> `hx --grammar build` (requires a C++ compiler). This will install them in
173+> grammars with `hx --grammar fetch` and compile them with
174+> `hx --grammar build`. This will install them in
173175> the `runtime` directory within the user's helix config directory (more
174176> [details below](#multiple-runtime-directories)).
175177