From 90194d4eab7c67bb147201bdf6f8291196c2d9df Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 15:55:23 -0300 Subject: 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 --- docs/typ/guide.typ | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'docs/typ/guide.typ') 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 / 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. -- cgit v1.3