summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-03 16:52:58 -0300
committerGabriel Schneider <[email protected]>2026-11-03 16:52:58 -0300
commitd1273bbd99daf9b1855d82bf315db8ede20abde5 (patch)
tree14891fab4f951767dcf4d2b14470703055479b90 /docs/typ/reference.typ
parenta0320c49c1288e8e74f18983f18988a024952bb8 (diff)
downloadpardes-d1273bbd99daf9b1855d82bf315db8ede20abde5.tar.gz
pardes-d1273bbd99daf9b1855d82bf315db8ede20abde5.zip
fs: a pane's ctl read ends with its mode (mode:normal|insert|select|tty, select being normal mode extending), and kbdin takes Plan 9's Kalt, Kshift and Kctl runes (U+F015-F017), each adding its modifier to the key after it, an Alt or Ctrl key typing no text: the two surfaces the behavioural tests' inventory found most wanted (90 tests read body.mode, 18 send Alt or Shift); the tests that pinned the ctl line's end look for its words instead
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ10
1 files changed, 7 insertions, 3 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 75b33151..45863f04 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -593,8 +593,10 @@ while a column or workspace tag has the keyboard.
*Pane ctl.* Reading it gives acme's status line: serial, tag length, body
length, isdir (1 for a directory pane, else 0), dirty, width in cells, font, tab width, undo available,
redo available, then `current`/`notcurrent`, a REPL's id if bound,
-`collapsed` when it is, and for a PDF `fit:width|height
-tint:disabled|filtered|full`. Each field ends in a blank and the line has
+`collapsed` when it is, for a PDF `fit:width|height
+tint:disabled|filtered|full`, and last the body's mode,
+`mode:normal|insert|select|tty` (select: normal mode extending, helix's
+#key("v")). Each field ends in a blank and the line has
no newline, as acme's has none (`cat ctl; echo`). It
takes:
@@ -916,7 +918,9 @@ at 200, ending in `…`. Control characters become spaces.
Backspace, `0x7f` Delete, `0x1b` #key("Esc"), and the
arrows, Home, End, Page Up and Down, Insert and F1-F12 at their
private-use runes (`U+F00E` up, `U+F800` down, `U+F011` left, `U+F012`
- right, `U+F00D` Home, `U+F018` End). No Alt, Shift or Super.
+ right, `U+F00D` Home, `U+F018` End). Its Kalt, Kshift and Kctl
+ (`U+F015`, `U+F016`, `U+F017`) add Alt, Shift or Ctrl to the key after
+ them: `U+F015` `x` is Alt-x. No Super.
- #file("/mousein") (write only), devmouse's, in cells: a line `m col row
buttons` is the mouse as it now is, the buttons Plan 9's bits (1 left, 2
middle, 4 right; 8 and 16 a wheel notch up and down). What changed since