gh-119009: Add gettext target

[rffontenelle]

• Issue: Add gettext target to documentation's Makefile #119009

[ghost]

All commit authors signed the Contributor License Agreement.

[merwok]

Could you copy details on the problem and proposed solution in a github issue?
That way, we have info in the issues, solution in the PR, and nothing locked in discuss.

For CPython we like to have the problem discussed in an issue, and discusson on the PR can be focussed on the implementation itself. For this ticket there probably won’t be any debate on the issue, but I wanted to clarify this part of the workflow for future contributions!

[rffontenelle]

Could you copy details on the problem and proposed solution in a github issue?

Sure, issue opened.

[hugovk]

Please could you add a help entry (see line 30) so it shows up in:

❯ make -C Doc helpPlease use `make <target>' where <target> is one of clean to remove build files venv to create a venv with necessary tools html to make standalone HTML files htmlview to open the index page built by the html target in your browser htmllive to rebuild and reload HTML files in your browser htmlhelp to make HTML files and a HTML help project latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter text to make plain text files texinfo to make Texinfo file epub to make EPUB files changes to make an overview over all changed/added/deprecated items linkcheck to check all external links for integrity coverage to check documentation coverage for library and C API doctest to run doctests in the documentation pydoc-topics to regenerate the pydoc topics file dist to create a "dist" directory with archived docs for download check to run a check for frequent markup errors

[hugovk]

I get an error running this, what am I missing?

❯ make -C Doc gettextmkdir -p buildBuilding NEWS from Misc/NEWS.d with blurb/Users/hugo/github/python/cpython/main/Doc/build/NEWS is already up to datePATH=./venv/bin:$PATH sphinx-build -b gettext -d build/doctrees -j auto -W . build/gettextRunning Sphinx v7.3.7loading pickled environment... doneSphinx error:This environment is incompatible with the selected builder, please choose another doctree directory.make: *** [build] Error 2

That's from the repo root. I get the same thing with cd Doc; make gettext.

[rffontenelle]

Oh, I've seen it before. I believe to be something related to the doctree being in the same directory, but I didn't dig for the reason.

[rffontenelle]

I pushed a workaround: set another doctree directory for gettext.

[hugovk]

Thank you!

[miss-islington-app]

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

[bedevere-app]

GH-119074 is a backport of this pull request to the 3.13 branch.

[bedevere-app]

GH-119075 is a backport of this pull request to the 3.12 branch.