Fix: dont stick IIFE with outpadded docblock

Fixes #176

Author: qfox

lib/rules/validate-jsdoc.js

@@ -240,7 +240,7 @@ function patchNodesInFile(file) {
 
         var node = functionNodeTypes.indexOf(this.type) !== -1 ?
             findFirstNodeInLine(this) : this;
-        var res = findDocCommentBeforeNode(node);
+        var res = findDocCommentBeforeNode(node, this);
 
         this._jsdoc = res ? jsdoc.createDocCommentByCommentNode(res) : null;
 
@@ -267,13 +267,25 @@ function patchNodesInFile(file) {
      * @param {?module:esprima/Node} node
      * @returns {?module:esprima/Node}
      */
-    function findDocCommentBeforeNode(node) {
+    function findDocCommentBeforeNode(node, self) {
         var res = file.getPrevToken(file.getFirstNodeToken(node), {includeComments: true});
-        if (res && res.type === 'Block' && res.value.charAt(0) === '*' &&
-            res.loc.start.column === node.loc.start.column) {
-            return res;
+        if (!res || res.type !== 'Block' || res.value.charAt(0) !== '*') {
+            return null;
         }
-        return null;
+
+        // Indent should be the same
+        if (res.loc.start.column !== node.loc.start.column) {
+            return null;
+        }
+
+        // IIFE should be on the next line to be sticked
+        if ((self.type === 'FunctionExpression' || self.type === 'ArrowFunctionExpression') &&
+            self.parentNode.type === 'CallExpression' &&
+            (self.loc.start.line > res.loc.end.line + 2)) {
+            return null;
+        }
+
+        return res;
     }
 
     // mark object as patched

test/lib/rules/validate-jsdoc.js

@@ -72,6 +72,21 @@ describe('lib/rules/validate-jsdoc', function () {
                     function foo () {}
                 },
                 errors: 1
+            }, {
+                it: 'should not stick docblock to IIFE #176',
+                rules: {enforceExistence: true},
+                code: function() {
+                    /**
+                     * Descriptive description of bar.
+                     *
+                     * @method bar
+                     * @param x
+                     */
+
+                    ( function ( $ ) {
+                        // dummy
+                    }( jQuery ) );
+                }
             }
             /* jshint ignore:end */
         ]);