Added \versionchanged comment to os.popen() noting that it was unreliable

in earlier versions of Python; this is useful information for people
interested in writing code that is portable across Python versions.

Suggested by Peter Funk <pf@artcom-gmbh.de>.

1 files changed, 6 insertions, 0 deletions

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 0586905..073d859 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -284,6 +284,12 @@ available as the return value of the \method{close()} method of the file
 object, except that when the exit status is zero (termination without
 errors), \code{None} is returned.
 Availability: \UNIX{}, Windows.
+
+\versionchanged[This function worked unreliably under Windows in
+  earlier versions of Python.  This was due to the use of the
+  \cfunction{_popen()} function from the libraries provided with
+  Windows.  Newer versions of Python do not use the broken
+  implementation from the Windows libraries]{2.0}
 \end{funcdesc}
 
 \begin{funcdesc}{tmpfile}{}