more treesitter grammars

1 files changed, 28 insertions, 21 deletions

diff --git a/tutor.txt b/tutor.txt
index 3ce27edb..5a93d388 100644
--- a/tutor.txt
+++ b/tutor.txt
@@ -25,7 +25,8 @@
  This tutor is in THREE parts, ordered by what's most different from
  editors you may know:
    PART 1 — the MOUSE. Acme's three buttons; nothing like Vim/Helix.
-   PART 2 — the TTY.  A terminal is just a pane; Ctrl-b drops into it.
+   PART 2 — the TTY.  A terminal is just a pane; Ctrl-b drops into it
+             by default.
    PART 3 — the KEYS.  Helix-style modal (with the Pardes differences).
 
  PRACTICE BLOCKS (part 3): the "# keys:" line lists keystrokes
@@ -71,9 +72,11 @@
      Tab to execute or Enter to look — the acme chords on the keyboard.
 
  THE TAG: each pane has a one-line tag: its MODE (nm/in/sy) + directory
- or file path + the builtins "Del Delcol". Middle-click "Del" to close
- the window, "Delcol" to close its column. A SEPARATE bar across the top
- of the screen holds the window-agnostic builtins:
+ or file path + builtins. File panes show "Save Del" by default; Save
+ writes the current file to disk, Del closes the window. Terminal and
+ image panes show "Del". "Delcol" still exists as a command: type it in
+ a tag or body and execute it to close the whole column. A SEPARATE bar
+ across the top of the screen holds the window-agnostic builtins:
    Kill  Newcol  Tutor  Debug  Colors  NextColor
  Middle-click "Newcol" for a new column, "Tutor" to spawn this tutor,
  "Kill" to quit; Debug/Colors/NextColor toggle the stats overlay, the
@@ -115,10 +118,11 @@
                 go straight to the pty as terminal input.
 
  ESC:    insert -> normal.  (Esc never reaches tty.)
- Ctrl-b: toggles TTY on a terminal — the ONLY way in or out. Entering
-         is tty-native: if the shell is at a prompt and your modal
-         cursor sits on the input line, it first moves the shell's REAL
-         cursor to that spot —
+ Ctrl-b: toggles TTY on a terminal by default — the ONLY way in or out.
+         Use `pardes --tty-toggle=g` (or another letter) to make Ctrl-g
+         the toggle instead. Entering is tty-native: if the shell is at
+         a prompt and your modal cursor sits on the input line, it first
+         moves the shell's REAL cursor to that spot —
            - empty input  -> shell cursor at the prompt START
            - typed text   -> shell cursor at/after the char you were on
          via the shell's OSC 133 semantic prompt (ghostty promptClickMove;
@@ -129,9 +133,9 @@
  chords on the keyboard: Enter = "look" (open the path under the cursor),
  Tab = "execute". Both act on the selection if one is active.
 
- So the flow is: navigate the hidden-prompt page in normal, hit Ctrl-b
- where you want to keep typing, and you're IN the live shell at that
- spot. No separate "terminal mode cursor" to reconcile.
+ So the flow is: navigate the hidden-prompt page in normal, hit the tty
+ toggle where you want to keep typing, and you're IN the live shell at
+ that spot. No separate "terminal mode cursor" to reconcile.
 
  (The cursor positioning is enterTty's promptClickMove; it needs a live
  shell at a prompt. Mouse/tty behavior is exercised by the e2e suite.)
@@ -150,7 +154,8 @@
    - NO verb+noun (Vim's dw, cw). Motions only MOVE. To delete a word,
      select it (`v` then motions, or `x` for whole lines) then `d`.
    - ESC never reaches tty; it only does insert -> normal. Dropping a
-     terminal into the live shell is Ctrl-b (see Part 2).
+     terminal into the live shell is the tty toggle (Ctrl-b by default;
+     see Part 2).
    - Enter / Tab in normal mirror the mouse: Enter = look (open the path
      under the cursor), Tab = execute. `u` undo, `U` redo.
    - Editing a file pane MUTATES real content; a terminal pane yanks
@@ -302,8 +307,9 @@
 = 3.5 LINE SELECTION + EDIT: x d c y p                           =
 -----------------------------------------------------------------
 
- The Pardes difference. No `v` select-mode: `x` grows a line selection
- downward; d/c/y act on it.
+ The Pardes difference is LINE-first selection: `x` grows a line
+ selection downward; d/c/y act on it. `v` is still available for a
+ character range when you need one.
 
    `x` start/extend a line selection
    `d` delete the selected lines (yanked)
@@ -367,8 +373,9 @@
 
    zt / zz / zb     scroll so the cursor is at top/center/bottom
    Ctrl-d / Ctrl-u  half-page down / up
-   Ctrl-f           full page down.  (Ctrl-b pages up on a file pane,
-                    but on a terminal it's the tty toggle — see Part 2.)
+   Ctrl-f           full page down.  (Ctrl-b pages up on a file pane;
+                    on a terminal it is the default tty toggle. If you
+                    start with --tty-toggle=g, Ctrl-g takes that role.)
    Ctrl-w h/j/k/l   focus the pane left/down/up/right
    Alt-n            new terminal below the active one
    Alt-c            move the active terminal into a fresh column
@@ -382,9 +389,9 @@
 
  MOUSE (acme):  L select/focus+pin   M execute   R look(open)
                 select-then-act: middle-drag, or v/x then Tab
-                tag = mode + dir + "Del Delcol";  top bar = Kill Newcol
-                Tutor Debug Colors NextColor
- TTY:           a terminal IS a pane;  Ctrl-b toggles the live shell,
+                file tag = mode + path + "Save Del"; other tags show Del
+                top bar = Kill Newcol Tutor Debug Colors NextColor
+ TTY:           a terminal IS a pane;  Ctrl-b toggles the live shell by default,
                 landing its cursor where you navigated (prompt start if
                 the input is empty, mid-text otherwise)
  KEYS (helix):  h j k l  w b e  0 $ ^  gg G  v x  d c y p  i a I A o O
@@ -394,8 +401,8 @@
  vs Helix: no multi-cursor; selection is LINE-first (x), plus v chars.
  vs Vim:  no verb+noun (dw); motions only move; Esc never reaches tty.
  vs both: a terminal is just a pane; the same keys edit text and
-          navigate the shell screen, and Ctrl-b reuses the shell's
-          own prompt to position you precisely.
+          navigate the shell screen, and the tty toggle reuses the
+          shell's own prompt to position you precisely.
 
  To spawn THIS tutor again from anywhere: middle-click "Tutor" in the
  top bar (next to Kill / Newcol).