[issue9024] PyDateTime_IMPORT macro incorrectly marked up
Tim Golden
report at bugs.python.org
Fri Jun 18 10:48:49 CEST 2010
New submission from Tim Golden <mail at timgolden.me.uk>:
The reference to PyDateTime_IMPORT in the C API datetime docs is marked
up as cfunction, giving it a pair of brackets which render it invalid.
There is also no indication of where in the code it should be invoked.
Patch attached.
----------
files: pydatetime_import.patch
keywords: patch
messages: 108086
nosy: tim.golden
priority: normal
severity: normal
status: open
title: PyDateTime_IMPORT macro incorrectly marked up
Added file: http://bugs.python.org/file17703/pydatetime_import.patch
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue9024>
_______________________________________
-------------- next part --------------
Index: c-api/datetime.rst
===================================================================
--- c-api/datetime.rst (revision 82013)
+++ c-api/datetime.rst (working copy)
@@ -8,9 +8,9 @@
Various date and time objects are supplied by the :mod:`datetime` module.
Before using any of these functions, the header file :file:`datetime.h` must be
included in your source (note that this is not included by :file:`Python.h`),
-and the macro :cfunc:`PyDateTime_IMPORT` must be invoked. The macro puts a
-pointer to a C structure into a static variable, ``PyDateTimeAPI``, that is
-used by the following macros.
+and the macro :cmacro:`PyDateTime_IMPORT` must be invoked, usually as part of
+the module initialisation function. The macro puts a pointer to a C structure
+into a static variable, ``PyDateTimeAPI``, that is used by the following macros.
Type-check macros:
More information about the Python-bugs-list
mailing list