fix: requireReturns Rule does not honor inheritdoc tag (fixes #153)

RequireReturns Rule does not honor inheritdoc tag.

Author: gajus

src/rules/requireReturns.js

@@ -6,6 +6,14 @@ export default iterateJsdoc(({
   report,
   utils
 }) => {
+  // inheritdoc implies that all documentation is inherited
+  // see http://usejsdoc.org/tags-inheritdoc.html
+  //
+  // As we do not know the parent method, we cannot perform any checks.
+  if (utils.hasTag('inheritdoc')) {
+    return;
+  }
+
   const targetTagName = utils.getPreferredTagName('returns');
 
   const jsdocTags = _.filter(jsdoc.tags, {

test/rules/assertions/requireReturns.js

@@ -138,6 +138,16 @@ export default {
            */
           const quux = (bar) => bar.filter(({ corge }) => corge())
       `
+    },
+    {
+      code: `
+          /**
+           * @inheritdoc
+           */
+          function quux (foo) {
+            return "test"
+          }
+      `
     }
   ]
 };