Title: METH_* and Py_TPFLAGS* constants are documented as Python data · Issue #96996 · python/cpython · GitHub
Open Graph Title: METH_* and Py_TPFLAGS* constants are documented as Python data · Issue #96996 · python/cpython
X Title: METH_* and Py_TPFLAGS* constants are documented as Python data · Issue #96996 · python/cpython
Description: For example, a search for Py_TPFLAGS says it's all “Python data”: Same with METH_. I guess this should be changed to c:macro:. It doesn't change URLs, but it would break references and Intersphinx links in third-party docs. And there's a...
Open Graph Description: For example, a search for Py_TPFLAGS says it's all “Python data”: Same with METH_. I guess this should be changed to c:macro:. It doesn't change URLs, but it would break references and Intersphinx ...
X Description: For example, a search for Py_TPFLAGS says it's all “Python data”: Same with METH_. I guess this should be changed to c:macro:. It doesn't change URLs, but it would break references and Inte...
Opengraph URL: https://github.com/python/cpython/issues/96996
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"METH_* and Py_TPFLAGS* constants are documented as Python data","articleBody":"For example, a [search for Py_TPFLAGS](https://docs.python.org/3/search.html?q=Py_TPFLAGS) says it's all “Python data”:\r\n\u003e \r\n\r\nSame with [METH_](https://docs.python.org/3/search.html?q=METH_).\r\n\r\nI guess this should be changed to `c:macro:`. It doesn't change URLs, but it *would* break references and Intersphinx links in third-party docs.\r\nAnd there's a lot of references to these items that use `:const:` rather than `:c:macro:`. All of them would need to change, possibly causing conflicts in backports.\r\n\r\n---\r\n\r\nAn additional issue is flag combinations in [structures.rst](https://github.com/python/cpython/blob/3.11/Doc/c-api/structures.rst):\r\n\r\n```rest\r\n\r\n.. data:: METH_VARARGS\r\n\r\n This is the typical calling convention, where[...]\r\n\r\n\r\n.. data:: METH_VARARGS | METH_KEYWORDS\r\n\r\n Methods with these flags must [...]\r\n```\r\n\r\n---\r\n\r\nThese should look like items of the same category to the reader, but one is a valid `c:macro` and the other isn't.\r\n\r\n\r\nSphinx experts, any tips on how (and whether) to best fix this?\r\n","author":{"url":"https://github.com/encukou","@type":"Person","name":"encukou"},"datePublished":"2022-09-21T16:04:58.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/96996/cpython/issues/96996"}
| 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:b649b88e-fc95-a71e-7138-1a309f31bc55 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | BC06:495C0:F4FF33:1460D40:696991EA |
| html-safe-nonce | 681deb71b7266e9c2ef26e0dade1d35a00a5674e3ea40b83171d9843d15dec0d |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCQzA2OjQ5NUMwOkY0RkYzMzoxNDYwRDQwOjY5Njk5MUVBIiwidmlzaXRvcl9pZCI6IjkxNjc4MTk0MDY5MDM0NDgwNDIiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 632739a80a863aedcf80afaa7c29aeee3f1e5f7447b666aef0137b2f7aff9f0c |
| hovercard-subject-tag | issue:1381171990 |
| 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/96996/issue_layout |
| twitter:image | https://opengraph.githubassets.com/5dafeca3ed47f84b2cb05654f8d3f1b190771ffd83368b35e4af48fceea52069/python/cpython/issues/96996 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/5dafeca3ed47f84b2cb05654f8d3f1b190771ffd83368b35e4af48fceea52069/python/cpython/issues/96996 |
| og:image:alt | For example, a search for Py_TPFLAGS says it's all “Python data”: Same with METH_. I guess this should be changed to c:macro:. It doesn't change URLs, but it would break references and Intersphinx ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | encukou |
| hostname | github.com |
| expected-hostname | github.com |
| None | 3542e147982176a7ebaa23dfb559c8af16f721c03ec560c68c56b64a0f35e751 |
| 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 | af80af7cc9e3de9c336f18b208a600950a3c187c |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width