Description:
------------
---
From manual page: http://www.php.net/function.array-reverse#refsect1-function.array-reverse-returnvalues
---
Hello. I think that something is missing from the documentation.

You said that "Returns the reversed array."

..but if in the $array parameter I didn't give an array, what it will return?
I think that this must be mentioned in the documentation.

Now, I have to test it manually in order to see the behavior.

Test script:
---------------
$arr = my_function(); // This, may return an array, but may return bool false.

$arr = array_reverse($arr, true); // What will happen if "$arr === false" ?

/* * * * * * * * * * * * * * * * * * * * * *
 * Just to be sure, I have to write this:  */

$arr = my_function();

if($arr !== false) $arr = array_reverse($arr, true);


Expected result:
----------------
echo array_reverse(false);

/*

Expected Result === false

or

WARNING?

*/

Actual result:
--------------
It is not clear in the documentation