summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-25 10:27:05 -0300
committerGabriel Schneider <[email protected]>2026-10-25 11:58:11 -0300
commitbfdc8a9e61dd20c91b68f62187e724d1a98445a4 (patch)
treea020fcbdc9ca8be68aa8983837accc2328f0e742 /docs
parent8bcaa657b39f24f0f2457f5c28e7095d5113ba73 (diff)
downloadpardes-bfdc8a9e61dd20c91b68f62187e724d1a98445a4.tar.gz
pardes-bfdc8a9e61dd20c91b68f62187e724d1a98445a4.zip
query: a language server's list is answered, not typed: one place lands on it (Diagnostics too now), the place fed as the text's places so it is tinted and n/N have it, no query pane; several open the list with the keyboard on its current row in normal mode (showCurrent: the caret on the rows is the current row, n/N take it there), its target shown, Esc in it back to the text as it was; none is a message; line 1 keeps its word as text; Diagnostics keep the keyboard in the text for ]d; lsp-client and lsprelpath step with n, their goldens the caret on the row and no insert marker
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016u3hBPFfja5pK4EBRC1UVD
Diffstat (limited to 'docs')
-rw-r--r--docs/search-proto-converge.md12
-rw-r--r--docs/typ/guide.typ2
2 files changed, 13 insertions, 1 deletions
diff --git a/docs/search-proto-converge.md b/docs/search-proto-converge.md
index 4c7b7006..af9068a0 100644
--- a/docs/search-proto-converge.md
+++ b/docs/search-proto-converge.md
@@ -56,6 +56,18 @@ end without a word; with no places (or after an `s` changed the register)
they are helix's register search as before. `]d` / `[d` step the
diagnostics' places once a Diagnostics query fed them.
+**A language server's list is answered, not typed.** `gd`, `gr`, `gi`
+and `SPC l d` ask; the answer decides: one place is a jump (the keyboard
+on it, the place that text's places, so it is tinted and n/N have it; no
+query pane); several open the query pane with its rows there and the
+keyboard in its normal mode on the current row (the first after where it
+was asked), its target shown, so j/k/n/N step, Enter lands and Esc goes
+back to the text as it was; none is a message. Line 1 reads `Refs` as text
+(B2 asks again; editing it to `/x` works), but no language key puts the
+keyboard there in insert mode. Diagnostics keep the keyboard in the text
+so `]d`/`[d` step their places. `Symbols` (`SPC s s`) is fuzzy, typed
+into: a query.
+
**The current row shows its target**, the keyboard staying on line 1: a
place in an open pane's text is selected there and scrolled into view
(remembered for Esc); a file an open pane shows, its line there; any other
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index d479a884..4b783c64 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -193,7 +193,7 @@ Line 1's first word names what it searches, and editing the word changes it:
[`Panes name`], [the open panes, then the ones closed this session, `(closed)` and dimmer: #key("Enter") (or a #word("Look") at its `@pN`) brings one back where it was, its text with it (#key("SPC b b"), #word("Panes"))],
[`Symbols name`], [the text's declarations (#key("SPC s s"))],
[`All pat`], [every open pane's text, its rows under each pane (#key("SPC /"))],
- [`Refs`, `Def`, `Impl`, `Diagnostics`], [the language server's lists; their places in the text tinted as a `/`'s are, `]d` stepping the diagnostics],
+ [`Refs`, `Def`, `Impl`, `Diagnostics`], [the language server's lists (#key("gr"), #key("gd"), #key("gi"), #key("SPC l d")): one answer is a jump, none a message; several open the list with the keyboard on its current row in normal mode (#keys("j", "k", "n", "N") step it, #key("Enter") lands, #key("Esc") goes back), the diagnostics' keeping it in the text for `]d`; their places in the text tinted as a `/`'s are],
)
A row in a file no pane shows is shown in a `+Preview` under the query