[New-bugs-announce] [issue9024] PyDateTime_IMPORT macro incorrectly marked up

[Tim Golden]

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: