From ea8f54b48028918433367b32ad657a3c6755d870 Mon Sep 17 00:00:00 2001 From: Tony Narlock Date: Tue, 20 Oct 2026 16:59:55 -0500 Subject: [PATCH] ci(docs) Build Go examples up from tested excerpts what: - Lay out the declarations of the tmux C source reference in 60 columns as clang-format does, with continuation lines aligned after the parenthesis, `*` against the name, and one enumerator per line in an enum that does not fit, and list a C function's leading self as a parameter - Read the whole info string of a code fence in API doc comments, and hide rustdoc's leading `# ` lines only in Rust examples, so comments in shell, Python, Ruby and YAML examples stay visible - Stop counting tmux release names such as 3.3a and `$` variable expressions as unresolved API name mentions why: Go example pages opened on a whole program with no path from the tmux commands to the code that runs them. The tmux C reference printed prototypes far wider than the 60 columns every port reference wraps at. Comments in shell, Python and Ruby examples were dropped as if they were rustdoc setup lines, and a code span naming a tmux release or a `$` variable was counted as an API name that did not resolve. Swift reference signatures printed their parameter list twice, Ruby and Swift type keywords showed as unresolved type names, and the publisher refused the PowerShell port's .NET alpha.22 dependency against its alpha.20 navigation pin. Shared source: libtmux/docs From: 4e891632a66a144bd9dd7747168cf9218eb32710 To: 7887ab25020bbeba3c9d32359e7a2c347ee69678 --- .github/workflows/docs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 47f56c46..ab9f4ab7 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -58,7 +58,7 @@ jobs: # A pull request builds `latest` without publishing; this port has no # preview role. build: - uses: libtmux/docs/.github/workflows/port-docs.yml@4e891632a66a144bd9dd7747168cf9218eb32710 + uses: libtmux/docs/.github/workflows/port-docs.yml@7887ab25020bbeba3c9d32359e7a2c347ee69678 with: port: ${{ inputs.language && inputs.language != 'all' && inputs.language || 'java' }} include-wrappers: ${{ inputs.language == '' || inputs.language == 'all' }} @@ -84,7 +84,7 @@ jobs: permissions: contents: read id-token: write - uses: libtmux/docs/.github/workflows/reusable-deploy.yml@4e891632a66a144bd9dd7747168cf9218eb32710 + uses: libtmux/docs/.github/workflows/reusable-deploy.yml@7887ab25020bbeba3c9d32359e7a2c347ee69678 with: # Unprefixed by locale: reusable-deploy prepends / itself when # `port` is set, so each language gets its own version tree.