mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-22 00:02:23 +00:00
l0ng-ai
f828e9ce22
The same defect as the previous commit, found by sweeping for it: a doc
block holding one item's summary followed by another's, with no blank
line between, so rustdoc attributes the whole thing to whichever item
happens to follow and the other is left undocumented.
daemon/pane.rs "The pane's screen, capped for storage, with the mark"
describes `scrollback_snapshot`, which returns exactly
that pair and had no documentation. It was sitting on
`scrollback_mark`, in front of that function's own.
ui/tree_sync.rs "This workspace's layout, and the name the machine has
for it" was on `settle_chosen_name`, which settles a
name and returns one. `git log -S` puts it above the
signature returning `(WsMirror, Option<String>)` --
`pull_or_create` -- so it was moved, not guessed.
core/ssh_config The "does this alias still resolve" paragraph, with the
four-times-a-second cost that explains the cache, was
on `struct AliasCache` rather than on
`alias_still_resolves`.
A fourth hit was not this: `file_tree_reveal_path` really does own both
of its paragraphs, and only wanted the blank `///` that separates them --
without it rustdoc runs "use file_tree_show when the tree *is* the
answer" straight into "returns whether the tree could hold it".
Nothing catches any of this. A fused block is well-formed rustdoc, so
`-D warnings` passes; the only symptom is a function with no docs and a
neighbour with somebody else's.