mirror of
https://github.com/helix-editor/helix.git
synced 2024-12-18 22:11:55 +04:00
docs: Eliminate improper use of "LSP" term
Sometimes we used "LSP" to mean "language server". This change eliminates the improper "LSP" usage. Ref https://github.com/helix-editor/helix/pull/12183#discussion_r1868436105
This commit is contained in:
parent
fa68bac391
commit
085c4fe4c8
@ -151,7 +151,7 @@ ### `[editor.lsp]` Section
|
|||||||
|
|
||||||
[^1]: By default, a progress spinner is shown in the statusline beside the file path.
|
[^1]: By default, a progress spinner is shown in the statusline beside the file path.
|
||||||
|
|
||||||
[^2]: You may also have to activate them in the LSP config for them to appear, not just in Helix. Inlay hints in Helix are still being improved on and may be a little bit laggy/janky under some circumstances. Please report any bugs you see so we can fix them!
|
[^2]: You may also have to activate them in the language server config for them to appear, not just in Helix. Inlay hints in Helix are still being improved on and may be a little bit laggy/janky under some circumstances. Please report any bugs you see so we can fix them!
|
||||||
|
|
||||||
### `[editor.cursor-shape]` Section
|
### `[editor.cursor-shape]` Section
|
||||||
|
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
| Language | Syntax Highlighting | Treesitter Textobjects | Auto Indent | Default LSP |
|
| Language | Syntax Highlighting | Treesitter Textobjects | Auto Indent | Default language servers |
|
||||||
| --- | --- | --- | --- | --- |
|
| --- | --- | --- | --- | --- |
|
||||||
| ada | ✓ | ✓ | | `ada_language_server` |
|
| ada | ✓ | ✓ | | `ada_language_server` |
|
||||||
| adl | ✓ | ✓ | ✓ | |
|
| adl | ✓ | ✓ | ✓ | |
|
||||||
|
@ -16,7 +16,7 @@
|
|||||||
| `:write-buffer-close`, `:wbc` | Write changes to disk and closes the buffer. Accepts an optional path (:write-buffer-close some/path.txt) |
|
| `:write-buffer-close`, `:wbc` | Write changes to disk and closes the buffer. Accepts an optional path (:write-buffer-close some/path.txt) |
|
||||||
| `:write-buffer-close!`, `:wbc!` | Force write changes to disk creating necessary subdirectories and closes the buffer. Accepts an optional path (:write-buffer-close! some/path.txt) |
|
| `:write-buffer-close!`, `:wbc!` | Force write changes to disk creating necessary subdirectories and closes the buffer. Accepts an optional path (:write-buffer-close! some/path.txt) |
|
||||||
| `:new`, `:n` | Create a new scratch buffer. |
|
| `:new`, `:n` | Create a new scratch buffer. |
|
||||||
| `:format`, `:fmt` | Format the file using the LSP formatter. |
|
| `:format`, `:fmt` | Format the file using an external formatter or language server. |
|
||||||
| `:indent-style` | Set the indentation style for editing. ('t' for tabs or 1-16 for number of spaces.) |
|
| `:indent-style` | Set the indentation style for editing. ('t' for tabs or 1-16 for number of spaces.) |
|
||||||
| `:line-ending` | Set the document's default line ending. Options: crlf, lf. |
|
| `:line-ending` | Set the document's default line ending. Options: crlf, lf. |
|
||||||
| `:earlier`, `:ear` | Jump back to an earlier point in edit history. Accepts a number of steps or a time span. |
|
| `:earlier`, `:ear` | Jump back to an earlier point in edit history. Accepts a number of steps or a time span. |
|
||||||
|
@ -13,7 +13,7 @@ ## `languages.toml` files
|
|||||||
|
|
||||||
2. In your [configuration directory](./configuration.md). This overrides values
|
2. In your [configuration directory](./configuration.md). This overrides values
|
||||||
from the built-in language configuration. For example, to disable
|
from the built-in language configuration. For example, to disable
|
||||||
auto-LSP-formatting in Rust:
|
auto-formatting for Rust:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# in <config_dir>/helix/languages.toml
|
# in <config_dir>/helix/languages.toml
|
||||||
@ -128,7 +128,7 @@ ## Language Server configuration
|
|||||||
| ---- | ----------- |
|
| ---- | ----------- |
|
||||||
| `command` | The name or path of the language server binary to execute. Binaries must be in `$PATH` |
|
| `command` | The name or path of the language server binary to execute. Binaries must be in `$PATH` |
|
||||||
| `args` | A list of arguments to pass to the language server binary |
|
| `args` | A list of arguments to pass to the language server binary |
|
||||||
| `config` | LSP initialization options |
|
| `config` | Language server initialization options |
|
||||||
| `timeout` | The maximum time a request to the language server may take, in seconds. Defaults to `20` |
|
| `timeout` | The maximum time a request to the language server may take, in seconds. Defaults to `20` |
|
||||||
| `environment` | Any environment variables that will be used when starting the language server `{ "KEY1" = "Value1", "KEY2" = "Value2" }` |
|
| `environment` | Any environment variables that will be used when starting the language server `{ "KEY1" = "Value1", "KEY2" = "Value2" }` |
|
||||||
| `required-root-patterns` | A list of `glob` patterns to look for in the working directory. The language server is started if at least one of them is found. |
|
| `required-root-patterns` | A list of `glob` patterns to look for in the working directory. The language server is started if at least one of them is found. |
|
||||||
|
@ -4,7 +4,7 @@ ## Using pickers
|
|||||||
|
|
||||||
### Filtering Picker Results
|
### Filtering Picker Results
|
||||||
|
|
||||||
Most pickers perform fuzzy matching using [fzf syntax](https://github.com/junegunn/fzf?tab=readme-ov-file#search-syntax). Two exceptions are the global search picker, which uses regex, and the workspace symbol picker, which passes search terms to the LSP. Note that OR operations (`|`) are not currently supported.
|
Most pickers perform fuzzy matching using [fzf syntax](https://github.com/junegunn/fzf?tab=readme-ov-file#search-syntax). Two exceptions are the global search picker, which uses regex, and the workspace symbol picker, which passes search terms to the language server. Note that OR operations (`|`) are not currently supported.
|
||||||
|
|
||||||
If a picker shows multiple columns, you may apply the filter to a specific column by prefixing the column name with `%`. Column names can be shortened to any prefix, so `%p`, `%pa` or `%pat` all mean the same as `%path`. For example, a query of `helix %p .toml !lang` in the global search picker searches for the term "helix" within files with paths ending in ".toml" but not including "lang".
|
If a picker shows multiple columns, you may apply the filter to a specific column by prefixing the column name with `%`. Column names can be shortened to any prefix, so `%p`, `%pa` or `%pat` all mean the same as `%path`. For example, a query of `helix %p .toml !lang` in the global search picker searches for the term "helix" within files with paths ending in ".toml" but not including "lang".
|
||||||
|
|
||||||
|
@ -309,8 +309,8 @@ #### Interface
|
|||||||
| `ui.virtual.whitespace` | Visible whitespace characters |
|
| `ui.virtual.whitespace` | Visible whitespace characters |
|
||||||
| `ui.virtual.indent-guide` | Vertical indent width guides |
|
| `ui.virtual.indent-guide` | Vertical indent width guides |
|
||||||
| `ui.virtual.inlay-hint` | Default style for inlay hints of all kinds |
|
| `ui.virtual.inlay-hint` | Default style for inlay hints of all kinds |
|
||||||
| `ui.virtual.inlay-hint.parameter` | Style for inlay hints of kind `parameter` (LSPs are not required to set a kind) |
|
| `ui.virtual.inlay-hint.parameter` | Style for inlay hints of kind `parameter` (language servers are not required to set a kind) |
|
||||||
| `ui.virtual.inlay-hint.type` | Style for inlay hints of kind `type` (LSPs are not required to set a kind) |
|
| `ui.virtual.inlay-hint.type` | Style for inlay hints of kind `type` (language servers are not required to set a kind) |
|
||||||
| `ui.virtual.wrap` | Soft-wrap indicator (see the [`editor.soft-wrap` config][editor-section]) |
|
| `ui.virtual.wrap` | Soft-wrap indicator (see the [`editor.soft-wrap` config][editor-section]) |
|
||||||
| `ui.virtual.jump-label` | Style for virtual jump labels |
|
| `ui.virtual.jump-label` | Style for virtual jump labels |
|
||||||
| `ui.menu` | Code and command completion menus |
|
| `ui.menu` | Code and command completion menus |
|
||||||
|
@ -2636,7 +2636,7 @@ fn read(cx: &mut compositor::Context, args: &[Cow<str>], event: PromptEvent) ->
|
|||||||
TypableCommand {
|
TypableCommand {
|
||||||
name: "format",
|
name: "format",
|
||||||
aliases: &["fmt"],
|
aliases: &["fmt"],
|
||||||
doc: "Format the file using the LSP formatter.",
|
doc: "Format the file using an external formatter or language server.",
|
||||||
fun: format,
|
fun: format,
|
||||||
signature: CommandSignature::none(),
|
signature: CommandSignature::none(),
|
||||||
},
|
},
|
||||||
|
@ -154,7 +154,7 @@ pub fn languages_all() -> std::io::Result<()> {
|
|||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
let mut headings = vec!["Language", "LSP", "DAP", "Formatter"];
|
let mut headings = vec!["Language", "Language servers", "Debug adapter", "Formatter"];
|
||||||
|
|
||||||
for feat in TsFeature::all() {
|
for feat in TsFeature::all() {
|
||||||
headings.push(feat.short_title())
|
headings.push(feat.short_title())
|
||||||
|
@ -59,7 +59,7 @@ pub fn lang_features() -> Result<String, DynError> {
|
|||||||
.map(|t| t.long_title().to_string())
|
.map(|t| t.long_title().to_string())
|
||||||
.collect::<Vec<_>>(),
|
.collect::<Vec<_>>(),
|
||||||
);
|
);
|
||||||
cols.push("Default LSP".to_owned());
|
cols.push("Default language servers".to_owned());
|
||||||
|
|
||||||
md.push_str(&md_table_heading(&cols));
|
md.push_str(&md_table_heading(&cols));
|
||||||
let config = helpers::lang_config();
|
let config = helpers::lang_config();
|
||||||
|
Loading…
Reference in New Issue
Block a user