Description:
------------
The Returning References manual page contains the following comment:

"Note:  Unlike parameter passing, here you have to use & in both places - to indicate that you return by-reference, not a copy as usual, and to indicate that reference binding, rather than usual assignment, should be done for $foo."

It refers to pass-by-reference, where you have to use the ampersand in both the function *and* in the assignment of the function value to a variable.

It is not clear what would happen if you didn't put the ampersand in both places, and it would be nice to have someone explain this.

I'm a fairly seasoned PHP developer, but references are complex, and judging by the user comments in various places in the manual concerning them I think it would be great to have a sentance or two clarify this.

I know it's only a minor request, but for developers seeking to fine-tune their code, understanding references is clearly the way to go.

Thanks, Scott.