summaryrefslogtreecommitdiffstats
path: root/Doc/c-api
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2010-08-17 15:07:14 (GMT)
committerGeorg Brandl <georg@python.org>2010-08-17 15:07:14 (GMT)
commit67b21b7547feee634bbecafeb88606ff350c0d3c (patch)
treebd493e5b10f9cead75ed145def9e0098b53188ab /Doc/c-api
parent9e25701e87936ef61c348b5da6f9b580a52bab19 (diff)
downloadcpython-67b21b7547feee634bbecafeb88606ff350c0d3c.zip
cpython-67b21b7547feee634bbecafeb88606ff350c0d3c.tar.gz
cpython-67b21b7547feee634bbecafeb88606ff350c0d3c.tar.bz2
Consistency check for versionadded/changed directives.
Diffstat (limited to 'Doc/c-api')
-rw-r--r--Doc/c-api/arg.rst11
-rw-r--r--Doc/c-api/long.rst5
-rw-r--r--Doc/c-api/sys.rst1
-rw-r--r--Doc/c-api/unicode.rst5
4 files changed, 13 insertions, 9 deletions
diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
index 72f2d96..f955c96 100644
--- a/Doc/c-api/arg.rst
+++ b/Doc/c-api/arg.rst
@@ -305,13 +305,14 @@ Other objects
the conversion has failed. When the conversion fails, the *converter* function
should raise an exception and leave the content of *address* unmodified.
- If the *converter* returns Py_CLEANUP_SUPPORTED, it may get called a second time
- if the argument parsing eventually fails, giving the converter a chance to release
- any memory that it had already allocated. In this second call, the *object* parameter
- will be NULL; *address* will have the same value as in the original call.
+ If the *converter* returns ``Py_CLEANUP_SUPPORTED``, it may get called a
+ second time if the argument parsing eventually fails, giving the converter a
+ chance to release any memory that it had already allocated. In this second
+ call, the *object* parameter will be NULL; *address* will have the same value
+ as in the original call.
.. versionchanged:: 3.1
- Py_CLEANUP_SUPPORTED was added.
+ ``Py_CLEANUP_SUPPORTED`` was added.
``(items)`` (:class:`tuple`) [*matching-items*]
The object must be a Python sequence whose length is the number of format units
diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst
index a48a702..9a7811e 100644
--- a/Doc/c-api/long.rst
+++ b/Doc/c-api/long.rst
@@ -181,6 +181,7 @@ All integers are implemented as "long" integer objects of arbitrary size.
cannot be represented as a :ctype:`long long`, an
:exc:`OverflowError` is raised and ``-1`` is returned.
+
.. cfunction:: unsigned PY_LONG_LONG PyLong_AsUnsignedLongLong(PyObject *pylong)
.. index::
@@ -192,8 +193,8 @@ All integers are implemented as "long" integer objects of arbitrary size.
returned.
.. versionchanged:: 3.1
- A negative *pylong* now raises :exc:`OverflowError`, not
- :exc:`TypeError`.
+ A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`.
+
.. cfunction:: unsigned long PyLong_AsUnsignedLongMask(PyObject *io)
diff --git a/Doc/c-api/sys.rst b/Doc/c-api/sys.rst
index 27ee94c..00ddf00 100644
--- a/Doc/c-api/sys.rst
+++ b/Doc/c-api/sys.rst
@@ -127,6 +127,7 @@ accessible to C code. They all work with the current interpreter thread's
.. versionadded:: 3.2
+
.. _processcontrol:
Process Control
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
index 913fd69..b997629 100644
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -320,8 +320,7 @@ APIs:
when :const:`HAVE_LONG_LONG` is defined.
.. versionchanged:: 3.2
- Support for `"%lld"` and `"%llu"` added.
-
+ Support for ``"%lld"`` and ``"%llu"`` added.
.. cfunction:: PyObject* PyUnicode_FromFormatV(const char *format, va_list vargs)
@@ -387,6 +386,7 @@ used, passsing :func:`PyUnicode_FSConverter` as the conversion function:
.. versionadded:: 3.1
+
To decode file names during argument parsing, the ``"O&"`` converter should be
used, passsing :func:`PyUnicode_FSDecoder` as the conversion function:
@@ -399,6 +399,7 @@ used, passsing :func:`PyUnicode_FSDecoder` as the conversion function:
.. versionadded:: 3.2
+
.. cfunction:: PyObject* PyUnicode_DecodeFSDefaultAndSize(const char *s, Py_ssize_t size)
Decode a null-terminated string using :cdata:`Py_FileSystemDefaultEncoding`