This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author xtreak
Recipients docs@python, xtreak
Date 2018-07-10.08:32:01
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1531211521.37.0.56676864532.issue34081@psf.upfronthosting.co.za>
In-reply-to
Content
While running make docs sphinx generates a warning that there are duplicate labels named `_examples`. It seems it's present in `c-api/typeobj.rst` and `distutils/examples.rst` as below : 

➜  Doc git:(master) rg '.. _examples:'
c-api/typeobj.rst
2324:.. _examples:

distutils/examples.rst
1:.. _examples:

# Warning

2018-07-10T07:30:36.8709047Z /opt/vsts/work/1/s/Doc/distutils/examples.rst:5: WARNING: duplicate label examples, other instance in /opt/vsts/work/1/s/Doc/c-api/typeobj.rst

Sample log : https://python.visualstudio.com/cpython/cpython%20Team/_build/results?buildId=16141&view=logs

There are no references to the label as far as I have checked and I suppose this is an easy fix to be done if someone wants to take it up. The effect is that in the page https://docs.python.org/3.8/c-api/typeobj.html the following text links to distutils/examples for the text "Examples" which should ideally link to https://docs.python.org/3.8/c-api/typeobj.html#examples

"In addition to the following quick reference, the Examples section provides at-a-glance insight into the meaning and use of PyTypeObject."

It will be also helpful if sphinx warnings are made as an error in CI so that these are caught there.

Thanks
History
Date User Action Args
2018-07-10 08:32:01xtreaksetrecipients: + xtreak, docs@python
2018-07-10 08:32:01xtreaksetmessageid: <1531211521.37.0.56676864532.issue34081@psf.upfronthosting.co.za>
2018-07-10 08:32:01xtreaklinkissue34081 messages
2018-07-10 08:32:01xtreakcreate