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.

diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index bebe8dc14056419e6c8fc2cae0d6ae1b55d2e21a..fe095500b83190fbbaf25fb5da42017af3be919a 100644 (file)
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -597,6 +597,15 @@ parameter.  The available start symbols are \constant{Py_eval_input},
 \constant{Py_file_input}, and \constant{Py_single_input}.  These are
 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
   (console or terminal input or \UNIX{} pseudo-terminal), return the