Merge pull request #66 from zxqfox/hotfix/skip-dotted-params

checkParamNames: skip dotted params (as it was initially)

Author: qfox

lib/rules/validate-jsdoc/check-param-names.js

@@ -26,6 +26,7 @@ function validateCheckParamNames(node, err) {
         }
     });
     var outOfOrder = {};
+    var skipped = 0;
 
     node.jsdoc.iterateByType(['param', 'arg', 'argument'],
         /**
@@ -39,12 +40,17 @@ function validateCheckParamNames(node, err) {
                 return err('missing param name', tag.loc);
             }
 
-            var param = node.params[i];
+            var param = node.params[i - skipped];
             if (!param) {
                 // skip if no param
                 return;
             }
 
+            if (tag.value.indexOf('.') !== -1) {
+                skipped++;
+                return;
+            }
+
             // checking name
             var msg;
             if (tag.name.value !== param.name && !outOfOrder[tag.name.value]) {

test/lib/rules/validate-jsdoc/check-param-names.js

@@ -256,6 +256,20 @@ describe('lib/rules/validate-jsdoc/check-param-names', function() {
                      */
                     function methodThree(required, optional) {}
                 }
+            }, {
+                it: 'should not report dotted param names',
+                code: function() {
+                    /**
+                     * Declares modifier
+                     * @param {Object} mod
+                     * @param {String} mod.modName
+                     * @param {String|Boolean|Array} [mod.modVal]
+                     * @param {Object} props
+                     * @param {Object} [staticProps]
+                     * @returns {Function}
+                     */
+                    function yeah(mod, props, staticProps) {}
+                }
             }
             /* jscs: enable */
             /* jshint ignore:end */