summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-24 12:43:02 -0300
committerGabriel Schneider <[email protected]>2026-10-24 13:11:11 -0300
commit1af098381515fbe3a4fe678cd023c7fd74418ae1 (patch)
tree34f8f1495ddbea9542d23af68db53f244a1ec4c5 /docs/typ/reference.typ
parent8ac6db5662dd2db0f082e1651835f1db36e235f8 (diff)
downloadpardes-1af098381515fbe3a4fe678cd023c7fd74418ae1.tar.gz
pardes-1af098381515fbe3a4fe678cd023c7fd74418ae1.zip
Search converge 5/6: the old search pipeline phased out, the notice-band / for texts, Find/Grep prompts and walks on the loop, +Recent, n/N as Look-the-next-row; docs, tutor, Help and goldens to the query pane
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ28
1 files changed, 18 insertions, 10 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index c14ad659..386b9f0f 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -909,7 +909,8 @@ at 200, ending in `…`. Control characters become spaces.
pane from the root).
- #file("/recent"): up to 200 files, PDFs and images, most recent first,
`open <path>` or `closed <path>`; kept in `$XDG_STATE_HOME/pardes/recent`.
- #word("Recent") shows them in a pane, an open one at its dot now and a
+ #word("Recent") lists them in a query pane (line 1 `Recent`, the rest
+ narrowing them by a fuzzy match), an open one at its dot now and a
closed one at its last (a PDF's is its page); a #word("Look") of a row reopens it
there.
- #file("/status"): `pid`, `version`, `panes`.
@@ -972,15 +973,22 @@ one a #file("exec") open still holds is never reused. In a command pane, #key("n
= Find and Grep <find-grep>
-#word("Find") matches file names, #word("Grep") the text of lines, both literally and
-ignoring ASCII case. #word("Grep") reads whole files and stops at 512
-hits, #word("Find") at 512 names. The walk stops at 20000 files or 100000 entries,
-16 deep, and passes over `.git`, `.jj`, `target`, `node_modules`,
-`.venv`, `__pycache__`, `.zig-cache` and `zig-out`. A cap hit, or a
-directory it could not open, is said at the end: `cut at 512 hits`, `walk cut at N entries`, `N
-directories skipped: permission denied`. A search that finds nothing and
-skipped nothing fails, `Grep: text not found`, and leaves the `+Search` as
-it was.
+Both fill the asking pane's query pane (#doc("guide", section: "search")),
+line 1 `Find name` or `Grep text`, and run on a worker thread, never on
+the loop that draws: `rg` when it is on `PATH` (`rg --files` and `rg --json
+--fixed-strings --smart-case`, so `.gitignore` is honoured and hidden files
+are passed over), else pardes's own walk, sorted, 16 deep, passing over
+dot-directories, `.git`, `.jj`, `target`, `node_modules`, `.venv`,
+`__pycache__`, `.zig-cache` and `zig-out`. #word("Find") lists the files once
+and matches their names fuzzily at each key (the best first, 200 shown);
+#word("Grep") matches the text of lines literally, any case unless the text
+has a capital, once the typing pauses (80 ms), and stops at 2000 lines:
+#word("More") (in the query pane's tag) goes on for 2000 more. A directory the
+walk could not open is said under the rows: `N directories skipped:
+permission denied`. A new query cancels the last; rows of a query no
+longer asked never land. Written to #file("exec") (a script) the search runs
+to its end before the write is answered, and one that finds nothing fails,
+`Grep: text not found`, `Find: name not found`, its query pane's count `0`.
= On screen <on-screen>