Remember tag cursors and reserve uppercase pane navigation

1 files changed, 11 insertions, 4 deletions

diff --git a/docs/tags.md b/docs/tags.md
index c159e9cf..1d874448 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -31,11 +31,18 @@ and Look gestures still apply; the workspace tag is no longer an inert
 left-click target. Pasted text goes to the focused tag, not to the file or
 embedded shell beneath it.
 
-Normal tag navigation now visits pane, column, and workspace tags in order:
-from the top pane's `:` tag, `k` reaches the column and another `k` reaches
-the workspace; `j` walks back down. Enter or Tab on a header command in
+Keyboard entry returns to the tag's last cursor position. The first entry into
+a pane tag starts at its commands; clicking always chooses a new position.
+Each pane, column and workspace tag remembers its own position during the
+session. Shortened text clamps the saved cursor to a valid character boundary.
+
+In normal mode, `h` and `l` move within the tag, `k` stays on the single line,
+and `j` returns to the panel like Escape. Uppercase `HJKL` move between pane
+tags. From the top pane's `:` tag, `K` reaches the column and another `K` reaches
+the workspace; `J` walks back down. Enter or Tab on a header command in
 normal mode executes it, as before. `i`/`a`/`I`/`A` switch to editing the
-header. In insert mode, Enter is Look and Tab is Exec, as in pane tags.
+header. In insert mode, letters type normally, Enter is Look and Tab is Exec,
+as in pane tags.
 
 Pane filenames and commands now have a single separator space rather than
 generated right-alignment padding. Intentionally customized spacing is kept.