Add DocComments for function parameters

[chschneider]

This PR implements DocComment support for function parameters as proposed in
https://wiki.php.net/rfc/parameter-doccomments

[mvorisek]

Even if this harder to read syntax would be used, the return type/value cannot be commented. I personally do not support this feature.

[DanielEScherzer]

looking better

[TimWolla]

@chschneider Can you give this PR a fresh rebase onto the latest master to ensure the CI is current?

[TimWolla]

Can you add a test case for:

<?php

class Foo {
    public function __construct(
        /** $foo */
        public string $foo {
            /** setter */
            set(string $value /** $value */) {
                
            }
        }
    ) {}
}

to ensure that all the doc comments are correctly assigned if there's a property hook for constructor property promotion? The /** $foo */ should probably be applied to both the property and the parameter 🤔

[TimWolla]

@chschneider I've took the liberty to push one commit into your branch to add additional property hook test cases and simplify the implementation. The behavior is now consistent with properties where the doc comment needs to appear before the hooks (because there is no final delimiter for hooked properties).

Please double-check if you agree with that change.

[chschneider]

@chschneider I've took the liberty to push one commit into your branch to add additional property hook test cases and simplify the implementation. The behavior is now consistent with properties where the doc comment needs to appear before the hooks (because there is no final delimiter for hooked properties).

I like the simplification, looks good to me, thanks.