summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-25 11:40:05 -0300
committerGabriel Schneider <[email protected]>2026-10-25 12:24:05 -0300
commit685b4050bb0caaa95c4c6a209e69f7777469e9fc (patch)
treeb1c34301f9f1febd5e70dfdfee52425cdca0ef4a /docs/typ
parent29d753b420385d7ca214250909e3a33c85cfab8d (diff)
downloadpardes-685b4050bb0caaa95c4c6a209e69f7777469e9fc.tar.gz
pardes-685b4050bb0caaa95c4c6a209e69f7777469e9fc.zip
query: a row is its place as text, `path:line:col` then its code, the path the shortest a Look from the query pane resolves (Query.lookPath: relative, `../` included, when shorter, else absolute, never `@pN` but for a text with no file), aligned per group, the declaration headers `path:line`; its code coloured as its file's language colours it, the file painted whole on the worker (Stream.paintRows, highlightApart, kept in the locations cache, Query.Shades a walk a refill, Query.recolor in place as each lands) with the match tinted over it; the +Preview's places are the query's hits in its file (a Grep searched, a list fed), tinted and ticked, the row's one current and selected, as in a pane that already shows it; tests for B3 on an address, a saved list's Looks, the shortest path, the preview's places and colours, the worker's colours; fsearch, grep, lookrange, lsp-client, lsprelpath (now `../shade.zig`), stepgrain, tagbottom goldens: the address rows; docs/next-searchrows.md: the design and the numbers
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016u3hBPFfja5pK4EBRC1UVD
Diffstat (limited to 'docs/typ')
-rw-r--r--docs/typ/guide.typ9
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 61ba5455..58e5d907 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -175,7 +175,7 @@ is born #word("SearchRows") rows tall and never resizes itself; nothing
found is a count of `0` in its tag, not an exit.
#pairs(
- [#key("/") `vw`], [every match in the text tinted and ticked on its scroll rail, the first after the cursor selected; the rows under line 1 are the lines holding it, a line number in the gutter, each under the declaration it is in],
+ [#key("/") `vw`], [every match in the text tinted and ticked on its scroll rail, the first after the cursor selected; the rows under line 1 are the lines holding it, each its place as text first (`file:line:col`, the shortest path a #word("Look") from the pane resolves), then the line coloured as the file is, under the declaration it is in],
[#keys("Ctrl-n", "Ctrl-p")], [the next or previous match, typing; the text follows it],
[#key("Enter")], [the keyboard on the match, the pattern in `/`, the rows kept as text (#word("Save") keeps them as a file)],
[#keys("n", "N")], [the next or previous match in the text, round the end without a word],
@@ -202,8 +202,11 @@ 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,
+The preview colours the file as its own pane does, and the query's hits
+in it are its places, tinted and ticked, the current one selected.
+#btn("B3") on a row's place goes there, as on any address; the rows kept
+as text (#word("Save")) are a list of places that still work.
+#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;
#word("SearchPlace") `column`: in a finder column at the right). A PDF's
and a terminal's #key("/") still ask on the message row and list a