Fixing bad commit :(

Added note about the order of the function parameters.  Docs could be miss-interpreted if, this note tries to reinforce expected behaviour and use

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@333320 c90b9560-bf6c-de11-be94-00142212c4b1