Remove unnecessary trailing backslashes

[rffontenelle]

The trailing backlash doesn't seem to be needed. Besides, they are extracted by Sphinx gettext builder as part of the translation string, which can lead to wrong translation.

---

📚 Documentation preview 📚: https://cpython-previews--135781.org.readthedocs.build/

[ZeroIntensity]

I don't see any noticeable change in the rendered documentation, but if this affects translations then it's worthwhile. @StanFromIreland, can you confirm?

[StanFromIreland]

When gettext extracts it, it escapes the \. The result looks like this:

#: ../../c-api/extension-modules.rst:245
msgid ""
"``_testsinglephase`` is an internal module used \\ in CPython's self-test "
"suite; your installation may or may not \\ include it."
msgstr ""

This will confuse translators, and they may leave it in, which will result in them appearing in the build. A prior similar pr: #135013 We should probably note this in the devguide, I will add it to my list.

[tomasr8]

Off-topic, but maybe also something to be fixed in Sphinx's gettext extraction? ISTM the backslashes should not be extracted, what do you think?

[StanFromIreland]

I agree the behaviour is weird and there is a bug in Sphinx which should also be fixed, but I’m not quite sure what we would want exactly, I will look into what GNU xgettext does.

[ZeroIntensity]

Ok, I'm going to merge this. @picnixz, as a Sphinx wizard, could you possibly look into fixing this upstream?

[miss-islington-app]

Thanks @rffontenelle for the PR, and @ZeroIntensity for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

[bedevere-app]

GH-135791 is a backport of this pull request to the 3.14 branch.

[picnixz]

as a Sphinx wizard, could you possibly look into fixing this upstream?

Yes, I can. IIRC it should be in https://github.com/sphinx-doc/sphinx/blob/c384ab96c328c3abc91b39c9e3e527863df30af1/sphinx/util/nodes.py#L292. I'll make the heuristic of only removing trailing backslashes from it.

[picnixz]

@ZeroIntensity or @rffontenelle could you open a Sphinx issue and tag me there? (just check that there isn't one existing)