@@ -7,24 +7,24 @@ in `languages.toml` files.
77
88There are three possible locations for a `languages.toml` file:
99
10−1. In the Helix source code, this lives in the
10+1. In the Helix source code, which lives in the
1111 [Helix repository](https://github.com/helix-editor/helix/blob/master/languages.toml).
1212 It provides the default configurations for languages and language servers.
1313
14142. In your [configuration directory](./configuration.md). This overrides values
15− from the built-in language configuration. For example to disable
15+ from the built-in language configuration. For example, to disable
1616 auto-LSP-formatting in Rust:
1717
18−```toml
19−# in <config_dir>/helix/languages.toml
18+ ```toml
19+ # in <config_dir>/helix/languages.toml
2020
21−[language-server.mylang-lsp]
22−command = "mylang-lsp"
21+ [language-server.mylang-lsp]
22+ command = "mylang-lsp"
2323
24−[[language]]
25−name = "rust"
26−auto-format = false
27−```
24+ [[language]]
25+ name = "rust"
26+ auto-format = false
27+ ```
2828
29293. In a `.helix` folder in your project. Language configuration may also be
3030 overridden local to a project by creating a `languages.toml` file in a
@@ -128,7 +128,7 @@ These are the available options for a language server.
128128
129129A `format` sub-table within `config` can be used to pass extra formatting options to
130130[Document Formatting Requests](https://github.com/microsoft/language-server-protocol/blob/gh-pages/_specifications/specification-3-17.md#document-formatting-request--leftwards_arrow_with_hook).
131−For example with typescript:
131+For example, with typescript:
132132
133133```toml
134134[language-server.typescript-language-server]
@@ -147,8 +147,8 @@ Different languages can use the same language server instance, e.g. `typescript-
147147In case multiple language servers are specified in the `language-servers` attribute of a `language`,
148148it's often useful to only enable/disable certain language-server features for these language servers.
149149
150−For example `efm-lsp-prettier` of the previous example is used only with a formatting command `prettier`,
151−so everything else should be handled by the `typescript-language-server` (which is configured by default)
150+As an example, `efm-lsp-prettier` of the previous example is used only with a formatting command `prettier`,
151+so everything else should be handled by the `typescript-language-server` (which is configured by default).
152152The language configuration for typescript could look like this:
153153
154154```toml
@@ -166,10 +166,10 @@ language-servers = [ { name = "typescript-language-server", except-features = [
166166```
167167
168168Each requested LSP feature is prioritized in the order of the `language-servers` array.
169−For example the first `goto-definition` supported language server (in this case `typescript-language-server`) will be taken for the relevant LSP request (command `goto_definition`).
169+For example, the first `goto-definition` supported language server (in this case `typescript-language-server`) will be taken for the relevant LSP request (command `goto_definition`).
170170The features `diagnostics`, `code-action`, `completion`, `document-symbols` and `workspace-symbols` are an exception to that rule, as they are working for all language servers at the same time and are merged together, if enabled for the language.
171−If no `except-features` or `only-features` is given all features for the language server are enabled.
172−If a language server itself doesn't support a feature the next language server array entry will be tried (and so on).
171+If no `except-features` or `only-features` is given, all features for the language server are enabled.
172+If a language server itself doesn't support a feature, the next language server array entry will be tried (and so on).
173173
174174The list of supported features is:
175175