fix(cli): Add "examples:" suffix to build_description headings

tony · tony · commit bb2ab46b0993 · 2026-01-11T09:21:20.000-06:00
Change build_description to produce "{heading} examples:" format
(e.g., "load examples:") instead of "{heading}:" (e.g., "load:").

The formatter's colorization logic uses content_lower.endswith("examples:")
to detect example section headings. Without the "examples:" suffix,
section headings like "load:" were not recognized and colorization
never triggered.

This aligns with vcspull's implementation which uses the same pattern.
diff --git a/src/tmuxp/_internal/colors.py b/src/tmuxp/_internal/colors.py
@@ -850,7 +850,7 @@ def build_description(
     'My tool.\n\nexamples:\n  mytool run'
 
     >>> build_description("My tool.", [("sync", ["mytool sync repo"])])
-    'My tool.\n\nsync:\n  mytool sync repo'
+    'My tool.\n\nsync examples:\n  mytool sync repo'
 
     >>> build_description("", [(None, ["cmd"])])
     'examples:\n  cmd'
@@ -865,7 +865,7 @@ def build_description(
     for heading, commands in example_blocks:
         if not commands:
             continue
-        title = "examples:" if heading is None else f"{heading}:"
+        title = "examples:" if heading is None else f"{heading} examples:"
         lines = [title]
         lines.extend(f"  {command}" for command in commands)
         sections.append("\n".join(lines))
