Description:
------------
I spent 10 minutes debugging why
$foo = array_splice($foo, 0, 1);
would remove the wrong element from a 2-element array. I then realized I has misread the documentation:
---
From manual page: http://www.php.net/function.array-splice
---

Return Values ¶

Returns the array consisting of the extracted elements.

----
I had hastily read the above as "Returns the array without the extracted elements."

There is no way I could have been confused had I carefully read the whole sentence, but the sentence is still technically incorrect, since several arrays can consist of the extracted elements. I might not have misunderstood had the sentence read:

Returns an array consisting of the extracted elements.

Otherwise, the documentation could specify which array consisting of the extracted elements is returned.