summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
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.