Skip to content

Commit 24d79fe

Browse files
committed
Indent "provisional" notices and add versionadded notes
1 parent ae26300 commit 24d79fe

File tree

2 files changed

+27
-8
lines changed

2 files changed

+27
-8
lines changed

Doc/c-api/object.rst

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -361,11 +361,13 @@ Object Protocol
361361
otherwise, the arguments are converted to use
362362
:c:member:`~PyTypeObject.tp_call`.
363363
364-
.. note::
364+
.. note::
365+
366+
This function is provisional and expected to become public in Python 3.9,
367+
with a different name and, possibly, changed semantics.
368+
If you use the function, plan for updating your code for Python 3.9.
365369
366-
This function is provisional and expected to become public in Python 3.9,
367-
with a different name and, possibly, changed semantics.
368-
If you use the function, plan for updating your code for Python 3.9.
370+
.. versionadded:: 3.8
369371
370372
.. c:data:``PY_VECTORCALL_ARGUMENTS_OFFSET``
371373
@@ -379,6 +381,8 @@ Object Protocol
379381
Doing so will allow callables such as bound methods to make their onward
380382
calls (which include a prepended *self* argument) cheaply.
381383
384+
.. versionadded:: 3.8
385+
382386
.. c:function:: Py_ssize_t PyVectorcall_NARGS(size_t nargsf)
383387
384388
Given a vectorcall *nargsf* argument, return the actual number of
@@ -397,11 +401,13 @@ Object Protocol
397401
:c:func:`_PyObject_Vectorcall`.
398402
It should only be used if the caller already has a dictionary ready to use.
399403
400-
.. note::
404+
.. note::
405+
406+
This function is provisional and expected to become public in Python 3.9,
407+
with a different name and, possibly, changed semantics.
408+
If you use the function, plan for updating your code for Python 3.9.
401409
402-
This function is provisional and expected to become public in Python 3.9,
403-
with a different name and, possibly, changed semantics.
404-
If you use the function, plan for updating your code for Python 3.9.
410+
.. versionadded:: 3.8
405411
406412
407413
.. c:function:: Py_hash_t PyObject_Hash(PyObject *o)

Doc/c-api/typeobj.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -686,6 +686,17 @@ and :c:type:`PyType_Type` effectively act as defaults.)
686686
but only if :c:member:`~PyTypeObject.tp_call` is also inherited.
687687
Heap types never inherit this.
688688

689+
.. note::
690+
691+
The semantics of slot are provisional and expected to be finalized
692+
in Python 3.9.
693+
If you use vectorcall, plan for updating your code for Python 3.9.
694+
695+
.. versionchanged:: 3.8
696+
697+
This slot was used for print formatting in Python 2.x.
698+
Up to Python 3.7, it was named ``tp_print``.
699+
689700

690701
.. c:member:: getattrfunc PyTypeObject.tp_getattr
691702
@@ -2297,6 +2308,8 @@ Slot Type typedefs
22972308
22982309
See :c:member:`~PyTypeObject.tp_vectorcall_offset`.
22992310

2311+
.. versionadded: 3.8
2312+
23002313
.. c:type:: void (*freefunc)(void *)
23012314
23022315
See :c:member:`~PyTypeObject.tp_free`.

0 commit comments

Comments
 (0)