GH-90744: Fix erroneous doc links in the sys module

[furkanonder]

• Issue: In documentation same-named attributes erroneously link to built-in names #90744

[hugovk]

This removes the bad links, but they're no longer formatted as code:

Before	After
https://docs.python.org/3.12/library/sys.html#sys.float_info	https://deploy-preview-101319--python-cpython-preview.netlify.app/library/sys.html#sys.float_info

And when running Sphinx in nit-picky mode (re: #101100), we're getting warnings about all of those:

Doc/library/sys.rst:14: WARNING: py:const reference target not found: epsilon
Doc/library/sys.rst:19: WARNING: py:const reference target not found: dig
Doc/library/sys.rst:22: WARNING: py:const reference target not found: mant_dig
Doc/library/sys.rst:27: WARNING: py:const reference target not found: max_exp
Doc/library/sys.rst:30: WARNING: py:const reference target not found: max_10_exp
Doc/library/sys.rst:39: WARNING: py:const reference target not found: min_exp
Doc/library/sys.rst:42: WARNING: py:const reference target not found: min_10_exp
Doc/library/sys.rst:45: WARNING: py:const reference target not found: radix
Doc/library/sys.rst:47: WARNING: py:const reference target not found: rounds

So shall we change all of them like this?

-    :const:`max`
+    ``max``

And we could also do the macros too, although that will also require adjusting the column width:

-    DBL_MAX
+    ``DBL_MAX``

[furkanonder]

This removes the bad links, but they're no longer formatted as code:

Before After

https://docs.python.org/3.12/library/sys.html#sys.float_info https://deploy-preview-101319--python-cpython-preview.netlify.app/library/sys.html#sys.float_info
And when running Sphinx in nit-picky mode (re: #101100), we're getting warnings about all of those:

Doc/library/sys.rst:14: WARNING: py:const reference target not found: epsilon
Doc/library/sys.rst:19: WARNING: py:const reference target not found: dig
Doc/library/sys.rst:22: WARNING: py:const reference target not found: mant_dig
Doc/library/sys.rst:27: WARNING: py:const reference target not found: max_exp
Doc/library/sys.rst:30: WARNING: py:const reference target not found: max_10_exp
Doc/library/sys.rst:39: WARNING: py:const reference target not found: min_exp
Doc/library/sys.rst:42: WARNING: py:const reference target not found: min_10_exp
Doc/library/sys.rst:45: WARNING: py:const reference target not found: radix
Doc/library/sys.rst:47: WARNING: py:const reference target not found: rounds

So shall we change all of them like this?

-    :const:`max`
+    ``max``

And we could also do the macros too, although that will also require adjusting the column width:

-    DBL_MAX
+    ``DBL_MAX``

Changing :const:`max` to ``max`` made sense to me. The gray background behind the texts, in my opinion, makes the words stand out more. We can also make these corrections for other words in the documents.

[hugovk]

Marking as changes requested, re: #101319 (comment)

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[hugovk]

Looks good now, and the warnings fixed 👍

https://deploy-preview-101319--python-cpython-preview.netlify.app/library/sys.html#sys.float_info

Thanks!

[hugovk]

Actually, one last little thing :)

[miss-islington]

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

[hugovk]

Thank you!

[miss-islington]

Sorry, @furkanonder and @hugovk, I could not cleanly backport this to 3.11 due to a conflict.
Please backport using cherry_picker on command line.
cherry_picker 85b1fc1fc5a2e49d521382eaf5e7793175d00371 3.11

[miss-islington]

Sorry @furkanonder and @hugovk, I had trouble checking out the 3.10 backport branch.
Please retry by removing and re-adding the "needs backport to 3.10" label.
Alternatively, you can backport using cherry_picker on the command line.
cherry_picker 85b1fc1fc5a2e49d521382eaf5e7793175d00371 3.10

[bedevere-bot]

GH-102321 is a backport of this pull request to the 3.11 branch.

[bedevere-bot]

GH-102322 is a backport of this pull request to the 3.10 branch.

[hugovk]

The backports also include GH-99675 to avoid conflict, and which wasn't originally backported.