Skip to content

Escape * in generated function signatures for Sphinx - #6144

Open
alisonpetersonhq wants to merge 1 commit into
pybind:masterfrom
alisonpetersonhq:fix/sphinx-signature-escape-4537
Open

Escape * in generated function signatures for Sphinx#6144
alisonpetersonhq wants to merge 1 commit into
pybind:masterfrom
alisonpetersonhq:fix/sphinx-signature-escape-4537

Conversation

@alisonpetersonhq

Copy link
Copy Markdown

Fixes #4537

Summary

  • Escape * characters when appending overload signatures to generated docstrings.
  • Prevents Sphinx "inline emphasis start-string without end-string" warnings for bindings using pybind11::args or pybind11::kw_only.

Test plan

  • Build docs for a module using pybind11::args and verify Sphinx no longer warns on *.
  • Confirm ordinary signatures without * are unchanged.

Signed-off-by: alisonpetersonhq <alisonpetersonhq@users.noreply.github.com>
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.

[BUG]: Use of pybind11::args or pybind11::kw_only results in a Sphinx warning due to the use of *

1 participant