diff --git a/reference/pcntl/functions/pcntl-wait.xml b/reference/pcntl/functions/pcntl-wait.xml
index 8b932df474..e8a60bfeb2 100644
--- a/reference/pcntl/functions/pcntl-wait.xml
+++ b/reference/pcntl/functions/pcntl-wait.xml
@@ -1,5 +1,5 @@
-
+
pcntl_wait
@@ -14,7 +14,46 @@
int&status
- &warn.undocumented.func;
+ The wait function suspends execution of the current process until a
+ child has exited, or until a signal is delivered whose action is to
+ terminate the current process or to call a signal handling function. If a
+ child has already exited by the time of the call (a so-called "zombie"
+ process), the function returns immediately. Any system resources used by
+ the child are freed. Please see your system's wait(2) man page for
+ specific details as to how wait works on your system.
+
+
+ pcntl_wait returns the process ID of the child which
+ exited.
+
+
+ pcntl_wait will store status information
+ in the status parameter which can be
+ evaluated using the following functions:
+ pcntl_wifexited,
+ pcntl_wifstopped,
+ pcntl_wifsignaled,
+ pcntl_wexitstatus,
+ pcntl_wtermsig and
+ pcntl_wstopsig.
+
+
+
+ This function is equivalent to calling pcntl_waitpid
+ with a -1 pid and no
+ options.
+
+
+
+ See also pcntl_fork,
+ pcntl_signal,
+ pcntl_wifexited,
+ pcntl_wifstopped,
+ pcntl_wifsignaled,
+ pcntl_wexitstatus,
+ pcntl_wtermsig,
+ pcntl_wstopsig and
+ pcntl_waitpid.
diff --git a/reference/pcntl/functions/pcntl-waitpid.xml b/reference/pcntl/functions/pcntl-waitpid.xml
index 4d5a26cffc..15cb87d3d7 100644
--- a/reference/pcntl/functions/pcntl-waitpid.xml
+++ b/reference/pcntl/functions/pcntl-waitpid.xml
@@ -1,5 +1,5 @@
-
+
@@ -69,6 +69,13 @@
+
+
+ Specifying -1 as the pid is
+ equivalent to the functionality pcntl_wait provides
+ (minus options).
+
+
pcntl_waitpid will store status information
in the status parameter which can be