Cycle pane input modes with Mode and retain terminal tag access

1 files changed, 9 insertions, 5 deletions

diff --git a/docs/tags.md b/docs/tags.md
index 0e0fb85d..20c8c67a 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -68,11 +68,15 @@ tail, without displaying the current tint state. `PdfFit` (`SPC t z`) remains
 available, as do the shortcuts for `PdfTint` (`SPC t i`) and `PdfSections`
 (`SPC t s`, or `f` on a PDF).
 
-Terminal tags include `Togglettymode`, which toggles between normal editor mode and raw
-terminal input. Ctrl-B enters terminal input from editor mode; raw TTY mode
-forwards it to the child. The tag command also works while editing
-the tag: the command leaves tag editing and toggles the parked body mode.
-Executing it on a non-terminal pane does nothing.
+Terminal tags include `Mode`, which cycles through raw terminal input, normal
+editor mode, insert mode, and back to terminal input. On files and text output
+panes, `Mode` cycles between normal and insert mode; it is available as a command
+but does not appear in their default tags. Images and PDFs keep their normal mode.
+Executing `Mode` from a tag leaves the tag and advances the parked body mode.
+
+Ctrl-B keeps its terminal/editor toggle. Existing custom tags can still use
+`Togglettymode` for that two-way terminal toggle. Old default terminal tags
+upgrade to `Mode`; customized command text is preserved.
 
 ## Saved workspaces