Skip to content

Docs(entity[directory]): Add Session, Window, Pane directories - #114

Open
tony wants to merge 1 commit into
masterfrom
docs/api-directory
Open

tony wants to merge 1 commit into
masterfrom
docs/api-directory

Conversation

@tony

@tony tony commented Nov 14, 2026

Copy link
Copy Markdown
Contributor

Summary

LibTmux::Server opens with a task directory on libtmux.org; Session, Window and Pane do not. This adds them in Server's shape, with YARD {#method} references.

Changes

  • gems/libtmux/lib/libtmux/entity.rb, Session: Finding the session; Looking inside a session; Creating a window; Changing things; Options, hooks and environment; Expanding a format.
  • gems/libtmux/lib/libtmux/entity.rb, Window: Finding the window; Looking inside a window; Splitting and arranging; Changing things; Options, hooks and formats.
  • gems/libtmux/lib/libtmux/entity.rb, Pane: Finding the pane; Sending input; Reading output; Splitting and arranging; Copy mode, buffers and pipes; Changing things; Options, hooks and formats.

Review notes

  • The docs sit on each class's first definition. YARD merges reopened-class docs; which definition the docs extractor reads is untested.

Test plan

  • The libtmux.org parser (parseApiProse and groupDirectory from libtmux/docs, after this port's doc parser) folds each new doc comment into a directory
  • yard stats --private --protected reports no warnings
  • Docs workflow build on this branch
  • The directories render on libtmux.org once the docs model is regenerated from this branch

…and Pane

why: Server's reference page shows a capability directory, but Session,
Window and Pane have no class doc, so a reader arriving with a job has no
way in to the methods that do it.
what:
- Session: finding, looking inside, creating a window, changing,
  options and environment, formats
- Window: finding, looking inside, splitting and arranging, changing,
  options and formats
- Pane: finding, sending input, reading output, splitting and arranging,
  copy mode and pipes, changing, options and formats
- Match the Server directory: bold-led rows, then bullet lists of YARD
  {#method} references
@tony
tony deployed to docs-preview November 14, 2026 23:41 — with GitHub Actions Active

This branch was successfully deployed

1 active deployment
docs-preview — 627b74fd Deployed Nov 14, 2026 by tony via publish (pr-114, pr, false, docs-preview, true) / publish #366
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant