Repository navigation
Conversation
why: Readers need versioned tmux command references beside the object descriptions. The Client citation must quote real upstream text. what: - Link all five object citations to tmux 3.7c and relevant commands - Preserve accurate quotations, citation labels, and OpenBSD attribution - Replace the unsupported Client quotation with sourced text and links - Cite pinned upstream source rather than mechanically redating access
why: tmux stores server messages in a global log. Attributing that output to one client misstates the command's scope. what: - Describe show-messages as reporting server messages or information - Preserve its versioned link and the existing citation identity
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #774 +/- ##
=======================================
Coverage 52.45% 52.45%
=======================================
Files 26 26
Lines 3729 3729
Branches 747 747
=======================================
Hits 1956 1956
Misses 1469 1469
Partials 304 304 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
Both reached the API reference as a name and a base class with no sentence. One says a primary key was never set; the other that a filter named a lookup that does not exist, which is what a mistyped keyword arrives as.
It is the default value of every `scope` parameter and appeared in the API reference as a name with a `...` body. The distinction worth stating is that it is not the same as passing no scope: tmux resolves the option itself.
why: Restoring the source description already displayed in the API reference leaves an extra blank line rejected by the current formatter. what: Remove that blank line without changing the description or executable syntax.
tony
marked this pull request as ready for review
October 15, 2026 02:46
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The object reference citations mix 2018 access dates, long quoted text and missing native command links. Refresh Server, Session, Window, Pane and Client attributions against tmux 3.7c, retaining accurate quotations and existing citation fragments. Link the native manual sections and relevant commands; correct Client's
show-messagesexplanation to describe server messages or information.Preserve the three existing QueryList exception/default-scope descriptions already displayed in the shared reference by retaining their source-owned documentation commits.
Independent review verified the pinned upstream manual and command source, all five native citation anchors and 16 unique link targets. Fresh Sphinx output from the final source builds without warnings and preserves all 25 citation links; Ruff passes. Executable AST and documented example source, expected output and options match the prior reference source. Hosted native testing is reported separately in the checks.
Shared-site extraction, generated exports and publication are being integrated in libtmux/docs#145. This change does not publish a Python package.