summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-05 10:48:36 -0300
committerGabriel Schneider <[email protected]>2026-11-05 10:57:08 -0300
commitfc02325789b5a6622f9e577c9a45e65806c516b6 (patch)
tree65fdeed6959aef6afe0db5d18df3649aef0d2a34 /docs/typ
parent856bf4a8ed36cc6ec38dc9001f753a8838106da2 (diff)
downloadpardes-fc02325789b5a6622f9e577c9a45e65806c516b6.tar.gz
pardes-fc02325789b5a6622f9e577c9a45e65806c516b6.zip
Callstack a plain tree with a depth: CallstackLayout and CallstackCorners go with the inline layout and the square corners (each snippet below its location, the corners rounded, as both defaulted to), and the 100,000-row paging goes: a tree bigger than one answer holds stops there, its last row saying so as at the memory limit, and Callstack run in +Callstack asks nothing (only a file's pane asks a language server) where it showed the next page (lsp.callstack_more, the core's callstack_more, callstackMore and lspRequestAt, the walk's start and cut paths); CallstackDepth stays, as the reference documents it and the user's init sets it; treePrefix reads only the glyphs the tree draws, and the tests that fed it others take the drawn ones; callstack-inline.snap goes with its layout and callstack.snap snaps its style in its stead (its golden gains that section, the text byte-identical); the reference, the guide, the changelog's entry and both builtins lists say so
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/typ')
-rw-r--r--docs/typ/builtins-gui.json2
-rw-r--r--docs/typ/builtins-tui.json2
-rw-r--r--docs/typ/guide.typ21
-rw-r--r--docs/typ/reference.typ11
4 files changed, 11 insertions, 25 deletions
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index 8150509c..9a8b2ced 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -6,9 +6,7 @@
{"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."},
{"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."},
{"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."},
- {"name": "CallstackCorners", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "rounded, square", "doc": "Callstack tree corners: rounded (the default) or square; bare, it switches styles. Applies to the next Callstack query."},
{"name": "CallstackDepth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Caller levels collected by Callstack, 1 through 64; default 8. Bare, it says the current limit."},
- {"name": "CallstackLayout", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "inline, stacked", "doc": "Callstack snippets below their locations (stacked, the default) or beside them (inline); bare, it switches layouts. Applies to the next Callstack query."},
{"name": "Changelog", "leader": "SPC h c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build's version and what changed to reach it, printed into an output buffer the same way Config prints the live settings."},
{"name": "ChipShadow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a notice chip casts a cell's shadow right and down, on or off."},
{"name": "ClipPaste", "leader": "SPC p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard after the selection."},
diff --git a/docs/typ/builtins-tui.json b/docs/typ/builtins-tui.json
index 5ce8aa64..f5fe199c 100644
--- a/docs/typ/builtins-tui.json
+++ b/docs/typ/builtins-tui.json
@@ -5,9 +5,7 @@
{"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."},
{"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."},
{"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."},
- {"name": "CallstackCorners", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "rounded, square", "doc": "Callstack tree corners: rounded (the default) or square; bare, it switches styles. Applies to the next Callstack query."},
{"name": "CallstackDepth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Caller levels collected by Callstack, 1 through 64; default 8. Bare, it says the current limit."},
- {"name": "CallstackLayout", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "inline, stacked", "doc": "Callstack snippets below their locations (stacked, the default) or beside them (inline); bare, it switches layouts. Applies to the next Callstack query."},
{"name": "Changelog", "leader": "SPC h c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build's version and what changed to reach it, printed into an output buffer the same way Config prints the live settings."},
{"name": "ChipShadow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a notice chip casts a cell's shadow right and down, on or off."},
{"name": "ClipPaste", "leader": "SPC p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard after the selection."},
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index df8c79ce..29535c39 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -285,23 +285,16 @@ hierarchy deeper than the limit invites continuing from another function.
Every caller is listed: the walk runs as long as the server keeps answering,
says how many callers it has found on the message row once it takes more
than a second, and shows what it found if the server stops answering.
-Asking anything else stops it. A tree too big for one page (about 100,000
-rows, the memory one query may use) ends in a row saying so: running
-#word("Callstack") in `+Callstack` shows the next page, from where this
-one stopped, with that caller's own callers above it again.
+Asking anything else stops it. A tree bigger than one answer holds (about
+100,000 rows, the memory one query may use) stops there, its last row
+saying so: run #word("Callstack") on a function above to go on.
At each level, callers whose function or file name contains "test" come
-after the rest.
+after the rest. Each signature and call snippet sits below its location,
+aligned with the location text.
#word("CallstackDepth") reports the current caller depth;
`CallstackDepth 16` changes it for subsequent queries. The default is 8
-levels, and the accepted range is 1–64.
-
-`CallstackLayout stacked` (the default) puts each signature and call snippet below its
-location, aligned with the location text; `CallstackLayout inline` puts it
-beside the location again. A bare #word("CallstackLayout") switches modes.
-`CallstackCorners rounded` (the default) uses rounded tree guides;
-`CallstackCorners square` restores sharp corners. Bare #word("CallstackCorners")
-switches styles. Layout and corner changes apply to the next query. These settings are retained
-by #word("Dump") / #word("Restore").
+levels, the accepted range is 1–64, and #word("Dump") / #word("Restore")
+keep it.
= `pardes FILE` and `--wait` <editor>
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index e0d230d7..d3210814 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -266,15 +266,12 @@ A line written to #file("exec") is #word("Exec"):
language still holds the old name, a row per such file (zls renaming at
a declaration; from a use it reaches every file);
#word("Callstack") (#key("g c") or #key("SPC l b")) opens and focuses `+Callstack`,
- with static caller ancestry, tree-sitter signatures and Look locations
- for callers and call sites, test callers after the rest at each level; run
- in `+Callstack` itself, it shows the next page of a tree too big for one.
+ a tree of static caller ancestry: tree-sitter signatures and Look locations
+ for callers and call sites, each snippet below its location, test callers
+ after the rest at each level, and a tree bigger than one answer holds cut
+ there, its last row saying so.
#word("CallstackDepth") reports or sets the
runtime depth (1–64, default 8) for subsequent queries.
- `CallstackLayout stacked` (the default) aligns snippets below their locations;
- `CallstackLayout inline` places the snippets beside them.
- `CallstackCorners rounded` (the default) or `CallstackCorners square`
- selects the tree corner style for the next query; bare, it switches styles.
#word("Callers") and #word("Callees") keep their short
lists and single-result jumps.
#word("Diagnostics") and #word("Symbols") list the file's in `+Search`;