summaryrefslogtreecommitdiff
path: root/docs/search-proto-converge.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/search-proto-converge.md')
-rw-r--r--docs/search-proto-converge.md48
1 files changed, 38 insertions, 10 deletions
diff --git a/docs/search-proto-converge.md b/docs/search-proto-converge.md
index 99adbc2c..7a3e361a 100644
--- a/docs/search-proto-converge.md
+++ b/docs/search-proto-converge.md
@@ -40,13 +40,40 @@ only the prompts that are not search.
`Search <line 1>` is the builtin under the three argument paths
(`config.leader_args`, pick's table).
-**Rows look like Callstack's**: a gutter line number, the hit's line with
-the match tinted (every match on a line tinted, one row a line), under the
-declaration it is in (once a parse exists, see below), under the file
-(Grep, the LSP lists), under `@pN name (count)` in serial order (All).
-B3 on a row's line number looks at its address; B3 on its code is a word
-Look as anywhere; B2 on line 1 runs it again. The pane has no gutter of its
-own, and its rows are read-only while live (queryline's clampEdit).
+**Rows look like Callstack's**: each row's place first, as text,
+`path:line:col`, the path the shortest a Look from the query pane
+resolves (relative to its directory, `../` included, when that is shorter,
+else absolute; `Query.lookPath`), never an `@pN` but for a text with no
+file, padded so a group's code starts in one column, then
+the hit's line coloured as its file's language colours it, the match
+tinted over that (every match on a line tinted, one row a line); under the
+declaration it is in (once a parse exists, see below; the header has its
+`path:line` too), under the file (Grep, the LSP lists), under `@pN name
+(count)` in serial order (All). B3 on the address is a Look as anywhere, a
+sweep copies it, and a frozen pane saved is a list of addresses that still
+work; B3 on its code is a word Look; B2 on line 1 runs it again. The pane
+has no gutter of its own, and its rows are read-only while live
+(queryline's clampEdit). The address is on every row, `/`'s included:
+a bare `:12:5` would be looked up in the +Search itself (a Look resolves
+against the pane it is in), and a saved list would lose its file.
+
+The rows' colours are their files' whole (`Stream.paintRows`): a file is
+painted once on the worker (`syntax.highlightApart`, the text of the pane
+that shows it, else read there from disk), kept in the locations cache
+beside Callstack's, and each row takes its line's slice when the line
+still reads as the row does (`Query.Shades`, one walk down each file a
+refill). Until then the rows are plain; when a file lands, every query
+pane's plain rows from it are coloured in place (`Query.recolor`), which
+asks for the next file, one at a time. Without workers (tests) the rows
+stay plain.
+
+**The +Preview is the file as its own pane shows it**: its colours are
+the file's (`colorAlgo` `.source`, painted ahead as any pane), and the
+query's hits in it are its places (a Grep's searched there as in an open
+pane, a list's fed from its rows), tinted and ticked, the current row's
+one current and selected, centred with its neighbours round it. A pane
+that already shows the file gets the same: its places, the row's one
+selected.
**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
@@ -197,9 +224,10 @@ of 100 (the Debug SafeAllocator's stack capture per allocation was 30% at
- LookNext / LookPrev do not step query rows (their addresses are in row
metadata, not text).
-- Grep rows carry no syntax colours; `/` rows are coloured where the
- owner's highlights cover them (zeros elsewhere, so no fragment parse per
- refill).
+- Rows of a file bigger than 4 MB, of markdown and typst (their
+ injections share parsers, so no worker paints them) stay plain; a disk
+ file changed after it was painted keeps plain rows for its changed
+ lines until the next Grep.
- Rail ticks are not carried over the detached wire (a detached frontend
shows tints, not ticks).
- In a window too short for the group (4 rows), only the query pane's tag