summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-01 15:55:23 -0300
committerGabriel Schneider <[email protected]>2026-10-01 17:18:10 -0300
commit90194d4eab7c67bb147201bdf6f8291196c2d9df (patch)
treeb5797bf687245e02386f2832db37ef7655307b7b /docs/typ/guide.typ
parent3c37c7c5c4516320819ed5cfeb95d590a4187f4a (diff)
downloadpardes-90194d4eab7c67bb147201bdf6f8291196c2d9df.tar.gz
pardes-90194d4eab7c67bb147201bdf6f8291196c2d9df.zip
The reference gains Coming from acme, one table of what differs for acme users and scripts; the intros say modelled on acme's; Look says it has no plumber; the guide compares Esc with acme's and answers the acme question fairly; the OTRUNC sentence reads
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/typ/guide.typ')
-rw-r--r--docs/typ/guide.typ13
1 files changed, 9 insertions, 4 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 5957692a..077c62f1 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -46,6 +46,9 @@ steps raw, normal, insert.
[a PDF], [#key("Esc"): clears the selection and the search highlights. #key("Shift-Esc"): back to the previous pane.],
)
+In acme, Esc selects the text typed since the last click; here it leaves
+insert mode, or goes back a pane.
+
#key("Shift-Esc") needs the kitty keyboard protocol or the GUI. Elsewhere
it is a plain Esc. The previous pane is the last one you jumped from, else
the next pane down the column.
@@ -155,7 +158,7 @@ pardes.
addr("notes.txt:12"), [line 12],
addr("notes.txt:/TODO/"), [the next match of `TODO`],
addr("src/"), [`ls` typed into a terminal idle there, else a new terminal there],
- addr("https://ziglang.org"), [the browser],
+ addr("https://ziglang.org"), [the browser, through `xdg-open` (`open` on macOS); there is no plumber],
)
#key("Enter") does the same from the keyboard; the other address forms are
@@ -271,9 +274,11 @@ Shell zsh
= Questions <questions>
/ Why not helix and tmux, or acme?: helix and tmux edit and run shells
- well, but their text is inert. acme makes text the interface, without
- modal keys, a terminal emulator or PDFs. pardes puts text as the interface, helix's
- keys, terminals, PDFs and a scriptable session in one program.
+ well, but their text is inert. acme makes text the interface and is
+ modeless by design, with win for shells and page and the plumber for
+ documents. pardes keeps acme's text as the interface and trades the rest
+ for helix's modal keys, a VT terminal and PDFs in a pane. What changes
+ for acme users and scripts is in #doc("reference", section: "from-acme").
/ Does it run inside tmux?: Yes, as in any terminal. Where tmux does not
pass kitty's protocols, #key("Shift-Esc") is a plain Esc and images draw
as glyph art.