Skip to content

Commit 57959e5

Browse files
committed
Improve wording in Rationale as suggested by AA-Turner
> The current wording is in the rationale section, which is > setting out the justification for the proposal. To me, it > seems odd to phrase it "We need <feature> because <thing> > requires <requirement>, but we don't guarantee requirement. > > My suggested rephrasing more explicity spells out that we > want to support <thing> properly, there is a reason the > current state doesn't work (no guarantees at an API level > of stability), and hence <feature> is needed that provides > those guarantees. - #2559 (comment)
1 parent 26715b0 commit 57959e5

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

pep-0689.rst

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,12 @@ The Python C-API is currently divided into `three tiers <https://devguide.python
2929
<387>`, and requires deprecation warnings before changes
3030
- Private (internal) API, which can change at any time.
3131

32-
We need a tier between Public and Private to accommodate tools like
33-
advanced debuggers and JIT compilers, which need access to CPython
34-
internals but assume the C-API they use does not change in patch releases.
32+
Tools requring access to CPython internals (e.g. advanced
33+
debuggers and JIT compilers) are often built for minor series releases
34+
of CPython, and assume that the C-API interals used do not change
35+
in patch releases. To support these tools, we need a tier between the
36+
Public and Private C-API, with guarantees on stability throughout
37+
the minor-series release.
3538

3639

3740
Setting Stability Expectations

0 commit comments

Comments
 (0)