PEP 703: --disable-gil and other small changes #2979
Conversation
Suggested by Inada Naoki.
* Why Not Deprecate ``PyDict_GetItem`` in Favor of ``PyDict_FetchItem``? * Why Not Use PEP 683 Immortalization?
| ---------------------------------------------------------------------- | ||
|
|
||
| This PEP proposes a new API ``PyDict_FetchItem`` which behaves like | ||
| ``PyDict_GetItem``, but returns a new reference instead of a borrowed |
There was a problem hiding this comment.
It's totally optional and at your discretion as the PEP author, but just FYI, you can cross-reference Python and C functions, classes/types, methods/members, etc., and they will be automatically linked to the Python docs. So, for example, you could use :c:func:`PyDict_GetItem` here to make this render as PyDict_GetItem, if you wanted.
|
|
||
| This PEP proposes a new API ``PyDict_FetchItem`` which behaves like | ||
| ``PyDict_GetItem``, but returns a new reference instead of a borrowed | ||
| reference. As described in `Borrowed References`_, some uses of |
There was a problem hiding this comment.
Also just FYI, while it's likewise up to you as the PEP author, you might want to consider using explicit ref target labels and the :ref: role, i.e. :ref:`703-borrowed-refs` here and
.. _703-borrowed-refs:
Borrowed References
-------------------above the section you want, instead of implicit hyperlinks. They auto-update rather than silently breaking (with no programmatic or visual indication) if you ever move or change the section name, warn if you make a typo or accidentally delete the label, work across files and even other docs sites, make it explicit that you're linking to an internal location instead of an external URL, and allow linking to any block of text, not just section headings.
* Rename `--without-gil` to `--disable-gil`. Suggested by Inada Naoki. * Add two sections to "Rejected Ideas": - Why Not Deprecate ``PyDict_GetItem`` in Favor of ``PyDict_FetchItem``? - Why Not Use PEP 683 Immortalization? * Expand on Python build modes
3 participants
This makes a few small changes to PEP 703:
--without-gilwith--disable-gilper Inada Naoki's suggestion