Remove & in phpdoc

[VincentLanglet]

Some tools like phpstan/phpdoc-parser doesn't support @param int &$consumed syntax.
By removing the &, it would allow phpstan to better understand stubs provided by phpstorm.

Also it's useless as the & is already present in the native signature and it's not in the standard either: https://docs.phpdoc.org/latest/guide/references/phpdoc/tags/param.html

Ref: phpstan/phpstan#5636 (comment)

[DmitryTronin]

I dug this a bit and found why the &'s are there.
They was added a year ago: #892. While working on this, a PR to support & in PHPDocs was created & accepted: phpDocumentor/ReflectionDocBlock#254 so, technically, PHPDocs are supporting this.
I would appreciate if @voku could comment here describing why the &$ syntax in PHPDocs isn't "useless". Unfortunately I can't recall any of these usages right now.

[VincentLanglet]

For the record, I added the &$ syntax to the phpstan/parser phpstan/phpdoc-parser#83 so I don't know if this PR is still necessary (it should at least not be needed for phpstan).

[DmitryTronin]

Thanks for the update. We'll leave our stubs unchanged then.