gh-119009: Add gettext target

[rffontenelle]

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

[cpython-cla-bot]

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 help
Please 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 gettext
mkdir -p build
Building NEWS from Misc/NEWS.d with blurb
/Users/hugo/github/python/cpython/main/Doc/build/NEWS is already up to date
PATH=./venv/bin:$PATH sphinx-build -b gettext -d build/doctrees -j auto   -W . build/gettext
Running Sphinx v7.3.7
loading pickled environment... done

Sphinx 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.