Commit ecbdc5d2 authored by Fred Drake's avatar Fred Drake

Emphasize the requirement that Python.h be included first more strongly.

Closes SF bug #837228; backporting for Python 2.3.4.
parent 90150a90
...@@ -37,9 +37,12 @@ API are included in your code by the following line: ...@@ -37,9 +37,12 @@ API are included in your code by the following line:
This implies inclusion of the following standard headers: This implies inclusion of the following standard headers:
\code{<stdio.h>}, \code{<string.h>}, \code{<errno.h>}, \code{<stdio.h>}, \code{<string.h>}, \code{<errno.h>},
\code{<limits.h>}, and \code{<stdlib.h>} (if available). \code{<limits.h>}, and \code{<stdlib.h>} (if available).
Since Python may define some pre-processor definitions which affect
the standard headers on some systems, you must include \file{Python.h} \begin{notice}[warning]
before any standard headers are included. Since Python may define some pre-processor definitions which affect
the standard headers on some systems, you \emph{must} include
\file{Python.h} before any standard headers are included.
\end{notice}
All user visible names defined by Python.h (except those defined by All user visible names defined by Python.h (except those defined by
the included standard headers) have one of the prefixes \samp{Py} or the included standard headers) have one of the prefixes \samp{Py} or
......
...@@ -46,9 +46,12 @@ The first line of our file can be: ...@@ -46,9 +46,12 @@ The first line of our file can be:
which pulls in the Python API (you can add a comment describing the which pulls in the Python API (you can add a comment describing the
purpose of the module and a copyright notice if you like). purpose of the module and a copyright notice if you like).
Since Python may define some pre-processor definitions which affect
the standard headers on some systems, you must include \file{Python.h} \begin{notice}[warning]
before any standard headers are included. Since Python may define some pre-processor definitions which affect
the standard headers on some systems, you \emph{must} include
\file{Python.h} before any standard headers are included.
\end{notice}
All user-visible symbols defined by \file{Python.h} have a prefix of All user-visible symbols defined by \file{Python.h} have a prefix of
\samp{Py} or \samp{PY}, except those defined in standard header files. \samp{Py} or \samp{PY}, except those defined in standard header files.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment