Re: Re: cvs: phpdoc /en/reference/array/functions natsort.xml

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.