Title: Docs use deprecated Sphinx `.. index::` entries · Issue #97950 · python/cpython · GitHub
Open Graph Title: Docs use deprecated Sphinx `.. index::` entries · Issue #97950 · python/cpython
X Title: Docs use deprecated Sphinx `.. index::` entries · Issue #97950 · python/cpython
Description: In #97921 (comment) @hugovk noticed that Sphinx has deprecated some of the .. index:: entry types: module, keyword, operator, object, exception, statement, builtin These all create two index entries. For example, module: hashlib creates ...
Open Graph Description: In #97921 (comment) @hugovk noticed that Sphinx has deprecated some of the .. index:: entry types: module, keyword, operator, object, exception, statement, builtin These all create two index entrie...
X Description: In #97921 (comment) @hugovk noticed that Sphinx has deprecated some of the .. index:: entry types: module, keyword, operator, object, exception, statement, builtin These all create two index entrie...
Opengraph URL: https://github.com/python/cpython/issues/97950
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Docs use deprecated Sphinx `.. index::` entries","articleBody":"In https://github.com/python/cpython/pull/97921#issuecomment-1269131226 @hugovk noticed that [Sphinx has deprecated some of the `.. index::` entry types](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#index-generating-markup):\r\n\r\n\u003e module, keyword, operator, object, exception, statement, builtin\r\n\u003e These all create two index entries. For example, module: hashlib creates the entries module; hashlib and hashlib; module. (These are Python-specific and therefore deprecated.)\r\n\r\nCurrently we are using some of those in the docs, so we have at least 3 options:\r\n* keep using them if it's a silent deprecation with no removal plans\r\n* reimplement them in pyspecific.py, if we want to keep use them (and if it's possible to reimplement them)\r\n* remove them and replace them with the non-deprecated ones\r\n\r\n(cc @AA-Turner)\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-103996\n* gh-104000\n* gh-104151\n* gh-104153\n* gh-104154\n* gh-104155\n* gh-104156\n* gh-104157\n* gh-104158\n* gh-104159\n* gh-104160\n* gh-104161\n* gh-104162\n* gh-104163\n* gh-104164\n* gh-104221\n* gh-107246\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/ezio-melotti","@type":"Person","name":"ezio-melotti"},"datePublished":"2022-10-06T00:26:35.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/97950/cpython/issues/97950"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:a7dfdce4-315b-cb12-7ea9-fdf5472161b1 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | AFCE:31E362:1149E12:173C636:6969A9E8 |
| html-safe-nonce | 790a45b238faecbca91b001dfe4261ef9dc8d55ce122c3a490f8dd35702be672 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBRkNFOjMxRTM2MjoxMTQ5RTEyOjE3M0M2MzY6Njk2OUE5RTgiLCJ2aXNpdG9yX2lkIjoiNjg2MDczNjAyODMxNDU0NDYxNiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | aa2fd3fb3233914b6e80f6282fd3f691e5bd2c71491ed9a3ee2c5e516685e4b5 |
| hovercard-subject-tag | issue:1398541800 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/97950/issue_layout |
| twitter:image | https://opengraph.githubassets.com/5b94e535c47619fa8f35b4ff880157a95db8ac4712922350b6de7c267892c65f/python/cpython/issues/97950 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/5b94e535c47619fa8f35b4ff880157a95db8ac4712922350b6de7c267892c65f/python/cpython/issues/97950 |
| og:image:alt | In #97921 (comment) @hugovk noticed that Sphinx has deprecated some of the .. index:: entry types: module, keyword, operator, object, exception, statement, builtin These all create two index entrie... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | ezio-melotti |
| hostname | github.com |
| expected-hostname | github.com |
| None | 24c4c97a2d520cb286b35e1a4c22d7a4df3c26a2fa28dd7cdf0e65db327b4de7 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 124667f43168afb6c9c03b7c02eb5b1d2e1be3d9 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width