builtins + config: Save reaches every pane holding text of its own, and takes a path argument

1 files changed, 25 insertions, 14 deletions

diff --git a/src/tutor.txt b/src/tutor.txt
index 475cd04a..7dfac0bf 100644
--- a/src/tutor.txt
+++ b/src/tutor.txt
@@ -129,9 +129,12 @@
  THE TAG: each pane has a one-line tag: its directory or file path +
  builtins. (The mode is the box at the tag's left end, not a word in the
  tag.) Every pane shows "New" for an empty temporary file in its column.
- File panes show "Save New Del" by default; an unsaved edit puts `*` after
- the filename. Save writes the current file
- to disk, Del closes the window. Clicking a tag
+ Anything holding TEXT leads with "Save". A file pane shows
+ "Save New Del" and Save writes that file (an unsaved edit puts `*` after
+ the filename); a pane with no file of its own — a terminal, an output
+ buffer — needs the path, so "Save notes.txt" writes it under the pane's
+ own directory and a bare "Save" arms a prompt already filled in with that
+ directory. Del closes the window. Clicking a tag
  edits it in insert mode: type straight in, Enter looks / Tab executes
  body focuses that same tag in NORMAL mode, parked on the FIRST WORD of
  the tail rather than in the run of layout spaces before it — vim's
@@ -140,12 +143,14 @@
  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). A terminal shows
- "New Del Filter": Filter starts on, is local to that terminal, and
+ "Save New Del Filter": Save writes its plaintext scrollback to the path
+ you give and leaves it a terminal, and Filter starts on, is local to that
+ terminal, and
  projects every rendered foreground and background ANSI, 256-colour and
  truecolour value through keys made from the current Pardes theme; run it
  to restore the program's original colours.
- Images, PDFs, and output buffers like "+Search" show the plain "New Del",
- because there is no file behind them to Save. An image
+ Images and PDFs show the plain "New Del", because their bytes on disk
+ already are exactly what they are. An image
  tag leads with "img" and a PDF's with the word "pdf", its page out of
  the count, and its three commands each preceded by its current setting
  (part 4.1) — all of it live chrome, like the path.
@@ -205,9 +210,13 @@
  That last part is nothing new to learn: it is the step `n` is and the
  look Enter is, run for you in the list that has just answered. A pattern
  that matched nothing opens its empty buffer and goes nowhere.
- That is an OUTPUT BUFFER: a file pane with no file behind it, so it has
- no Save, but everything else about it is an ordinary buffer you can read,
- edit, select and look in. It is not a document, though, and never takes a
+ That is an OUTPUT BUFFER: a file pane with no file behind it, so Save
+ there always takes a path and asks for one when you do not give it —
+ and writing it out leaves the buffer exactly where it was, still the
+ list the next search refills. Everything else about it is an ordinary
+ buffer you can read, edit, select and look in. The one that does become
+ a file is "+New", the empty scratch, which is what it was opened for.
+ It is not a document, though, and never takes a
  column of its own: it opens BELOW the pane that asked for it, in that
  pane's column, be that a file or a shell — and a file you then open from
  its rows goes where files go, not under the list. `n`/`N` carry on down
@@ -794,9 +803,11 @@ abc
  Every cursor is filtered in the same pass, and the whole thing is ONE
  undo. `%` then `| sort` sorts a file.
 
- A real FILE pane, and only that: the gate is whether the pane has a file
- to Save, so `|` is inert in a terminal and in every output buffer, and
- the tag stays as it was.
+ A pane whose BYTES ARE ITS OWN, and only that: a real file, or the
+ scratch that is on its way to being one. So `|` is inert in a terminal
+ (shell output cannot be rewritten) and in a rendered output buffer like
+ "+Search", whose next refill would discard the filtered rows anyway, and
+ in both the tag stays as it was.
 
  Not to be confused with EXECUTING a word, which sends it to the
  pane's own shell and leaves the text alone. This one is a filter, and
@@ -1175,8 +1186,8 @@ abc
                 select-then-act: middle-drag, or v/x then Tab
                 chords: 1-2 cut  1-3 paste  (both in one hold = snarf)
                 2-1 = middle-exec with the left selection as argument
-                file tag = path + "Save New Del"; terminal = cwd +
-                          "New Del Filter"; other panes show "New Del"
+                every tag with text leads with Save (a terminal also
+                          has Filter); images and PDFs show "New Del"
                 top bar = New Newcol Find Grep Help Tutor Dump ... Debug Kill
                           (keyboard: k off the topmost tagline)
  WEB TOUCH:     one-finger tap = LOOK; drag = natural scroll