update to new C roles and directives
diff --git a/Doc/c-api/tuple.rst b/Doc/c-api/tuple.rst
index eb479d5..16de45f 100644
--- a/Doc/c-api/tuple.rst
+++ b/Doc/c-api/tuple.rst
@@ -8,20 +8,20 @@
.. index:: object: tuple
-.. ctype:: PyTupleObject
+.. c:type:: PyTupleObject
- This subtype of :ctype:`PyObject` represents a Python tuple object.
+ This subtype of :c:type:`PyObject` represents a Python tuple object.
-.. cvar:: PyTypeObject PyTuple_Type
+.. c:var:: PyTypeObject PyTuple_Type
.. index:: single: TupleType (in module types)
- This instance of :ctype:`PyTypeObject` represents the Python tuple type; it is
+ This instance of :c:type:`PyTypeObject` represents the Python tuple type; it is
the same object as ``tuple`` and ``types.TupleType`` in the Python layer..
-.. cfunction:: int PyTuple_Check(PyObject *p)
+.. c:function:: int PyTuple_Check(PyObject *p)
Return true if *p* is a tuple object or an instance of a subtype of the tuple
type.
@@ -30,7 +30,7 @@
Allowed subtypes to be accepted.
-.. cfunction:: int PyTuple_CheckExact(PyObject *p)
+.. c:function:: int PyTuple_CheckExact(PyObject *p)
Return true if *p* is a tuple object, but not an instance of a subtype of the
tuple type.
@@ -38,16 +38,16 @@
.. versionadded:: 2.2
-.. cfunction:: PyObject* PyTuple_New(Py_ssize_t len)
+.. c:function:: PyObject* PyTuple_New(Py_ssize_t len)
Return a new tuple object of size *len*, or *NULL* on failure.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *len*. This might require
+ This function used an :c:type:`int` type for *len*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: PyObject* PyTuple_Pack(Py_ssize_t n, ...)
+.. c:function:: PyObject* PyTuple_Pack(Py_ssize_t n, ...)
Return a new tuple object of size *n*, or *NULL* on failure. The tuple values
are initialized to the subsequent *n* C arguments pointing to Python objects.
@@ -56,59 +56,59 @@
.. versionadded:: 2.4
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *n*. This might require
+ This function used an :c:type:`int` type for *n*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: Py_ssize_t PyTuple_Size(PyObject *p)
+.. c:function:: Py_ssize_t PyTuple_Size(PyObject *p)
Take a pointer to a tuple object, and return the size of that tuple.
.. versionchanged:: 2.5
- This function returned an :ctype:`int` type. This might require changes
+ This function returned an :c:type:`int` type. This might require changes
in your code for properly supporting 64-bit systems.
-.. cfunction:: Py_ssize_t PyTuple_GET_SIZE(PyObject *p)
+.. c:function:: Py_ssize_t PyTuple_GET_SIZE(PyObject *p)
Return the size of the tuple *p*, which must be non-*NULL* and point to a tuple;
no error checking is performed.
.. versionchanged:: 2.5
- This function returned an :ctype:`int` type. This might require changes
+ This function returned an :c:type:`int` type. This might require changes
in your code for properly supporting 64-bit systems.
-.. cfunction:: PyObject* PyTuple_GetItem(PyObject *p, Py_ssize_t pos)
+.. c:function:: PyObject* PyTuple_GetItem(PyObject *p, Py_ssize_t pos)
Return the object at position *pos* in the tuple pointed to by *p*. If *pos* is
out of bounds, return *NULL* and sets an :exc:`IndexError` exception.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *pos*. This might require
+ This function used an :c:type:`int` type for *pos*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: PyObject* PyTuple_GET_ITEM(PyObject *p, Py_ssize_t pos)
+.. c:function:: PyObject* PyTuple_GET_ITEM(PyObject *p, Py_ssize_t pos)
- Like :cfunc:`PyTuple_GetItem`, but does no checking of its arguments.
+ Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *pos*. This might require
+ This function used an :c:type:`int` type for *pos*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: PyObject* PyTuple_GetSlice(PyObject *p, Py_ssize_t low, Py_ssize_t high)
+.. c:function:: PyObject* PyTuple_GetSlice(PyObject *p, Py_ssize_t low, Py_ssize_t high)
Take a slice of the tuple pointed to by *p* from *low* to *high* and return it
as a new tuple.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *low* and *high*. This might
+ This function used an :c:type:`int` type for *low* and *high*. This might
require changes in your code for properly supporting 64-bit systems.
-.. cfunction:: int PyTuple_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o)
+.. c:function:: int PyTuple_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o)
Insert a reference to object *o* at position *pos* of the tuple pointed to by
*p*. Return ``0`` on success.
@@ -118,13 +118,13 @@
This function "steals" a reference to *o*.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *pos*. This might require
+ This function used an :c:type:`int` type for *pos*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: void PyTuple_SET_ITEM(PyObject *p, Py_ssize_t pos, PyObject *o)
+.. c:function:: void PyTuple_SET_ITEM(PyObject *p, Py_ssize_t pos, PyObject *o)
- Like :cfunc:`PyTuple_SetItem`, but does no error checking, and should *only* be
+ Like :c:func:`PyTuple_SetItem`, but does no error checking, and should *only* be
used to fill in brand new tuples.
.. note::
@@ -132,11 +132,11 @@
This function "steals" a reference to *o*.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *pos*. This might require
+ This function used an :c:type:`int` type for *pos*. This might require
changes in your code for properly supporting 64-bit systems.
-.. cfunction:: int _PyTuple_Resize(PyObject **p, Py_ssize_t newsize)
+.. c:function:: int _PyTuple_Resize(PyObject **p, Py_ssize_t newsize)
Can be used to resize a tuple. *newsize* will be the new length of the tuple.
Because tuples are *supposed* to be immutable, this should only be used if there
@@ -153,11 +153,11 @@
Removed unused third parameter, *last_is_sticky*.
.. versionchanged:: 2.5
- This function used an :ctype:`int` type for *newsize*. This might
+ This function used an :c:type:`int` type for *newsize*. This might
require changes in your code for properly supporting 64-bit systems.
-.. cfunction:: int PyTuple_ClearFreeList()
+.. c:function:: int PyTuple_ClearFreeList()
Clear the free list. Return the total number of freed items.