[Python-checkins] CVS: python/dist/src/Doc/ext extending.tex,1.1,1.2

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/ext
In directory usw-pr-cvs1:/tmp/cvs-serv19099/ext

Modified Files:
	extending.tex 
Log Message:
Document the rule that Python.h must be included before any standard
headers.  This is the final checkin for SF bug #458768.


Index: extending.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/ext/extending.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** extending.tex	2001/08/20 19:30:29	1.1
--- extending.tex	2001/09/06 16:30:30	1.2
***************
*** 47,52 ****
  which pulls in the Python API (you can add a comment describing the
  purpose of the module and a copyright notice if you like).
  
! All user-visible symbols defined by \code{"Python.h"} have a prefix of
  \samp{Py} or \samp{PY}, except those defined in standard header files.
  For convenience, and since they are used extensively by the Python
--- 47,55 ----
  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.
  
! 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.
  For convenience, and since they are used extensively by the Python
***************
*** 952,956 ****
  
  \begin{verbatim}
- #include <stdio.h>
  #include "Python.h"
  
--- 955,958 ----