gh-101100: Fix dangling references in test.rst by smontanaro · Pull Request #114958 · python/cpython
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What's the reason for disabling reference resolution here, sorry? Does it not work, for some reason? A c:macro: is defined for Py_DEBUG, and the macro definition and surrounding text describes what it means for Python to be built in debug mode, so seems a useful reference here.
Also, this wording change seems a bit incongruous to my eye and the breaks don't either minimize diffs or follow the semantic structure. Therefore, I'd suggest either simplifying the structure and wording with more logical breaks:
| True if Python was built with the :c:macro:`!Py_DEBUG` macro defined: if | |
| Python is :ref:`built in debug mode <debug-build>` | |
| True if Python was built with the :c:macro:`Py_DEBUG` macro defined: | |
| i.e. it was :ref:`built in debug mode <debug-build>` |
or minimizing diffs to just the essential fixes
| True if Python was built with the :c:macro:`!Py_DEBUG` macro defined: if | |
| Python is :ref:`built in debug mode <debug-build>` | |
| True if Python was built with the :c:macro:`Py_DEBUG` macro | |
| defined; that is, if | |
| Python was :ref:`built in debug mode <debug-build>` |