special: keys go to a tile, and Esc only ever leaves

Inside the special workspace the agenda and the calendar could only be
reached with Alt-h/j/k/l, which a desktop that binds Alt to its own windows
never lets through, and the same keys meant two things: t on the agenda put
the whole workspace away, t elsewhere went to it. Three esc buttons, one per
tile, all closed everything.

Now b, t and C only ever go to their tile, from anywhere. Tab and Shift-Tab
walk the tiles, as they walk the spaces elsewhere; l past the board's last
list goes on into the agenda, h in the agenda back to the board, j past its
end into the calendar. S toggles the workspace, and q and Esc leave it from
whichever tile — after leaving fullscreen first. The tile buttons are gone;
each tile's head shows its key instead, lit on the one with focus, and the
bar has a special pill beside the spaces.

A document opened from the workspace — a day of the calendar, an entry of
the agenda, today's entry, a card's notes — comes back to the tile it was
opened from on q.

The board tile shows the board of the space being browsed, or else the last
one shown, so coming from the diary, which has none, no longer leaves it
empty. Card and list actions follow the board on screen, not the browsed
space.

docs/wiki/Boards-and-Agenda.md

@@ -4,30 +4,38 @@
 
 The board, the agenda and the [calendar](Diary.md#the-calendar) share one
 workspace of their own, as the desktop's special workspace holds what is
-looked at in passing. `S` (or `:special`) puts it up and away again. It is
-three tiles: the board on the left, the agenda over the calendar on the right.
+looked at in passing. `S` (or `:special`, or the `special` pill in the bar)
+puts it up and away again. It is three tiles: the board on the left, the
+agenda over the calendar on the right.
 
 ![The special workspace](../images/board.png)
 
 | key | what it does |
 | --- | --- |
 | `S` | put the special workspace up, or away |
-| `b`, `t`, `C` | straight to the board, the agenda or the calendar; again on the one with focus puts the workspace away |
-| `Alt-h` / `Alt-j` / `Alt-k` / `Alt-l` | focus the tile that way |
+| `b`, `t`, `C` | to the board, the agenda or the calendar, from anywhere |
+| `Tab` / `Shift-Tab` | the next / previous tile |
+| `Alt-h` / `Alt-j` / `Alt-k` / `Alt-l` | the tile that way |
+| `l` past the last list, `h` in the agenda, `j` past its end | on into the tile beside |
 | `f` | the focused tile fills the screen; again or `Esc` to leave |
 | `1` … `9` | switch space, and the board with it |
-| `q`, `Esc` | back to the tree |
+| `q`, `Esc` | leave, back to where you were |
 
-The keys go to the tile with focus, which wears the light border; the other
-tiles keep their cursors, dimmed. Everything in it is read again each time it
-comes up.
+The keys go to the tile with focus, which wears the light border and its key
+lit in its head; the other tiles keep their cursors, dimmed. `b`, `t` and `C`
+only ever go to their tile, and `Esc` only ever leaves — or, with a tile
+filling the screen, leaves that first. A document opened from the workspace —
+a card's notes, a day of the calendar, an entry of the agenda, `T` — comes
+back to the tile it was opened from on `q`. Everything in it is read again
+each time it comes up.
 
 ## The board
 
 Every space except the diary has a board. `b`, the board button on the rail, or
-`:board` shows it in the special workspace, and `q` goes back to the tree. The
-head of the board names every space that has one, with the digit that goes
-there.
+`:board` shows it in the special workspace, and `Esc` goes back to the tree.
+It is the board of the space being browsed, or, in a space without one such as
+the diary, the last board shown. The head of the board names every space that
+has one, with the digit that goes there.
 
 A new board has three lists: `backlog`, `doing` and `done`. The lists mean
 something by where they stand, not by their names:
@@ -55,7 +63,7 @@ a week fold away until `z` shows them.
 | `z` | show done cards older than a week |
 | `F` | a letter over every card; type it to jump there |
 | `x`, `dd` | delete the card |
-| `q`, `Esc` | put the special workspace away |
+| `q`, `Esc` | leave the special workspace |
 
 ### Capturing a card
 
@@ -121,14 +129,15 @@ special workspace beside the board.
 
 | key | what it does |
 | --- | --- |
-| `j` / `k` | down / up, on into the diary entries |
+| `j` / `k` | down / up, on into the diary entries, then into the calendar |
+| `h` | to the board |
 | `Enter` | to the card on its own board, in the tile beside, or open the entry |
 | `Space` | finish the card where it stands |
 | `D` | due date |
 | `H` / `L` | to the list left / right on its board |
 | `:` | the command line with the agenda kept up, so `:repeat` acts on the card |
 | `T` | today's diary entry |
-| `t`, `q`, `Esc` | put the special workspace away |
+| `q`, `Esc` | leave the special workspace |
 
 The agenda opens by itself once a day when something is late or due. "Today"
 is the day in `WORKSPACE_TIMEZONE`, the same as for the mails, so a browser in

docs/wiki/Commands.md

@@ -42,14 +42,14 @@ arguments and `↑` / `↓` recall earlier lines.
 | `m / p` | pick nodes up, then drop them all into the folder you walk to |
 | `M` | pick up the whole folder — again puts it all back |
 | `Ctrl / Shift-click` | pick a row up · every row up to it — drag them onto a folder |
-| `S` | the special workspace: the board, the agenda and the calendar side by side — again puts it away |
-| `Alt-h/j/k/l · f` | in the special workspace: to the board, the agenda or the calendar — f gives one the screen |
+| `S` | the special workspace: the board, the agenda and the calendar side by side — S again, q or Esc leave it |
+| `Tab · Alt-h/j/k/l` | in the special workspace: the next tile, or the one that way — l past the last list and j past the agenda go on too |
 | `t` | agenda — late, due this week, in hand, on every board — in the special workspace |
 | `T` | today's diary entry, started if there is none — from templates/day when the diary has one |
 | `C` | the diary by month, in the special workspace: h/l a day, j/k a week, H/L a month, . today, Enter opens or starts the day |
 | `[d / ]d` | the diary entry before / after the one open, by date |
 | `Ctrl-P` | find anything, in every space — Enter goes to the result lit |
-| `b` | this space's board, in the special workspace — 1 … 9 there shows another space's |
+| `b` | the board, in the special workspace: this space's, or the last one shown — 1 … 9 there shows another's |
 | `c` | capture a card into this space's inbox, without leaving here |
 | `Esc · q` | close the document, and its tile when there are several |
 | `/` | full-text search, inside the current space and its text files — Tab or Ctrl-N/P walk the results, Enter opens one |
@@ -70,7 +70,7 @@ The first list is the inbox, the last list is done.
 
 | key | what it does |
 | --- | --- |
-| `h / l` | to the list left / right |
+| `h / l` | to the list left / right — right of the last is the agenda |
 | `j / k` | down / up the cards |
 | `gg / G` | first / last card of the list |
 | `J / K` | move the card down / up its list |
@@ -84,20 +84,21 @@ The first list is the inbox, the last list is done.
 | `F` | a letter over every card in view — type it to put the cursor there |
 | `r` | read the board again, for changes made elsewhere |
 | `x · dd` | delete the card (asks y/N) |
-| `q · Esc` | put the special workspace away |
+| `q · Esc` | leave the special workspace |
 
 ### In the agenda
 
 | key | what it does |
 | --- | --- |
-| `j / k` | down / up the cards, then what was written on this day in earlier years |
+| `j / k` | down / up the cards, then what was written on this day in earlier years, then into the calendar |
+| `h` | to the board |
 | `Enter` | to the card, on its own board beside — or to the entry |
 | `Space` | done, where it stands |
 | `D` | due date: fri, tm, +3d … — :due on the line |
 | `:` | the line, with the agenda kept up — :repeat weekly acts on the card |
 | `H / L` | to the list left / right on its board |
 | `T` | today's diary entry |
-| `t · q · Esc` | put the special workspace away |
+| `q · Esc` | leave the special workspace — a document opened from it comes back here on q |
 
 ## Commands
 
@@ -123,8 +124,8 @@ do: `:w!`, `:space! <name>`, `:import!`.
 
 | command | what it does |
 | --- | --- |
-| `:board` | this space's board, in the special workspace — again puts it away |
-| `:special` | the special workspace: the board, the agenda and the calendar side by side — S toggles it, Alt-h/j/k/l moves between them, 1 … 9 picks the board |
+| `:board` | this space's board, in the special workspace |
+| `:special` | the special workspace: the board, the agenda and the calendar side by side — S puts it up and away, Tab walks its tiles, 1 … 9 picks the board |
 | `:card, :c <title>` | add a card — on the board to the list under the cursor, elsewhere to this space's inbox |
 | `:card!` | add a card linked to the open document — Enter on it opens the document |
 | `:due <when\|->` | due date of the card — on the board, or highlighted in the agenda: today, tm, fri, +3d, +2w, 10-31, 2026-10-31 — - clears |

docs/wiki/Diary.md

@@ -26,7 +26,7 @@ agenda.
 | `H` / `L` | a month back / forward |
 | `.` | today |
 | `Enter` | open the day's entry, or start one dated that day |
-| `C`, `Esc` | put the special workspace away |
+| `q`, `Esc` | leave the special workspace; an entry opened here comes back on `q` |
 
 A dot marks a day with an entry. A number says how many when there are more
 than one.

docs/wiki/Getting-Started.md

@@ -71,9 +71,9 @@ The rail of buttons on the right does the same as the keys, for a mouse.
    add a name and press `Enter`. `l` or `Enter` on the folder goes into it, and
    `h` comes back up.
 6. Press `c`, type `try the board`, and press `Enter`. That is a card in the
-   inbox of this space's board. Press `b` to see the board, and `b` again to go
+   inbox of this space's board. Press `b` to see the board, and `Esc` to go
    back. It shares a special workspace with the agenda and the calendar: `S`
-   puts it up, and `Alt-h`/`Alt-l` move between them.
+   puts it up and away, and `Tab` walks between them.
 7. Press `T`. That is today's diary entry, started for you.
 8. Press `?` for the list of every key and command. `h` / `l` walk its columns, `/` narrows it down, and `Esc` closes it.
 

docs/wiki/Guide.md

@@ -13,7 +13,7 @@ The keys are the desktop's. On a phone, every one of these has a button; see
 The first time you open the workspace each day, the **agenda** opens by itself
 when anything is late or due. Any other time, press `t`. It opens in the
 **special workspace**, beside the board and the calendar; `S` puts that up and
-away from anywhere, and `Alt-h`/`Alt-l` move between its tiles.
+away from anywhere, and `Tab` walks its tiles.
 
 ![The agenda](../images/agenda.png)
 
@@ -35,7 +35,7 @@ Walk it with `j` and `k`. On a card:
 - `H` and `L` move it to the list left or right on its board;
 - `Enter` goes to the card on its own board, in the tile beside.
 
-`Esc` or `t` puts the special workspace away. The bar keeps showing the `late` and `today`
+`Esc` leaves the special workspace. The bar keeps showing the `late` and `today`
 counts while either is above zero. More in [Boards and the agenda](Boards-and-Agenda.md).
 
 ## At work: spaces, documents and tiles