summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-06 19:06:32 -0300
committerGabriel Schneider <[email protected]>2026-10-22 10:03:15 -0300
commit046979b877f02a91cf52cc86b84c5619cb9363d3 (patch)
treeb0a4696329949029aef88be34e242a45b1babfc4 /docs/typ/guide.typ
parentd65ec3394ff619118d9208718477469c673a5598 (diff)
downloadpardes-046979b877f02a91cf52cc86b84c5619cb9363d3.tar.gz
pardes-046979b877f02a91cf52cc86b84c5619cb9363d3.zip
Def and Refs in a language-served file's tag, a diff viewer's tinted word edits, context rows that hold still under a scroll, and the pardes skill
Def and Refs (gd, gr, Ctrl-click; chorded 2-1 at the selection) for a file a language server speaks for; hunks.zig stacks a unified diff as a diff viewer does, its changed words on a tinted ground as delta's do; the tree-sitter context rows stay put while the body glides under a scroll; .agents/skills gains the pardes skill beside pardes-9p.
Diffstat (limited to 'docs/typ/guide.typ')
-rw-r--r--docs/typ/guide.typ15
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 90e72303..89323766 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -202,8 +202,8 @@ takes the rows: #key("k") above, #key("j") below.
= Reviewing diffs <reviewing-diffs>
-`git diff` run as a command, or a `.diff` or `.patch` opened, is drawn as
-a diff, each hunk in its file's language. #btn("B3") on:
+`git diff` run as a command, or a `.diff` or `.patch` shown as text (below),
+is drawn as a diff, each hunk in its file's language. #btn("B3") on:
#pairs(
[`diff --git`, `---`, `+++`], [the file],
@@ -211,6 +211,17 @@ a diff, each hunk in its file's language. #btn("B3") on:
[a line's `+`, `-` or space], [that line in the new file],
)
+A `.diff` or `.patch` looked at, and a diff paged (`git show`), opens as
+a `+Diff`, stacked as delta shows one: each hunk under its `path:line`
+(`n`/`N` step through them, #btn("B3") opens it) and the declarations
+around it, a `+`/`-` before each line, the words a changed line changed
+tinted and a line added or removed whole faintly. A mailed patch keeps its
+message and diffstat above. The files are found from the diff's directory
+or one above it. #word("Diff") on a `+Diff` shows the diff itself as
+text (a paged one's `+Pager` is folded under it), and on the text stacks
+it again; #word("DiffLook") `text` in the startup file opens the text
+first.
+
= `pardes FILE` and `--wait` <editor>
In a pane's shell: