fix HeadLink docblock method declaration hints

[stefanotorresi]

IDEs were complaining about missing arguments which are actually optional.

[Maks3w]

Is this compatible with PHPDoc definition?

[stefanotorresi]

To be honest I don't know, I gave a look at PHPDoc reference but couldn't find anything about default arguments in @method. You can specify argument types tho, so I guess it should work.

[Ocramius]

@mvriel do you know if @method foo bar($baz = 'tab') works?

[mvriel]

@Ocramius currently the syntax for the @method tag does not explicitly allow for default values (http://www.phpdoc.org/docs/latest/references/phpdoc/tags/method.html).

I can however see how this would be beneficial and would warrant a change in the PHPDoc definition; can you or @stefanotorresi open an issue in the phpDocumentor/phpDocumentor2 repository to allow default values on @method tags?

[Ocramius]

@mvriel thanks for looking into it! I was looking in the code but couldn't find any hints, so I will indeed open an issue.

[weierophinney]

Will wait to merge until phpDocumentor/phpDocumentor#1194 is closed.

[Ocramius]

Will be included in PhpDocumentor 2.6. Merging here.