Documentation file library/functions.rst has a syntax issue that when building documentation with warnings as errors, the following message appears:

cpython/Doc/library/functions.rst:: WARNING: inconsistent term references in translated message. original: [], translated: [':ref:`evento de auditoria <auditing>`']

After several testing, it seems that what is causing this is librar/functions.rst's line 795 not having a reference ":ref:`auditing event <auditing>`".


Steps to reproduce the issue:

1. git clone --depth 1 https://github.com/python/cpython

2. mkdir -p locale/pt_BR/LC_MESSAGES
3. git clone --depth 1 https://github.com/python/python-docs-pt-br locale/pt_BR/LC_MESSAGES

4. cd locale/pt_BR/LC_MESSAGES

# This takes about 40 minutes (can be ignored for outdated po files with more unrelated syntax errors) 
5. tx pull --force --language pt_BR --parallel

6. cd ../../..

7. cd cpython/Doc/

8. make venv

9. make html                                \
    SPHINXOPTS='-q --keep-going -jauto      \
        -D locale_dirs=../../locale         \
        -D language=pt_BR                   \
        -D gettext_compact=0                \
        -D latex_engine=xelatex             \
        -D latex_elements.inputenc=         \
        -D latex_elements.fontenc='

10. Look for library/functions.rst "WARNING" error message between the output.

I've already seen Sphinx giving inconsistent warnings about inconsistent terms references, see https://github.com/sphinx-doc/sphinx/issues/3985.

I would recommand fixing all other warnings in the file first, then tell us how it goes.

Hey Julien! I already fixed once, now I fixed them again, but the message persists:


make[1]: Entering directory '/home/rffontenelle/repos/python-docs-pt-br/venv/workdirs/cpython/Doc'
mkdir -p build
Building NEWS from Misc/NEWS.d with blurb
PATH=/home/rffontenelle/repos/python-docs-pt-br/venv/workdirs/cpython/Doc/venv/bin:$PATH sphinx-build -b html -d build/doctrees  -q --keep-going -jauto   \
	-D locale_dirs=/home/rffontenelle/repos/python-docs-pt-br/venv/workdirs/locale        \
	-D language=pt_BR             \
	-D gettext_compact=0                \
	-D latex_engine=xelatex             \
	-D latex_elements.inputenc=         \
	-D latex_elements.fontenc= -W . build/html 
/home/rffontenelle/repos/python-docs-pt-br/venv/workdirs/cpython/Doc/library/functions.rst:: WARNING: inconsistent term references in translated message. original: [], translated: [':ref:`evento de auditoria <auditing>`']
make[1]: *** [Makefile:51: build] Error 1
make[1]: Leaving directory '/home/rffontenelle/repos/python-docs-pt-br/venv/workdirs/cpython/Doc'

We are having a similar issue in python-docs-es translation.


cpython/Doc/library/ctypes.rst:: WARNING: inconsistent term references in translated message. original: [], translated: [':ref:`evento de auditoría <auditing>`']

https://travis-ci.org/github/python/python-docs-es/builds/698122676


Note that the WARNING does not mention a line number in the RST file. From what I could find, this is because the source English sentence is not in the .rst file, but it's a RST directive and the sentence comes from Python code: https://github.com/python/cpython/blob/6f8c8320e9eac9bc7a7f653b43506e75916ce8e8/Doc/tools/extensions/pyspecific.py#L135-L139

The original RST file, uses the directive here: https://github.com/python/cpython/blob/6f8c8320e9eac9bc7a7f653b43506e75916ce8e8/Doc/library/ctypes.rst#L1510


The PO file we are translating, does not have a header with line numbers for this paragraph: https://github.com/python/python-docs-es/blob/c51c38134ba74e26f73732ed96584325536141d3/library/ctypes.po#L1456-L1459