docs(tmux): name the tmux releases a one-binding list-keys answer is blank on (#821)

The blank list-keys -T answer is not a development-build quirk: tmux commit
09bd686327 sent a one-binding listing to a status message instead of stdout,
and it shipped in 3.7, 3.7a, 3.7b and 3.7c until 7ec94fda08 fixed it for 3.8.
The comments, the tests and the invariants doc now say so.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Codeman maintainer committed 2026-11-20 04:02:36 +01:00
1 parent 8202e07286
commit 507116f019
5 files changed
+13 -13

No files matched your search

+4 -4
View File
@@ -117,8 +117,8 @@ describe('restrictTmuxPrefixTable (recorded commands)', () => {
});
it('reads a one-binding table from the full listing when `list-keys -T prefix` prints nothing', () => {
// A tmux `next-3.7` build lists a table holding exactly one binding as nothing at
// all. The reduced table must still read as reduced, or every call resets it.
// tmux 3.7 through 3.7c list a table holding exactly one binding as nothing at
// all on stdout (fixed in 3.8). The reduced table must still read as reduced, or every call resets it.
const tmux = fakeTmux({
'show-options -gv prefix': 'C-b\n',
'list-keys -T prefix': '',
@@ -153,8 +153,8 @@ const hasTmux = (() => {
})();
/**
* One key table as `list-keys -T <table>` prints it. Some tmux builds (a `next-3.7`
* development build) print NOTHING there when the table holds exactly one binding,
* One key table as `list-keys -T <table>` prints it. tmux 3.7 through 3.7c (fixed in
* 3.8) print NOTHING there when the table holds exactly one binding,
* which is the shape every reset in this file produces, so a blank answer is read from
* the full listing instead, its padding folded to the `-T <table>` form.
*/
+2 -2
View File
@@ -1017,8 +1017,8 @@ describe('resumeSession', () => {
});
describe('TuiClient key-table reads on a tmux that lists a one-binding table as nothing', () => {
// A tmux `next-3.7` build prints nothing for `list-keys -T prefix` when the table
// holds exactly one binding, which is how Codeman leaves it. Reading that as "free"
// tmux 3.7 through 3.7c (fixed in 3.8) print nothing for `list-keys -T prefix` when
// the table holds exactly one binding, which is how Codeman leaves it. Reading that as "free"
// would let the TUI claim a key the user has bound.
const fullListing =
'bind-key -T copy-mode C-a send-keys -X start-of-line\n' +