Re: [PHP-DOC] Re: cvs: phpdoc /en/reference/array/functions natsort.xml

[M. Sokolewicz]

Gabor Hojtsy wrote:
I think we should convert all to the 2nd type, it's just clearer...!
any comments?:)

No, because the function definitions make sure which arguments are 
passed by reference. There is no need to even know this sort of 
information.

Users need to know where they need to pass a variable (as opposed to 
passing only a value), and what function modifies the passed parameter 
(as opposed to returning the resulting value).

Goba
Right, I agree with Gabor on this, users should indeed see, in just one 
quick look, which variables might/will be altered by running that 
function. It also helps people intuitivly understand how certain 
functions "work", iow how to get a useful return from it.