test: add back async function quux test with forceRequireReturn (keeping the one with forceReturnsWithAsync as well)

test: add passing test for `forceReturnsWithAsync` on non-async function without requires
docs: grammar nit

Author: brettz9

.README/rules/require-returns.md

@@ -2,7 +2,7 @@
 
 Requires returns are documented.
 
-By default `async` functions that do not explicitly return a value pass this rule. You can force all `async` functions to require return statements by setting `forceReturnsWithAsync` as true on the options object. This maybe useful as an `async` function will always return a Promise, even if the Promise returns void.
+By default `async` functions that do not explicitly return a value pass this rule. You can force all `async` functions to require return statements by setting `forceReturnsWithAsync` as true on the options object. This may be useful as an `async` function will always return a Promise, even if the Promise returns void.
 
 ```js
 'jsdoc/require-jsdoc': ['error', {forceReturnsWithAsync: true}]

README.md

@@ -4564,7 +4564,7 @@ function quux () {
 
 Requires returns are documented.
 
-By default `async` functions that do not explicitly return a value pass this rule. You can force all `async` functions to require return statements by setting `forceReturnsWithAsync` as true on the options object. This maybe useful as an `async` function will always return a Promise, even if the Promise returns void.
+By default `async` functions that do not explicitly return a value pass this rule. You can force all `async` functions to require return statements by setting `forceReturnsWithAsync` as true on the options object. This may be useful as an `async` function will always return a Promise, even if the Promise returns void.
 
 ```js
 'jsdoc/require-jsdoc': ['error', {forceReturnsWithAsync: true}]
@@ -4642,6 +4642,13 @@ const quux = async () => {}
 // Settings: {"jsdoc":{"forceRequireReturn":true}}
 // Message: Missing JSDoc @returns declaration.
 
+/**
+*
+*/
+async function quux () {}
+// Settings: {"jsdoc":{"forceRequireReturn":true}}
+// Message: Missing JSDoc @returns declaration.
+
 /**
  *
  */
@@ -4915,6 +4922,13 @@ class foo {
 }
 
 export default foo;
+
+/**
+ *
+ */
+function quux () {
+}
+// Options: [{"forceReturnsWithAsync":true}]
 ````
 
 

test/rules/assertions/requireReturns.js

@@ -152,6 +152,28 @@ export default {
         }
       }
     },
+    {
+      code: `
+          /**
+           *
+           */
+           async function quux () {}
+      `,
+      errors: [
+        {
+          line: 2,
+          message: 'Missing JSDoc @returns declaration.'
+        }
+      ],
+      parserOptions: {
+        ecmaVersion: 8
+      },
+      settings: {
+        jsdoc: {
+          forceRequireReturn: true
+        }
+      }
+    },
     {
       code: `
           /**
@@ -605,6 +627,18 @@ export default {
       parserOptions: {
         sourceType: 'module'
       }
+    },
+    {
+      code: `
+          /**
+           *
+           */
+          function quux () {
+          }
+      `,
+      options: [{
+        forceReturnsWithAsync: true
+      }]
     }
   ]
 };