Explain the exit code for the wait() method, including a reference to

the os.W*() functions used to interpret the return value.

This fixes SF bug #429361.

1 files changed, 6 insertions, 1 deletions

diff --git a/Doc/lib/libpopen2.tex b/Doc/lib/libpopen2.tex
index 699308c..add0af1 100644
--- a/Doc/lib/libpopen2.tex
+++ b/Doc/lib/libpopen2.tex
@@ -77,7 +77,12 @@ code otherwise.
 \end{methoddesc}
 
 \begin{methoddesc}{wait}{}
-Waits for and returns the return code of the child process.
+Waits for and returns the status code of the child process.  The
+status code encodes both the return code of the process and
+information about whether it exited using the \cfunction{exit()}
+system call or died due to a signal.  Functions to help interpret the
+status code are defined in the \refmodule{os} module; see section
+\ref{os-process} for the \function{W\var{*}()} family of functions.
 \end{methoddesc}