Have an example of function with JsDoc:

    /**
     * Adds an option to a select
     * @param object $sourceOption A jQuerified option object
     * @param string target Name of the target select: 'left' or 'right'
     * @param boolean ignoreIndex If true, the index will not be use to
     *                              determine the order of the options.
     **/
    function addSelectOption($sourceOption, target, ignoreIndex) {
    }

on the function declaration line is hint Undocumented Parameters ....., but the real problem is that the documentation has wrong form. The right form should be 

* @param {object} $sourceOption A jQuerified option object

There should be hint that will check it.