Skip to content

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

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 above each ---@class, in Server's shape, with names in code spans.

Changes

  • lua/libtmux/_internal/entity.lua, Session: Finding the session; Looking inside a session; Creating a window; Renaming and moving between windows; Options, hooks and environment; Things that need a terminal; Removing the session.
  • lua/libtmux/_internal/entity.lua, Window: Finding the window; Looking inside a window; Arranging; Placing in sessions; Changing things; Options and hooks.
  • lua/libtmux/_internal/entity.lua, Pane: Finding the pane; Sending input; Reading output; Splitting and arranging; Copy mode and buffers; Changing things; Options and hooks.

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
  • stylua --check passes, the file loads under Lua 5.5, and no line passes 100 columns
  • LuaLS and luacheck
  • 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 carry one-line descriptions, 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, renaming and
  navigating, options and environment, terminal, removing
- Window: finding, looking inside, arranging, placing in sessions,
  changing, options and hooks
- Pane: finding, sending input, reading output, splitting and
  arranging, copy mode and buffers, changing, options and hooks
- Match the Server directory: bold-led rows, each followed by a
  paragraph of code-span names
@tony
tony deployed to docs-preview November 14, 2026 23:37 — with GitHub Actions Active

This branch was successfully deployed

1 active deployment
docs-preview — e2ab8114 Deployed Nov 14, 2026 by tony via publish (pr-105, 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