[New-bugs-announce] [issue39229] library/functions.rst causes translated builds to fail

Rafael Fontenelle report at bugs.python.org
Mon Jan 6 00:38:30 EST 2020

New submission from Rafael Fontenelle <rffontenelle at gmail.com>:

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.

assignee: docs at python
components: Documentation
messages: 359401
nosy: docs at python, rffontenelle
priority: normal
severity: normal
status: open
title: library/functions.rst causes translated builds to fail
type: enhancement
versions: Python 3.9

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list