From: Fred Drake <fdrake@acm.org>
Date: Mon, 11 Jun 2001 15:22:23 +0000 (+0000)
Subject: Fixed parameter order for os.popen2(), os.popen3(), and os.popen(4).  Added
X-Git-Tag: v2.1.1c1~82
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=26cff90fa9437e3ebfa4b2cd605440dd8e2c34aa;p=thirdparty%2FPython%2Fcpython.git

Fixed parameter order for os.popen2(), os.popen3(), and os.popen(4).  Added
a reference to these functions and popen() from the "Process Management"
section.

Based on a suggestion from comp.lang.python.
---

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 2721baa3e94b..90c5f08af6cf 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -314,19 +314,19 @@ specified, it specifies the buffer size for the I/O pipes.
 objects should be opened in binary or text mode.  The default value
 for \var{mode} is \code{'t'}.
 
-\begin{funcdesc}{popen2}{cmd\optional{, bufsize\optional{, mode}}}
+\begin{funcdesc}{popen2}{cmd\optional{, mode\optional{, bufsize}}}
 Executes \var{cmd} as a sub-process.  Returns the file objects
 \code{(\var{child_stdin}, \var{child_stdout})}.
 \versionadded{2.0}
 \end{funcdesc}
 
-\begin{funcdesc}{popen3}{cmd\optional{, bufsize\optional{, mode}}}
+\begin{funcdesc}{popen3}{cmd\optional{, mode\optional{, bufsize}}}
 Executes \var{cmd} as a sub-process.  Returns the file objects
 \code{(\var{child_stdin}, \var{child_stdout}, \var{child_stderr})}.
 \versionadded{2.0}
 \end{funcdesc}
 
-\begin{funcdesc}{popen4}{cmd\optional{, bufsize\optional{, mode}}}
+\begin{funcdesc}{popen4}{cmd\optional{, mode\optional{, bufsize}}}
 Executes \var{cmd} as a sub-process.  Returns the file objects
 \code{(\var{child_stdin}, \var{child_stdout_and_stderr})}.
 \versionadded{2.0}
@@ -928,6 +928,14 @@ Lock program segments into memory.  The value of \var{op}
 Availability: \UNIX{}.
 \end{funcdesc}
 
+\begin{funcdescni}{popen}{\unspecified}
+\funclineni{popen2}{\unspecified}
+\funclineni{popen3}{\unspecified}
+\funclineni{popen4}{\unspecified}
+Run child processes, returning opened pipes for communications.  These
+functions are described in section \ref{os-newstreams}.
+\end{funcdescni}
+
 \begin{funcdesc}{spawnv}{mode, path, args}
 Execute the program \var{path} in a new process, passing the arguments 
 specified in \var{args} as command-line parameters.  \var{args} may be