[Python-checkins] CVS: python/dist/src/Doc/api api.tex,1.76,1.77

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory slayer.i.sourceforge.net:/tmp/cvs-serv31542/api

Modified Files:
	api.tex 
Log Message:

In the section on the "Very High Level Layer", address concerns brought up
by Edward K. Ream <edream@users.sourceforge.net> about FILE* values and
incompatible C libraries in dynamically linked extensions.  It is not clear
(to me) how realistic the issue is, but it is better documented than not.

This closes SourceForge bug #111520.


Index: api.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/api.tex,v
retrieving revision 1.76
retrieving revision 1.77
diff -C2 -r1.76 -r1.77
*** api.tex	2000/08/11 20:39:29	1.76
--- api.tex	2000/08/14 02:50:21	1.77
***************
*** 598,601 ****
--- 598,610 ----
  described following the functions which accept them as parameters.
  
+ Note also that several of these functions take \ctype{FILE*}
+ parameters.  On particular issue which needs to be handled carefully
+ is that the \ctype{FILE} structure for different C libraries can be
+ different and incompatible.  Under Windows (at least), it is possible
+ for dynamically linked extensions to actually use different libraries,
+ so care should be taken that \ctype{FILE*} parameters are only passed
+ to these functions if it is certain that they were created by the same
+ library that the Python runtime is using.
+ 
  \begin{cfuncdesc}{int}{PyRun_AnyFile}{FILE *fp, char *filename}
    If \var{fp} refers to a file associated with an interactive device