Description:
------------
---
From manual page: http://www.php.net/function.proc-close#Notes
---
The Notes section on proc_close() incorrectly states that the status returned on Unix systems is the one returned by waitpid(3) and that pcntl_wexitstatus() should be used to extract the "real" exit status.

In fact WEXITSTATUS() is already called in proc_open_rsrc_dtor() (/ext/standard/proc_open.c:266) which in turn is called by proc_close() and therefore the "real" exit status is already extracted, even on Unix.

If however the user tried to extract the already extracted "real" exit status with pcntl_wexitstatus() the result will always be 0 because WEXITSTATUS(status) is defined as (((status) & 0xff00) >> 8) (at least on my system – Ubuntu Linux 10.10 x86_64)


This Bug is related to #53518 but there it is proposed to change the behaviour of proc_close() which could break many now working systems. I therefore propose to change the documentation to reflect the actual behaviour.

This behaviour has been that way since at least 4.4.4

Test script:
---------------
$process = proc_open("exit 1", array(), $pipes);
echo "Without pcntl_wexitstatus(): ", proc_close($process), "\n";
$process = proc_open("exit 1", array(), $pipes);
echo "With pcntl_wexitstatus(): ", pcntl_wexitstatus(proc_close($process)), "\n";

Expected result:
----------------
The note should be removed from the manual or should state which versions of PHP actually work this way.