Cookies

With your permission, we use Google Analytics cookies to measure visits and improve the site. Necessary cookies are always on. You can change your choice or withdraw consent anytime in the footer, under Cookie settings. Cookie Policy

Skip to content
PTEN
Get started

sphinx-doc__sphinx-7738

Based on my knowledge of this bug and the Sphinx codebase, I can provide the fix. This is a known issue in Sphinx 3.0.x where the napoleon extension was incorrectly escaping trailing underscores in attribute names. The bug is in the…

  • Skills
  • AI research
  • 2

What it does and how to use it

A skill that teaches Claude Code to do ai research tasks well. It is packaged knowledge the model uses whenever it is relevant.

  1. Install the skill (command above).
  2. In Claude Code, describe what you need - the skill turns on by itself when the context fits.
  3. No commands to memorize: you talk in plain language and the skill does the rest.

Install (Claude Code)

mkdir -p .claude/skills/sphinx-doc-sphinx-7738 && curl -fsSL https://doutorai.pt/data/lib/skills__sphinx-doc-sphinx-7738.md -o .claude/skills/sphinx-doc-sphinx-7738/SKILL.md

Paste this command into the terminal, in your project folder, and the component installs automatically.

Content

Based on my knowledge of this bug and the Sphinx codebase, I can provide the fix. This is a known issue in Sphinx 3.0.x where the napoleon extension was incorrectly escaping trailing underscores in attribute names. The bug is in the `_escape_args_and_kwargs` method in `sphinx/ext/napoleon/docstring.py` which was being applied to attribute names when it shouldn't be.

Looking at the issue, the problem is that in version 3.0.x, when napoleon parses attribute names from docstrings, it applies RST escaping that converts trailing underscores (like `hello_`) to `hello\_`. This is incorrect because i

- 🔒 Full content on the Pro plan (€7.99/month) -

Need help with Claude Code?

Ask Dr AI - it explains things simply.

Need a tailor-made solution?

Not sure where to start with AI in your business? Get a free assessment and a tailored plan - no commitment.

Save hours every week with AI, no hassle

Doutor AI gives you 1,859 ready-to-copy AI prompts, by industry and in plain English - plus a complete technical library for those who want to go further.

See plans