From: Fred Drake <fdrake@acm.org>
Date: Wed, 31 Mar 2004 07:48:14 +0000 (+0000)
Subject: Emphasize the requirement that Python.h be included first more strongly.
X-Git-Tag: v2.3.4c1~85
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=797ded0e766daa1f2ced6d597e63287715c06377;p=thirdparty%2FPython%2Fcpython.git

Emphasize the requirement that Python.h be included first more strongly.
Closes SF bug #837228; backported from the head.
---

diff --git a/Doc/api/intro.tex b/Doc/api/intro.tex
index 364487d8c2c8..d27a11608369 100644
--- a/Doc/api/intro.tex
+++ b/Doc/api/intro.tex
@@ -37,9 +37,12 @@ API are included in your code by the following line:
 This implies inclusion of the following standard headers:
 \code{<stdio.h>}, \code{<string.h>}, \code{<errno.h>},
 \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}
-before any standard headers are included.
+
+\begin{notice}[warning]
+  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
 the included standard headers) have one of the prefixes \samp{Py} or
diff --git a/Doc/ext/extending.tex b/Doc/ext/extending.tex
index 95e4546effee..c50714ea8854 100644
--- a/Doc/ext/extending.tex
+++ b/Doc/ext/extending.tex
@@ -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
 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}
-before any standard headers are included.
+
+\begin{notice}[warning]
+  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
 \samp{Py} or \samp{PY}, except those defined in standard header files.