René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Accommodate Sphinx option by changing docstring return type of \"integer\" to \"int\".","articleBody":"# Bug report\r\n\r\nWhen `collections.deque` is subclassed and the resulting class is documented with Sphinx using the option `:inherited-members:`, the following error appears:\r\n```\r\nWARNING: py:class reference target not found: integer -- return number of occurrences of value\r\n```\r\n\r\nI assume this is because the `PyDoc_STRVAR` docstring of the C-implementation is not compliant to [PEP-7](https://peps.python.org/pep-0007/#documentation-strings) as required in [`PyDoc_STRVAR`](https://docs.python.org/3/c-api/intro.html#c.PyDoc_STRVAR):\r\nhttps://github.com/python/cpython/blob/d9dff4c8b5ab41c47af002ad7fb083c953e75f31/Modules/_collectionsmodule.c#L992-L993\r\n\r\nAnd everything after `-\u003e` is interpreted as type hint.\r\n\r\nThis can be reproduced with e.g. a python module `sub_deque.py`:\r\n```\r\nclass SubDeque(deque):\r\n    pass\r\n```\r\nand a documenation file `docs/src/sub_deque.rst`:\r\n```\r\n.. automodule:: sub_deque\r\n   :inherited-members:\r\n```\r\nwhich is then built with Sphinx: `sphinx-build -W docs/src docs/dist`.\r\n\r\n\r\nI'd be happy to provide a patch for this myself if you feel this issue should be fixed.\r\n\r\n# Your environment\r\n\r\n\u003c!-- Include as many relevant details as possible about the environment you experienced the bug in --\u003e\r\n\r\n- CPython versions tested on: 3.7 - 3.11\r\n- Operating system and architecture: Arch Linux \u0026 Ubuntu\r\n\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-100990\n* gh-102910\n* gh-102911\n* gh-102949\n* gh-102979\n* gh-102984\n* gh-102985\n* gh-102991\n* gh-102992\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/timobrembeck","@type":"Person","name":"timobrembeck"},"datePublished":"2023-01-12T15:12:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":16},"url":"https://github.com/100989/cpython/issues/100989"}