Small ux improvements, : tagline focus

1 files changed, 16 insertions, 5 deletions

diff --git a/src/tutor.txt b/src/tutor.txt
index e2dfb123..cf9ecab0 100644
--- a/src/tutor.txt
+++ b/src/tutor.txt
@@ -108,10 +108,14 @@
  THE TAG: each pane has a one-line tag: its MODE (NOR/INS/TTY) + directory
  or file path + builtins. File panes show "Save Del" by default; Save
  writes the current file to disk, Del closes the window. Clicking a tag
- edits it, ALWAYS in insert mode (a one-line tag has no use for normal
- mode): type straight in, Enter looks / Tab executes the word at the
- cursor, Esc hands focus back to the body. Terminal and
- image panes show "Del". "Delcol" still exists as a command: type it in
+ edits it in insert mode: type straight in, Enter looks / Tab executes
+ the word at the cursor, Esc hands focus back to the body. `:` from the
+ body focuses that same tag in NORMAL mode, parked at its start — vim's
+ command line with acme's words in it: `:w<Tab>` is w onto "Save", Tab
+ to execute it, and you land back in the body where you left off (the
+ chord keys are the same here as anywhere else; `i` if you would rather
+ type a command than walk to one). 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
@@ -132,6 +136,11 @@
      when the pane is focused) to MOVE a window between columns / reorder
    - the scrollbar is the gutter below the box: left-click scrolls UP
      to that point, right-click scrolls DOWN
+   - the FIRST file/image/tutor you open takes a new leftmost column of
+     its own (nothing is displaced, the other columns just narrow); every
+     later one splits below a doc already open, so docs share that column
+   - closing a window (Del, or its shell exiting) hands focus back to the
+     window you were in before it, not to whichever one comes first
 
  (Mouse actions are hard to unit-test from text; native gestures are
  covered by the e2e suite. Browser touch and embedded-source LOOK are
@@ -196,7 +205,8 @@
      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.
+     under the cursor), Tab = execute. `:` runs a command from the tag
+     (see Part 1). `u` undo, `U` redo.
    - Editing a file pane MUTATES real content; a terminal pane yanks
      rendered text and pastes it as an insertion run (shell output
      can't be deleted, only pasted text can).
@@ -441,6 +451,7 @@
                 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
                 u undo  U redo   Enter=look  Tab=execute
+                : = the tag as a command line (motions, Enter, back)
                 zt zz zb  Ctrl-d/u  Ctrl-f  Ctrl-w hjkl  Alt-n/c
 
  vs Helix: no multi-cursor; selection is LINE-first (x), plus v chars.