Is there a PHPDoc standard to describe function attributes passed by reference?

Question

I have a function which uses an attribute passed as reference:

public function doSomething(&$argumentPassedByReference)
{
    // ...
}

I maintain the PHPDoc of my project, so I described my function like this:

/**
 * Do something very useful with the thing passed in parameters
 *
 * @param Type $argumentPassedByReference Thing that will be edited
 */
public function doSomething(&$argumentPassedByReference)

But I'm not really satisfied because it doesn't show that $argumentPassedByReference is passed by reference. Is there a standard in PHPDoc to describe this?

Answer 1

Add the ampersand as in the function definition:

 /**
 * Do something very useful with the thing passed in parameters
 *
 * @param Type &$argumentPassedByReference Thing that will be edited
 */