Description: ------------ PHPDoc allows you to describe optional infinite @params that function may accept, but that do not appear in the function signature. When using the PEAR code standard, the sniffer throws an error every time you include too many parameters, regardless of trailing dots. I can imagine a temporary fix would simply check for the ",..." at the end of the variable name, but you would also need to check that the optional parameter is the last variable defined. Any variables defined after it should also produce an error. Test script: --------------- See example at http://manual.phpdoc.org/HTMLframesConverter/default/phpDocumentor/tutorial_tags.param.pkg.html Expected result: ---------------- No output Actual result: -------------- 70 | ERROR | Superfluous doc comment at position 3

Added patch FunctionCommentSniff.diff.

Any movement on this..? It's been over a year and a half...

Better late than never I hope. Patch is slightly different, but think it still works. Commit is here: https://github.com/squizlabs/PHP_CodeSniffer/commit/303a5a45c90200209881787f3 935fa530599f9a1