From: Fred Drake <fdrake@acm.org>
Date: Wed, 4 Oct 2000 13:57:27 +0000 (+0000)
Subject: Added \versionchanged comment to os.popen() noting that it was unreliable
X-Git-Tag: v2.0c1~128
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c71c23e392cb45d191bfbd833d2b723c356a8f69;p=python

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>.
---

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 0586905a45..073d85954a 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}{}