Description:
------------
The documentation for array_diff() is a bit ambiguous in the "Description" section.

Quote: "Compares array1 against array2 and returns the difference."

While the statement is technically true, it is not until the "Return Values" section that the documentation clarifies that excess values in 'array2' will not be returned as well.

At a quick glance, if the description matches desired action the "Return Values" section may never be viewed to clarify the ambiguity from the description.

My recommendation would be to change the description to something like, " Compares array1 against array2 and returns the values from array1 which are not found in array2."

This makes it immediately clear that the values returned will not include non-matching values found in array2. Granted, the confusion could be blamed on the developer for not reviewing the entire documentation, but I am certain I am not the only person that will use a function based on the description matching the desired affect not expecting the description to be ambiguous.

Thanks!