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.

diff --git a/Doc/lib/libpopen2.tex b/Doc/lib/libpopen2.tex
index 699308c2a0fabb058225936546fc6a65964d39a2..add0af130cf8761f62c3e749eba6e42cb8f43997 100644 (file)
--- 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}