[PHP-DOC] about array.xml

[Gyozo Papp]

I've translated the array.xml into Hungarian recently and I found
some documentaion issue in the file with revision 1.147.

1) two aliases are documented:
 pos()
 sizeof()

2) array_unique is working differenly as documented:
 it has been reported as a bug, too:
 http://bugs.php.net/?id=14805

 array_unique preserves the latest key and not the first in 4.0.6,
 but the manual states the opposite. (This part of the bug report
 may be a documentation issue.)

The followings are only remarks for 'look and feel better':

3) usort() (line 3585-3588)
 this para describes exactly what is in &note.func-callback;
 except that it points to the 3rd examples. 
 Why not remove it and put a &note.func-callback; immidiately
 before the 3rd example?

4) The example results displayed in various ways, in comments within
programlisting or a successive para element or simply omitted, but
in several function page it appears in a screen (or a separate 
programlisting) element.

The results of programlistings code appear
in comments:
 + array_count_values
   array_flip
   array_fill
   array_keys
 + array_map 
   array_pad
   array_splice
   array_sum
 + array_unique
   array_values
 + in_array
   count

in text (within a para element): 
 array_diff
 array_filter
 array_intersect
 array_merge
 * array_merge_recursive
 array_pop
 array_push
 * array_rerverse
 array_reduce
 array_shift
 array_unshift
 compact
 each

+ means that echo, var_dump() or print_r() is also used on the 
affected variables
* indicates that it may be reasonable as the result is part of a 
longer explanation.

5) there is colon in the para 'See also' of the following:
(corresponding line numbers in paranthesis. 
 Note that I used rev 1.147)
 arsort (2507)
 array_push (1272)
 current (2296)
 end (2426)
 extract (2591)
 next (3069)
 pos  (3093)
 prev (3132)
 reset (3228) 
 rsort (3291)
 sort  (3434)
 uasort (3480)
 uksort  (3548)
 usort (3733)

Additionally:
 krsort - a space missing between 'natsort</function>' 
  and  'and' (2788)
 array_map (904) and array_reduce (1441) - missing ', and' 

I am able to make most of the changes (expect the one related
to the bug 14805), but I need your confirmation as I'm also 
not an old pro in phpdoc :)

-- 
Papp Gyozo
- [EMAIL PROTECTED]