summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-25 10:46:46 -0300
committerGabriel Schneider <[email protected]>2026-10-25 11:58:11 -0300
commitb8646ef838e4f33f1f3adbf3c08c251afc39ae73 (patch)
tree09a044c9c9792d37706bfb510b4de369b4f7b150 /docs
parentbfdc8a9e61dd20c91b68f62187e724d1a98445a4 (diff)
downloadpardes-b8646ef838e4f33f1f3adbf3c08c251afc39ae73.tar.gz
pardes-b8646ef838e4f33f1f3adbf3c08c251afc39ae73.zip
query: B1 on a query pane is acme's B1: it places the caret and selects, nothing else (no other pane moves, nothing is previewed, the current row stays); only the keyboard moves the current row: Ctrl-n/Ctrl-p typing, n/N in the pane's normal mode (the caret with them, caretTo), j/k taking the caret onto a row (produce follows the caret on a key step only); Enter lands the current row; the current row's line mark is no selection B2/B3 borrow (exec.operandAt), so a click on it takes the word as on any row
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.md17
-rw-r--r--docs/typ/guide.typ7
2 files changed, 19 insertions, 5 deletions
diff --git a/docs/search-proto-converge.md b/docs/search-proto-converge.md
index af9068a0..2e992e3c 100644
--- a/docs/search-proto-converge.md
+++ b/docs/search-proto-converge.md
@@ -50,8 +50,9 @@ own, and its rows are read-only while live (queryline's clampEdit).
**Keys** on line 1, typing: Ctrl-n / Ctrl-p (and Down / Up, `config.query_next`
/ `query_prev`) step the current row; Enter lands; Esc cancels. Tab stays the
-exec chord. In the pane's normal mode (live or frozen): n / N step its rows,
-Enter on a row lands on it. In the owner: n / N step its places, round the
+exec chord. In the pane's normal mode (live or frozen): n / N step its rows
+(the caret with them when it is on them), j / k onto a row make it current,
+Enter lands the current row. In the owner: n / N step its places, round the
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.
@@ -71,7 +72,17 @@ 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
-file in the +Preview. Never the pointer.
+file in the +Preview. Only the keyboard moves it: Ctrl-n / Ctrl-p on line
+1, n / N in the pane's normal mode, and j / k taking the caret onto a row
+(a helix picker's preview follows its selection the same way). The mouse
+never does: B1 (a click, a sweep, the chords) places the caret and selects
+as in any pane, no other pane moves, nothing is previewed; B3 on a row's
+address is a Look as anywhere, on its code a word Look; B2 on line 1 runs
+it again. Enter lands the current row, which is the caret's once j / k put
+it there, never a row B1 only clicked; Callstack has no current row apart
+from its caret, so the two agree except after a click. The current row's
+line mark is no selection: B2 / B3 on it take the word clicked, as on any
+row.
**Enter** puts the keyboard on the current hit in its pane (the +Preview
promoted in place: same slot, serial, rect, an unattached file pane from
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 4b783c64..40fc7af9 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -197,8 +197,11 @@ Line 1's first word names what it searches, and editing the word changes it:
)
A row in a file no pane shows is shown in a `+Preview` under the query
-pane, following #keys("Ctrl-n", "Ctrl-p") and #btn("B1"), never the
-pointer; #key("Enter") makes the preview that file's pane where it stands.
+pane. The current row follows the keyboard only (#keys("Ctrl-n", "Ctrl-p")
+typing, #keys("n", "N") and #keys("j", "k") in the pane's normal mode);
+#btn("B1") on the rows places the caret and selects, as in any pane, and
+moves nothing else. #key("Enter") lands the current row, making the
+preview that file's pane where it stands.
#btn("B3") on a row's line number looks at the row; #btn("B2") on line 1
runs it again. The next search from the same pane reuses its query pane,
its kept rows back on #key("Esc") (#word("SearchPane") `new`: a pane each;