Array-Functions

Hello all, while working on the de-translation of the array-functions, I've recognized the following: 1.) FUNCTION ARRAY_REVERSE: The mentioned "$result2" doesn't exist in the related example, it should be "$result_keyed": *** snip *** Example 1. Array_reverse() example $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); $result_keyed = array_reverse ($input, TRUE); This makes $result have array (array ("green", "red"), 4.0, "php"). But $result2[0] is still "php". *** snip *** 2.) FUNCTION ARRAY_FLIP: http://www.php.net/manual/en/html/function.array-flip.html: Considering a beginner with no programming history, this description isn't easy to understand. Therefore I'd suggest a description like: **** snip *** array_flip -- Flip all the values of an array Description array array_flip (array array) Array_flip() returns an array where keys and values are flipped. Note that this function works only with string and integer values Example 1. Array_flip() $input = array ( "red", "green", "green" ); $result = array_flip ($input); This makes $result have array ( "red" => 0, "green" => 2 );. Note that "green" in result is unique (see Array()). See also Array_unique() and array_reverse(). **** snip *** 3.) COMETICS 1: Question to examples in general: The examples (throughout the whole phpdoc) are often stated like "<example> <title><function>Array_flip</function> example</title>", what makes in the manual "Example 1. Array_flip() example". Isn't that off-putting to the reader? Is that based on a special thought behind, or would it be better to delete/rename the "extra-example"? 4.) COSMETICS 2: The parameter-names are inconsistent: sometimes, we have function (array array), function (array arr), function (array input) Should I unify this? If everybody agrees on some or all of these (or new/better) suggestions, let me know, and I'll provide the adapted array.xml that somebody can commit it. best regards, Thomas