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 2721baa..90c5f08 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -314,19 +314,19 @@
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 @@
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