aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoruser <user@clank>2026-09-22 15:38:08 +0200
committeruser <user@clank>2026-09-22 15:38:08 +0200
commit1cbfb4474ca31c61254be8d5f3ec046967bd1ff3 (patch)
tree3e8184674e330ce24ebef23dd13594fa38f45fa2 /docs
parentsidebar: room for the spinner, by default (tab_bar_padding 0 1 0 2) (diff)
downloadslosh-1cbfb4474ca31c61254be8d5f3ec046967bd1ff3.tar.gz
slosh-1cbfb4474ca31c61254be8d5f3ec046967bd1ff3.tar.xz
slosh-1cbfb4474ca31c61254be8d5f3ec046967bd1ff3.zip
theme: the busy spinner is its own colour (tab_status_spinner)
It was drawn in tab_status_busy, the colour of the words it sits beside, which made one decision out of two. The words have to stay readable at a glance and a mark does not: a theme may well want the glyph loud and the text calm -- or the text in the accent and the mark a quiet dot -- and with one entry neither is available without moving both. Unset it follows tab_status_busy, derived after it and from whatever that resolved to, named or derived, so nothing changes for anyone who does not ask and no theme in contrib needs a line. `--dump-theme` writes both, like every other colour the compositor draws.
Diffstat (limited to 'docs')
-rw-r--r--docs/panes.md4
-rw-r--r--docs/scripting.md3
-rw-r--r--docs/slosh.57
3 files changed, 11 insertions, 3 deletions
diff --git a/docs/panes.md b/docs/panes.md
index d760b82..57e3014 100644
--- a/docs/panes.md
+++ b/docs/panes.md
@@ -100,7 +100,9 @@ be able to cost you a tab you can click.
**A pane can say its status is still happening**, and the sidebar says so back:
`busy` over OSC 5577 turns that row `tab_status_busy` and puts a spinner
-(`busy_mark`) in the first column of the indent — so `make test` running and
+(`busy_mark`, in `tab_status_spinner` — its own theme entry, because the words
+have to stay readable and a mark does not, and unset it follows the words) in
+the first column of the indent — so `make test` running and
`make test` finished, which are the same words, stop looking the same from
another tab. Nothing moves when it flips, since the mark takes a column the
padding was already holding blank, and the rest of that padding is the space
diff --git a/docs/scripting.md b/docs/scripting.md
index 9971bc5..8fff400 100644
--- a/docs/scripting.md
+++ b/docs/scripting.md
@@ -115,7 +115,8 @@ keep it current and `clear` it when the work is done.
of its own rather than a field of `status`, because a status is the *whole*
payload after the verb — `status;a;b;c` is the text `a;b;c` — so anything added
to that line would change what every sender already means. In a sidebar a busy
-status gets the spinner (`busy_mark`) and `tab_status_busy`, which is how
+status gets the spinner (`busy_mark`, coloured `tab_status_spinner`) and
+`tab_status_busy`, which is how
"working" and "done" tell themselves apart from another tab without reading the
words. Anything but `0`, `false`, `no` or `off` turns it on; `clear` turns it
off along with the text, and so does the program exiting — a status left behind
diff --git a/docs/slosh.5 b/docs/slosh.5
index 62205cc..3c1a43a 100644
--- a/docs/slosh.5
+++ b/docs/slosh.5
@@ -224,7 +224,12 @@ is the spinner's frames separated by spaces; one frame is a static mark and
costs nothing, several make it turn, and the session keeps a frame clock only
while such a row is on screen. Empty draws no mark and leaves
.B tab_status_busy
-to say it. The mark sits in the first column
+to say it.
+The mark is drawn in
+.BR tab_status_spinner ,
+which follows
+.B tab_status_busy
+unless a theme names it. The mark sits in the first column
.B tab_bar_padding
holds blank, so nothing moves when a program starts or stops working, and
the rest of that padding is the space after it.