eslint-plugin-jsdoc 41.1.1 → 42.0.0

package/README.md

@@ -42,7 +42,6 @@ JSDoc linting rules for ESLint.
         * [`match-description`](#user-content-eslint-plugin-jsdoc-rules-match-description)
         * [`match-name`](#user-content-eslint-plugin-jsdoc-rules-match-name)
         * [`multiline-blocks`](#user-content-eslint-plugin-jsdoc-rules-multiline-blocks)
-        * [`newline-after-description`](#user-content-eslint-plugin-jsdoc-rules-newline-after-description)
         * [`no-bad-blocks`](#user-content-eslint-plugin-jsdoc-rules-no-bad-blocks)
         * [`no-blank-block-descriptions`](#user-content-eslint-plugin-jsdoc-rules-no-blank-block-descriptions)
         * [`no-defaults`](#user-content-eslint-plugin-jsdoc-rules-no-defaults)
@@ -130,10 +129,11 @@ Finally, enable all of the rules that you would like to use.
         "jsdoc/check-values": 1, // Recommended
         "jsdoc/empty-tags": 1, // Recommended
         "jsdoc/implements-on-classes": 1, // Recommended
+        "jsdoc/informative-docs": 1,
         "jsdoc/match-description": 1,
         "jsdoc/multiline-blocks": 1, // Recommended
-        "jsdoc/newline-after-description": 1, // Recommended
         "jsdoc/no-bad-blocks": 1,
+        "jsdoc/no-blank-block-descriptions": 1,
         "jsdoc/no-defaults": 1,
         "jsdoc/no-missing-syntax": 1,
         "jsdoc/no-multi-asterisks": 1, // Recommended
@@ -9212,247 +9212,6 @@ The following patterns are not considered problems:
 ````
 
 
-<a name="user-content-eslint-plugin-jsdoc-rules-newline-after-description"></a>
-<a name="eslint-plugin-jsdoc-rules-newline-after-description"></a>
-### <code>newline-after-description</code>
-
-Enforces a consistent padding of the block description.
-
-<a name="user-content-eslint-plugin-jsdoc-rules-newline-after-description-options-15"></a>
-<a name="eslint-plugin-jsdoc-rules-newline-after-description-options-15"></a>
-#### Options
-
-This rule allows one optional string argument. If it is `"always"` then a
-problem is raised when there is no newline after the description. If it is
-`"never"` then a problem is raised when there is a newline after the
-description. The default value is `"always"`.
-
-|||
-|---|---|
-|Context|everywhere|
-|Tags|N/A (doc block)|
-|Options|(a string matching `"always" or "never"`)|
-|Recommended|true|
-
-The following patterns are considered problems:
-
-````js
-/**
- * Foo.
- *
- * Foo.
- * @foo
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-// Message: There must be a newline after the description of the JSDoc block.
-
-/**
- * Foo.
- * @foo
- *
- * Foo.
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-// Message: There must be a newline after the description of the JSDoc block.
-
-/**
- * Foo.
- *
- * Foo.
- * @foo
- */
-function quux () {
-
-}
-// Message: There must be a newline after the description of the JSDoc block.
-
-/**
- * Bar.
- *
- * Bar.
- *
- * @bar
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-// Message: There must be no newline after the description of the JSDoc block.
-
-/**
- * Bar.
- *
- * @bar
- *
- * Bar.
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-// Message: There must be no newline after the description of the JSDoc block.
-
-
-         /**\r
-          * Bar.\r
-          *\r
-          * Bar.\r
-          *\r
-          * @bar\r
-          */\r
-         function quux () {\r
-
-         }
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-// Message: There must be no newline after the description of the JSDoc block.
-
-/**
- * A.
- *
- * @typedef {object} A
- * @prop {boolean} a A.
- */
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-// Message: There must be no newline after the description of the JSDoc block.
-
-/**
- * A.
- * @typedef {object} A
- * @prop {boolean} a A.
- */
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-// Message: There must be a newline after the description of the JSDoc block.
-
-
-     /**\r
-      * Service for fetching symbols.\r
-      * @param {object} $http - Injected http helper.\r
-      * @param {object} $q - Injected Promise api helper.\r
-      * @param {object} $location - Injected window location object.\r
-      * @param {object} REPORT_DIALOG_CONSTANTS - Injected handle.\r
-      */
-// Message: There must be a newline after the description of the JSDoc block.
-
-/** An example function.
- *
- * @returns {number} An example number.
- */
-function example() {
-  return 42;
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-// Message: There must be no newline after the description of the JSDoc block.
-
-/** An example function.
- * @returns {number} An example number.
- */
-function example() {
-  return 42;
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-// Message: There must be a newline after the description of the JSDoc block.
-````
-
-The following patterns are not considered problems:
-
-````js
-/**
- * Foo.
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-
-/**
- * Bar.
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-
-/**
- * Foo.
- *
- * @foo
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-
-/**
- * Bar.
- * @bar
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-
-
-     /**\r
-      * @foo\r
-      * Test \r
-      * abc \r
-      * @bar \r
-      */
-
-
-     /**\r
-      * \r
-      * @foo\r
-      * Test \r
-      * abc \r
-      * @bar \r
-      */
-
-/***
- *
- */
-function quux () {
-
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "always"]
-
-/**\r
- * Parses query string to object containing URL parameters\r
- * \r
- * @param queryString\r
- * Input string\r
- * \r
- * @returns\r
- * Object containing URL parameters\r
- */\r
-export function parseQueryString(queryString: string): { [key: string]: string } {    // <-- Line 10 that fails\r
-
-}
-
-/** An example function.
- *
- * @returns {number} An example number.
- */
-function example() {
-  return 42;
-}
-
-/** An example function.
- * @returns {number} An example number.
- */
-function example() {
-  return 42;
-}
-// "jsdoc/newline-after-description": ["error"|"warn", "never"]
-````
-
-
 <a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks"></a>
 <a name="eslint-plugin-jsdoc-rules-no-bad-blocks"></a>
 ### <code>no-bad-blocks</code>
@@ -9463,14 +9222,14 @@ asterisks, but which appear to be intended as jsdoc blocks due to the presence
 of whitespace followed by whitespace or asterisks, and
 an at-sign (`@`) and some non-whitespace (as with a jsdoc block tag).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-16"></a>
-<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-16"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-15"></a>
+<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-15"></a>
 #### Options
 
 Takes an optional options object with the following.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-16-ignore"></a>
-<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-16-ignore"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-15-ignore"></a>
+<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-15-ignore"></a>
 ##### <code>ignore</code>
 
 An array of directives that will not be reported if present at the beginning of
@@ -9479,8 +9238,8 @@ a multi-comment block and at-sign `/* @`.
 Defaults to `['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck']`
 (some directives [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-16-preventallmultiasteriskblocks"></a>
-<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-16-preventallmultiasteriskblocks"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-bad-blocks-options-15-preventallmultiasteriskblocks"></a>
+<a name="eslint-plugin-jsdoc-rules-no-bad-blocks-options-15-preventallmultiasteriskblocks"></a>
 ##### <code>preventAllMultiAsteriskBlocks</code>
 
 A boolean (defaulting to `false`) which if `true` will prevent all
@@ -9692,12 +9451,12 @@ tag is attached).
 Unless your `@default` is on a function, you will need to set `contexts`
 to an appropriate context, including, if you wish, "any".
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-17"></a>
-<a name="eslint-plugin-jsdoc-rules-no-defaults-options-17"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-16"></a>
+<a name="eslint-plugin-jsdoc-rules-no-defaults-options-16"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-17-nooptionalparamnames"></a>
-<a name="eslint-plugin-jsdoc-rules-no-defaults-options-17-nooptionalparamnames"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-16-nooptionalparamnames"></a>
+<a name="eslint-plugin-jsdoc-rules-no-defaults-options-16-nooptionalparamnames"></a>
 ##### <code>noOptionalParamNames</code>
 
 Set this to `true` to report the presence of optional parameters. May be
@@ -9706,8 +9465,8 @@ the presence of ES6 default parameters (bearing in mind that such
 "defaults" are only applied when the supplied value is missing or
 `undefined` but not for `null` or other "falsey" values).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-17-contexts-3"></a>
-<a name="eslint-plugin-jsdoc-rules-no-defaults-options-17-contexts-3"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-16-contexts-3"></a>
+<a name="eslint-plugin-jsdoc-rules-no-defaults-options-16-contexts-3"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -9893,12 +9652,12 @@ which are not adequate to satisfy a condition, e.g.,
 not report if there were only a function declaration of the name "ignoreMe"
 (though it would report by function declarations of other names).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-missing-syntax-options-18"></a>
-<a name="eslint-plugin-jsdoc-rules-no-missing-syntax-options-18"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-missing-syntax-options-17"></a>
+<a name="eslint-plugin-jsdoc-rules-no-missing-syntax-options-17"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-missing-syntax-options-18-contexts-4"></a>
-<a name="eslint-plugin-jsdoc-rules-no-missing-syntax-options-18-contexts-4"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-missing-syntax-options-17-contexts-4"></a>
+<a name="eslint-plugin-jsdoc-rules-no-missing-syntax-options-17-contexts-4"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -10114,12 +9873,12 @@ Note that if you wish to prevent multiple asterisks at the very beginning of
 the jsdoc block, you should use `no-bad-blocks` (as that is not proper jsdoc
 and that rule is for catching blocks which only seem like jsdoc).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18"></a>
+<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-allowwhitespace-defaults-to-false"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-allowwhitespace-defaults-to-false"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-allowwhitespace-defaults-to-false"></a>
+<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-allowwhitespace-defaults-to-false"></a>
 ##### <code>allowWhitespace</code> (defaults to <code>false</code>)
 
 Set to `true` if you wish to allow asterisks after a space (as with Markdown):
@@ -10130,8 +9889,8 @@ Set to `true` if you wish to allow asterisks after a space (as with Markdown):
  */
 ```
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-preventatmiddlelines-defaults-to-true"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-preventatmiddlelines-defaults-to-true"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-preventatmiddlelines-defaults-to-true"></a>
+<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-preventatmiddlelines-defaults-to-true"></a>
 ##### <code>preventAtMiddleLines</code> (defaults to <code>true</code>)
 
 Prevent the likes of this:
@@ -10143,8 +9902,8 @@ Prevent the likes of this:
  */
 ```
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-preventatend-defaults-to-true"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-19-preventatend-defaults-to-true"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-preventatend-defaults-to-true"></a>
+<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-preventatend-defaults-to-true"></a>
 ##### <code>preventAtEnd</code> (defaults to <code>true</code>)
 
 Prevent the likes of this:
@@ -10379,12 +10138,12 @@ structures, (whether or not you add a specific `comment` condition).
 Note that if your parser supports comment AST (as [jsdoc-eslint-parser](https://github.com/brettz9/jsdoc-eslint-parser)
 is designed to do), you can just use ESLint's rule.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-restricted-syntax-options-20"></a>
-<a name="eslint-plugin-jsdoc-rules-no-restricted-syntax-options-20"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-restricted-syntax-options-19"></a>
+<a name="eslint-plugin-jsdoc-rules-no-restricted-syntax-options-19"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-restricted-syntax-options-20-contexts-5"></a>
-<a name="eslint-plugin-jsdoc-rules-no-restricted-syntax-options-20-contexts-5"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-restricted-syntax-options-19-contexts-5"></a>
+<a name="eslint-plugin-jsdoc-rules-no-restricted-syntax-options-19-contexts-5"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -10709,12 +10468,12 @@ This rule reports types being used on `@param` or `@returns`.
 The rule is intended to prevent the indication of types on tags where
 the type information would be redundant with TypeScript.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-types-options-21"></a>
-<a name="eslint-plugin-jsdoc-rules-no-types-options-21"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-types-options-20"></a>
+<a name="eslint-plugin-jsdoc-rules-no-types-options-20"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-types-options-21-contexts-6"></a>
-<a name="eslint-plugin-jsdoc-rules-no-types-options-21-contexts-6"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-types-options-20-contexts-6"></a>
+<a name="eslint-plugin-jsdoc-rules-no-types-options-20-contexts-6"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -10888,8 +10647,8 @@ reporting on use of that namepath elsewhere) and/or that a tag's `type` is
 `false` (and should not be checked for types). If the `type` is an array, that
 array's items will be considered as defined for the purposes of that tag.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-no-undefined-types-options-22"></a>
-<a name="eslint-plugin-jsdoc-rules-no-undefined-types-options-22"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-undefined-types-options-21"></a>
+<a name="eslint-plugin-jsdoc-rules-no-undefined-types-options-21"></a>
 #### Options
 
 An option object may have the following key:
@@ -11557,8 +11316,8 @@ class Foo {
 
 Requires that each JSDoc line starts with an `*`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-23"></a>
-<a name="eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-23"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-22"></a>
+<a name="eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-22"></a>
 #### Options
 
 This rule allows an optional string argument. If it is `"always"` then a
@@ -11569,8 +11328,8 @@ and use the `tags` option to apply to specific tags only.
 
 After the string option, one may add an object with the following.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-23-tags-3"></a>
-<a name="eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-23-tags-3"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-22-tags-3"></a>
+<a name="eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-22-tags-3"></a>
 ##### <code>tags</code>
 
 If you want different values to apply to specific tags, you may use
@@ -11854,12 +11613,12 @@ If sentences do not end with terminal punctuation, a period will be added.
 If sentences do not start with an uppercase character, the initial
 letter will be capitalized.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-tags-4"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-tags-4"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-tags-4"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-tags-4"></a>
 ##### <code>tags</code>
 
 If you want additional tags to be checked for their descriptions, you may
@@ -11883,16 +11642,16 @@ its "description" (e.g., for `@returns {someType} some description`, the
 description is `some description` while for `@some-tag xyz`, the description
 is `xyz`).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-abbreviations"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-abbreviations"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-abbreviations"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-abbreviations"></a>
 ##### <code>abbreviations</code>
 
 You can provide an `abbreviations` options array to avoid such strings of text
 being treated as sentence endings when followed by dots. The `.` is not
 necessary at the end of the array items.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-newlinebeforecapsassumesbadsentenceend"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-24-newlinebeforecapsassumesbadsentenceend"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-newlinebeforecapsassumesbadsentenceend"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-newlinebeforecapsassumesbadsentenceend"></a>
 ##### <code>newlineBeforeCapsAssumesBadSentenceEnd</code>
 
 When `false` (the new default), we will not assume capital letters after
@@ -12633,8 +12392,8 @@ Requires that all functions have a description.
   is `"tag"`) must have a non-empty description that explains the purpose of
   the method.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-description-options-25"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-options-25"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-options-24"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-options-24"></a>
 #### Options
 
 An options object may have any of the following properties:
@@ -13195,14 +12954,14 @@ Requires that all functions have examples.
 * Every example tag must have a non-empty description that explains the
   method's usage.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25"></a>
 #### Options
 
 This rule has an object option.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-exemptedby"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-exemptedby"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-exemptedby"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-exemptedby"></a>
 ##### <code>exemptedBy</code>
 
 Array of tags (e.g., `['type']`) whose presence on the document
@@ -13211,15 +12970,15 @@ block avoids the need for an `@example`. Defaults to an array with
 so be sure to add back `inheritdoc` if you wish its presence to cause
 exemption of the rule.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-exemptnoarguments"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-exemptnoarguments"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-exemptnoarguments"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-exemptnoarguments"></a>
 ##### <code>exemptNoArguments</code>
 
 Boolean to indicate that no-argument functions should not be reported for
 missing `@example` declarations.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-contexts-7"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-contexts-7"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-contexts-7"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-contexts-7"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -13231,27 +12990,27 @@ want the rule to apply to any jsdoc block throughout your files.
 See the ["AST and Selectors"](#user-content-eslint-plugin-jsdoc-advanced-ast-and-selectors)
 section of our README for more on the expected format.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-checkconstructors"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-checkconstructors"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-checkconstructors"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checkconstructors"></a>
 ##### <code>checkConstructors</code>
 
 A value indicating whether `constructor`s should be checked.
 Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-checkgetters"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-checkgetters"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-checkgetters"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checkgetters"></a>
 ##### <code>checkGetters</code>
 
 A value indicating whether getters should be checked. Defaults to `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-checksetters"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-checksetters"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-checksetters"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checksetters"></a>
 ##### <code>checkSetters</code>
 
 A value indicating whether setters should be checked. Defaults to `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-enablefixer-3"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-26-enablefixer-3"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-25-enablefixer-3"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-25-enablefixer-3"></a>
 ##### <code>enableFixer</code>
 
 A boolean on whether to enable the fixer (which adds an empty `@example` block).
@@ -13564,12 +13323,12 @@ Checks that:
   as being when the overview tag is not preceded by anything other than
   a comment.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-file-overview-options-27"></a>
-<a name="eslint-plugin-jsdoc-rules-require-file-overview-options-27"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-file-overview-options-26"></a>
+<a name="eslint-plugin-jsdoc-rules-require-file-overview-options-26"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-file-overview-options-27-tags-5"></a>
-<a name="eslint-plugin-jsdoc-rules-require-file-overview-options-27-tags-5"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-file-overview-options-26-tags-5"></a>
+<a name="eslint-plugin-jsdoc-rules-require-file-overview-options-26-tags-5"></a>
 ##### <code>tags</code>
 
 The keys of this object are tag names, and the values are configuration
@@ -13853,8 +13612,8 @@ function quux () {
 
 Requires (or disallows) a hyphen before the `@param` description.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-hyphen-before-param-description-options-28"></a>
-<a name="eslint-plugin-jsdoc-rules-require-hyphen-before-param-description-options-28"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-hyphen-before-param-description-options-27"></a>
+<a name="eslint-plugin-jsdoc-rules-require-hyphen-before-param-description-options-27"></a>
 #### Options
 
 This rule takes one optional string argument and an optional options object.
@@ -14086,14 +13845,14 @@ function main(argv) {
 Checks for presence of jsdoc comments, on class declarations as well as
 functions.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28"></a>
 #### Options
 
 Accepts one optional options object with the following optional keys.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-publiconly"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-publiconly"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-publiconly"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-publiconly"></a>
 ##### <code>publicOnly</code>
 
 This option will insist that missing jsdoc blocks are only reported for
@@ -14109,8 +13868,8 @@ otherwise noted):
 - `cjs` - CommonJS exports are checked for JSDoc comments  (Defaults to `true`)
 - `window` - Window global exports are checked for JSDoc comments
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-require"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-require"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-require"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-require"></a>
 ##### <code>require</code>
 
 An object with the following optional boolean keys which all default to
@@ -14123,8 +13882,8 @@ An object with the following optional boolean keys which all default to
 - `FunctionExpression`
 - `MethodDefinition`
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-contexts-8"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-contexts-8"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-contexts-8"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-contexts-8"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings or objects representing the additional AST
@@ -14141,8 +13900,8 @@ if you are specifying a more precise form in `contexts` (e.g., `MethodDefinition
 See the ["AST and Selectors"](#user-content-eslint-plugin-jsdoc-advanced-ast-and-selectors)
 section of our README for more on the expected format.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-exemptemptyconstructors"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-exemptemptyconstructors"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyconstructors"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyconstructors"></a>
 ##### <code>exemptEmptyConstructors</code>
 
 Default: true
@@ -14151,8 +13910,8 @@ When `true`, the rule will not report missing jsdoc blocks above constructors
 with no parameters or return values (this is enabled by default as the class
 name or description should be seen as sufficient to convey intent).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-exemptemptyfunctions"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-exemptemptyfunctions"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyfunctions"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyfunctions"></a>
 ##### <code>exemptEmptyFunctions</code>
 
 Default: false.
@@ -14161,16 +13920,16 @@ When `true`, the rule will not report missing jsdoc blocks above
 functions/methods with no parameters or return values (intended where
 function/method names are sufficient for themselves as documentation).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checkconstructors-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checkconstructors-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkconstructors-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkconstructors-1"></a>
 ##### <code>checkConstructors</code>
 
 A value indicating whether `constructor`s should be checked. Defaults to
 `true`. When `true`, `exemptEmptyConstructors` may still avoid reporting when
 no parameters or return values are found.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checkgetters-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checkgetters-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkgetters-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkgetters-1"></a>
 ##### <code>checkGetters</code>
 
 A value indicating whether getters should be checked. Besides setting as a
@@ -14179,8 +13938,8 @@ getters should be checked but only when there is no setter. This may be useful
 if one only wishes documentation on one of the two accessors. Defaults to
 `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checksetters-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-checksetters-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checksetters-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checksetters-1"></a>
 ##### <code>checkSetters</code>
 
 A value indicating whether setters should be checked. Besides setting as a
@@ -14189,15 +13948,15 @@ setters should be checked but only when there is no getter. This may be useful
 if one only wishes documentation on one of the two accessors. Defaults to
 `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-enablefixer-4"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-enablefixer-4"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-enablefixer-4"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-enablefixer-4"></a>
 ##### <code>enableFixer</code>
 
 A boolean on whether to enable the fixer (which adds an empty jsdoc block).
 Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-minlinecount"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-minlinecount"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-28-minlinecount"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-minlinecount"></a>
 ##### <code>minLineCount</code>
 
 An integer to indicate a minimum number of lines expected for a node in order
@@ -15889,12 +15648,12 @@ Will exempt destructured roots and their children if
 `@param {object} props` will be exempted from requiring a description given
 `function someFunc ({child1, child2})`).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-30"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-30"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-29"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-30-setdefaultdestructuredrootdescription"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-30-setdefaultdestructuredrootdescription"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-29-setdefaultdestructuredrootdescription"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29-setdefaultdestructuredrootdescription"></a>
 ##### <code>setDefaultDestructuredRootDescription</code>
 
 Whether to set a default destructured root description. For example, you may
@@ -15903,15 +15662,15 @@ corresponding to a destructured root object as it should always be the same
 type of object. Uses `defaultDestructuredRootDescription` for the description
 string. Defaults to `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-30-defaultdestructuredrootdescription"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-30-defaultdestructuredrootdescription"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-29-defaultdestructuredrootdescription"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29-defaultdestructuredrootdescription"></a>
 ##### <code>defaultDestructuredRootDescription</code>
 
 The description string to set by default for destructured roots. Defaults to
 "The root object".
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-30-contexts-9"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-30-contexts-9"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-description-options-29-contexts-9"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29-contexts-9"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16104,12 +15863,12 @@ Requires that all function parameters have names.
 >
 > [JSDoc](https://jsdoc.app/tags-param.html#overview)
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-name-options-31"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-name-options-31"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-name-options-30"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-name-options-30"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-name-options-31-contexts-10"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-name-options-31-contexts-10"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-name-options-30-contexts-10"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-name-options-30-contexts-10"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16248,12 +16007,12 @@ Will exempt destructured roots and their children if
 `@param props` will be exempted from requiring a type given
 `function someFunc ({child1, child2})`).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-32"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-32"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-31"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-32-setdefaultdestructuredroottype"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-32-setdefaultdestructuredroottype"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-31-setdefaultdestructuredroottype"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31-setdefaultdestructuredroottype"></a>
 ##### <code>setDefaultDestructuredRootType</code>
 
 Whether to set a default destructured root type. For example, you may wish
@@ -16262,14 +16021,14 @@ corresponding to a destructured root object as it is always going to be an
 object. Uses `defaultDestructuredRootType` for the type string. Defaults to
 `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-32-defaultdestructuredroottype"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-32-defaultdestructuredroottype"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-31-defaultdestructuredroottype"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31-defaultdestructuredroottype"></a>
 ##### <code>defaultDestructuredRootType</code>
 
 The type string to set by default for destructured roots. Defaults to "object".
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-32-contexts-11"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-32-contexts-11"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-type-options-31-contexts-11"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31-contexts-11"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16634,35 +16393,35 @@ other properties, so in looking at the docs alone without looking at the
 function signature, it may appear that there is an actual property named
 `extra`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32"></a>
 #### Options
 
 An options object accepts the following optional properties:
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-enablefixer-5"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-enablefixer-5"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-enablefixer-5"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-enablefixer-5"></a>
 ##### <code>enableFixer</code>
 
 Whether to enable the fixer. Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-enablerootfixer"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-enablerootfixer"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-enablerootfixer"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-enablerootfixer"></a>
 ##### <code>enableRootFixer</code>
 
 Whether to enable the auto-adding of incrementing roots (see the "Fixer"
 section). Defaults to `true`. Has no effect if `enableFixer` is set to
 `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-enablerestelementfixer"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-enablerestelementfixer"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-enablerestelementfixer"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-enablerestelementfixer"></a>
 ##### <code>enableRestElementFixer</code>
 
 Whether to enable the rest element fixer (see
 "Rest Element (`RestElement`) insertions"). Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checkrestproperty-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checkrestproperty-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checkrestproperty-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkrestproperty-1"></a>
 ##### <code>checkRestProperty</code>
 
 If set to `true`, will report (and add fixer insertions) for missing rest
@@ -16716,15 +16475,15 @@ function quux ({num, ...extra}) {
 }
 ```
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-autoincrementbase"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-autoincrementbase"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-autoincrementbase"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-autoincrementbase"></a>
 ##### <code>autoIncrementBase</code>
 
 Numeric to indicate the number at which to begin auto-incrementing roots.
 Defaults to `0`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-unnamedrootbase"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-unnamedrootbase"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-unnamedrootbase"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-unnamedrootbase"></a>
 ##### <code>unnamedRootBase</code>
 
 An array of root names to use in the fixer when roots are missing. Defaults
@@ -16750,8 +16509,8 @@ function quux ({foo}, [bar], {baz}) {
 */
 ```
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-exemptedby-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-exemptedby-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-exemptedby-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-exemptedby-1"></a>
 ##### <code>exemptedBy</code>
 
 Array of tags (e.g., `['type']`) whose presence on the document block
@@ -16760,8 +16519,8 @@ avoids the need for a `@param`. Defaults to an array with
 so be sure to add back `inheritdoc` if you wish its presence to cause
 exemption of the rule.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checktypespattern-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checktypespattern-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checktypespattern-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checktypespattern-1"></a>
 ##### <code>checkTypesPattern</code>
 
 When one specifies a type, unless it is of a generic type, like `object`
@@ -16796,8 +16555,8 @@ You could set this regular expression to a more expansive list, or you
 could restrict it such that even types matching those strings would not
 need destructuring.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-contexts-12"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-contexts-12"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-contexts-12"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-contexts-12"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16809,33 +16568,33 @@ which are checked.
 See the ["AST and Selectors"](#user-content-eslint-plugin-jsdoc-advanced-ast-and-selectors)
 section of our README for more on the expected format.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checkconstructors-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checkconstructors-2"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checkconstructors-2"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkconstructors-2"></a>
 ##### <code>checkConstructors</code>
 
 A value indicating whether `constructor`s should be checked. Defaults to
 `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checkgetters-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checkgetters-2"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checkgetters-2"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkgetters-2"></a>
 ##### <code>checkGetters</code>
 
 A value indicating whether getters should be checked. Defaults to `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checksetters-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checksetters-2"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checksetters-2"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checksetters-2"></a>
 ##### <code>checkSetters</code>
 
 A value indicating whether setters should be checked. Defaults to `false`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checkdestructured-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checkdestructured-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checkdestructured-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkdestructured-1"></a>
 ##### <code>checkDestructured</code>
 
 Whether to require destructured properties. Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-checkdestructuredroots"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-checkdestructuredroots"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-checkdestructuredroots"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkdestructuredroots"></a>
 ##### <code>checkDestructuredRoots</code>
 
 Whether to check the existence of a corresponding `@param` for root objects
@@ -16848,8 +16607,8 @@ implied to be `false` (i.e., the inside of the roots will not be checked
 either, e.g., it will also not complain if `a` or `b` do not have their own
 documentation). Defaults to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-usedefaultobjectproperties-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-33-usedefaultobjectproperties-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-32-usedefaultobjectproperties-1"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-32-usedefaultobjectproperties-1"></a>
 ##### <code>useDefaultObjectProperties</code>
 
 Set to `true` if you wish to expect documentation of properties on objects
@@ -18534,8 +18293,8 @@ is found. Also reports if `@returns {never}` is discovered with a return value.
 
 Will also report if multiple `@returns` tags are present.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-check-options-34"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-check-options-34"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-check-options-33"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-check-options-33"></a>
 #### Options
 
 - `exemptGenerators`- Because a generator might be labeled as having a
@@ -19561,12 +19320,12 @@ Requires that the `@returns` tag has a `description` value. The error
 will not be reported if the return value is `void` or `undefined`
 or if it is `Promise<void>` or `Promise<undefined>`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-description-options-35"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-description-options-35"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-description-options-34"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-description-options-34"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-description-options-35-contexts-13"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-description-options-35-contexts-13"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-description-options-34-contexts-13"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-description-options-34-contexts-13"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -19720,12 +19479,12 @@ function quux () {
 
 Requires that `@returns` tag has `type` value.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-type-options-36"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-type-options-36"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-type-options-35"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-type-options-35"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-type-options-36-contexts-14"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-type-options-36-contexts-14"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-type-options-35-contexts-14"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-type-options-35-contexts-14"></a>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -19846,8 +19605,8 @@ Requires that returns are documented.
 
 Will also report if multiple `@returns` tags are present.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-options-37"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-options-37"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-options-36"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-options-36"></a>
 #### Options
 
 - `checkConstructors` - A value indicating whether `constructor`s should
@@ -20444,6 +20203,22 @@ export function readFixture(path: string): void;
 export function readFixture(path: string);
 // "jsdoc/require-returns": ["error"|"warn", {"forceRequireReturn":true}]
 // Message: Missing JSDoc @returns declaration.
+
+/**
+ * @param {array} a
+ */
+async function foo(a) {
+  return Promise.all(a);
+}
+// Message: Missing JSDoc @returns declaration.
+
+/**
+ * Description.
+ */
+export default async function demo() {
+  return true;
+}
+// Message: Missing JSDoc @returns declaration.
 ````
 
 The following patterns are not considered problems:
@@ -20928,13 +20703,6 @@ async function foo() {
   return new Promise(resolve => resolve());
 }
 
-/**
- * @param {array} a
- */
-async function foo(a) {
-  return Promise.all(a);
-}
-
 /**
  * @param ms time in millis
  */
@@ -20987,8 +20755,8 @@ for our desire for a separate tag to document rejection types and see
 [this discussion](https://stackoverflow.com/questions/50071115/typescript-promise-rejection-type)
 on why TypeScript doesn't offer such a feature.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-throws-options-38"></a>
-<a name="eslint-plugin-jsdoc-rules-require-throws-options-38"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-throws-options-37"></a>
+<a name="eslint-plugin-jsdoc-rules-require-throws-options-37"></a>
 #### Options
 
 - `exemptedBy` - Array of tags (e.g., `['type']`) whose presence on the
@@ -21292,8 +21060,8 @@ Will also report if multiple `@yields` tags are present.
 See the `next`, `forceRequireNext`, and `nextWithGeneratorTag` options for an
 option to expect a non-standard `@next` tag.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-yields-options-39"></a>
-<a name="eslint-plugin-jsdoc-rules-require-yields-options-39"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-yields-options-38"></a>
+<a name="eslint-plugin-jsdoc-rules-require-yields-options-38"></a>
 #### Options
 
 - `exemptedBy` - Array of tags (e.g., `['type']`) whose presence on the
@@ -22104,8 +21872,8 @@ function bodies.
 
 Will also report if multiple `@yields` tags are present.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-require-yields-check-options-40"></a>
-<a name="eslint-plugin-jsdoc-rules-require-yields-check-options-40"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-yields-check-options-39"></a>
+<a name="eslint-plugin-jsdoc-rules-require-yields-check-options-39"></a>
 #### Options
 
 - `checkGeneratorsOnly` - Avoids checking the function body and merely insists
@@ -22617,12 +22385,12 @@ Sorts tags by a specified sequence according to tag name.
 
 (Default order originally inspired by [`@homer0/prettier-plugin-jsdoc`](https://github.com/homer0/packages/tree/main/packages/public/prettier-plugin-jsdoc).)
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41-tagsequence"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41-tagsequence"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40-tagsequence"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-tagsequence"></a>
 ##### <code>tagSequence</code>
 
 An array of tag names indicating the preferred sequence for sorting tags.
@@ -22798,8 +22566,8 @@ a fixed order that doesn't change into the future, supply your own
 ];
 ```
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41-alphabetizeextras"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41-alphabetizeextras"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40-alphabetizeextras"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-alphabetizeextras"></a>
 ##### <code>alphabetizeExtras</code>
 
 Defaults to `false`. Alphabetizes any items not within `tagSequence` after any
@@ -22956,39 +22724,57 @@ function quux () {}
 
 Enforces lines (or no lines) between tags.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42"></a>
+If you only want lines preceding all tags or after all tags, you can use
+the "any" option along with `startLines` and/or `endLines`.
+
+The "always" or "never" options of this rule should not
+be used with the linebreak-setting options of the `sort-tags` rule as both
+may try to impose a conflicting number of lines.
+
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41"></a>
 #### Options
 
 The first option is a single string set to "always", "never", or "any"
 (defaults to "never").
 
 "any" is only useful with `tags` (allowing non-enforcement of lines except
-for particular tags) or with `dropEndLines`.
+for particular tags) or with `startLines` or `endLines`. It is also
+necessary if using the linebreak-setting options of the `sort-tags` rule
+so that the two rules won't conflict in both attempting to set lines
+between tags.
 
 The second option is an object with the following optional properties.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-count-defaults-to-1"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-count-defaults-to-1"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41-count-defaults-to-1"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-count-defaults-to-1"></a>
 ##### <code>count</code> (defaults to 1)
 
 Use with "always" to indicate the number of lines to require be present.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-noendlines-defaults-to-false"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-noendlines-defaults-to-false"></a>
-##### <code>noEndLines</code> (defaults to <code>false</code>)
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41-applytoendtag-defaults-to-true"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-applytoendtag-defaults-to-true"></a>
+##### <code>applyToEndTag</code> (defaults to <code>true</code>)
 
-Use with "always" to indicate the normal lines to be added after tags should
-not be added after the final tag.
+Set to `false` and use with "always" to indicate the normal lines to be
+added after tags should not be added after the final tag.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-dropendlines-defaults-to-false"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-dropendlines-defaults-to-false"></a>
-##### <code>dropEndLines</code> (defaults to <code>false</code>)
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41-startlines-defaults-to-0"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-startlines-defaults-to-0"></a>
+##### <code>startLines</code> (defaults to <code>0</code>)
 
-If defined, will drop end lines for the final tag only.
+If not set to `null`, will enforce end lines to the given count before the
+first tag only.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-tags-default-to-empty-object"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-tags-default-to-empty-object"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41-endlines-defaults-to-0"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-endlines-defaults-to-0"></a>
+##### <code>endLines</code> (defaults to <code>0</code>)
+
+If not set to `null`, will enforce end lines to the given count on the
+final tag only.
+
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-41-tags-default-to-empty-object"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-tags-default-to-empty-object"></a>
 ##### <code>tags</code> (default to empty object)
 
 Overrides the default behavior depending on specific tags.
@@ -23005,7 +22791,7 @@ following keys:
 |Tags|Any|
 |Recommended|true|
 |Settings|N/A|
-|Options|(a string matching `"always" or "never"` and optional object with `count` and `noEndLines`)|
+|Options|(a string matching `"always"`, `"never"`, or `"any"` and optional object with `count`, `applyToEndTag`, `startLines`, `endLines`)|
 
 The following patterns are considered problems:
 
@@ -23040,7 +22826,7 @@ The following patterns are considered problems:
  * @param {string} a
  * @param {number} b
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always",{"noEndLines":true}]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"applyToEndTag":false}]
 // Message: Expected 1 line between tags but found 0
 
 /**
@@ -23131,7 +22917,7 @@ The following patterns are considered problems:
  * @param {number} b
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always"]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"endLines":null}]
 // Message: Expected 1 line between tags but found 0
 
 /**
@@ -23156,8 +22942,70 @@ The following patterns are considered problems:
  * This is still part of `@returns`.
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "any",{"dropEndLines":true}]
-// Message: Expected no trailing lines
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"endLines":0}]
+// Message: Expected 0 trailing lines
+
+/**
+ * Some description
+ * @param {string} a
+ * @param {string} b
+ *
+ * @returns {SomeType} An extended
+ * description.
+ *
+ * This is still part of `@returns`.
+ *
+ *
+ *
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"endLines":1}]
+// Message: Expected 1 trailing lines
+
+/**
+ * Some description
+ * @param {string} a
+ * @param {string} b
+ *
+ * @returns {SomeType} An extended
+ * description.
+ *
+ * This is still part of `@returns`.
+ *
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"endLines":2}]
+// Message: Expected 2 trailing lines
+
+/**
+ * Some description
+ *
+ *
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"startLines":1}]
+// Message: Expected only 1 line after block description
+
+/**
+ * Some description
+ *
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"startLines":0}]
+// Message: Expected only 0 line after block description
+
+/**
+ * Some description
+ *
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"startLines":2}]
+// Message: Expected 2 lines after block description
+
+/**
+ * Some description
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"startLines":1}]
+// Message: Expected 1 lines after block description
 ````
 
 The following patterns are not considered problems:
@@ -23181,15 +23029,15 @@ The following patterns are not considered problems:
  *
  * @param {string} a
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always",{"noEndLines":true}]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"applyToEndTag":false}]
 
 /**
  * @param {string} a
  */
-// "jsdoc/tag-lines": ["error"|"warn", "never",{"noEndLines":true}]
+// "jsdoc/tag-lines": ["error"|"warn", "never",{"applyToEndTag":false}]
 
 /** @param {number} b */
-// "jsdoc/tag-lines": ["error"|"warn", "never",{"noEndLines":true}]
+// "jsdoc/tag-lines": ["error"|"warn", "never",{"applyToEndTag":false}]
 
 /**
  * Some description
@@ -23198,7 +23046,7 @@ The following patterns are not considered problems:
  * @param {number} b
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always"]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"endLines":null}]
 
 /**
  * Some description
@@ -23209,7 +23057,7 @@ The following patterns are not considered problems:
  *
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always",{"count":2}]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"count":2,"endLines":null}]
 
 /**
  * Some description
@@ -23302,7 +23150,7 @@ The following patterns are not considered problems:
  * description.
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always"]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"endLines":null}]
 
 /**
  * Some description
@@ -23314,7 +23162,7 @@ The following patterns are not considered problems:
  * This is still part of `@returns`.
  *
  */
-// "jsdoc/tag-lines": ["error"|"warn", "always"]
+// "jsdoc/tag-lines": ["error"|"warn", "always",{"endLines":null}]
 
 /**
  * Some description
@@ -23326,7 +23174,35 @@ The following patterns are not considered problems:
  *
  * This is still part of `@returns`.
  */
-// "jsdoc/tag-lines": ["error"|"warn", "any",{"dropEndLines":true}]
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"endLines":0}]
+
+/**
+ * Some description
+ *
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"startLines":1}]
+
+/**
+ * Some description
+ * @param {string} a
+ *
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "any",{"endLines":1}]
+
+/**
+ * Some description
+ *
+ *
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "never",{"startLines":null}]
+
+/**
+ * Some description
+ * @param {string} a
+ */
+// "jsdoc/tag-lines": ["error"|"warn", "never",{"startLines":null}]
 ````
 
 
@@ -23342,19 +23218,19 @@ Markdown and you therefore do not wish for it to be accidentally interpreted
 as such by the likes of Visual Studio Code or if you wish to view it escaped
 within it or your documentation.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-43"></a>
-<a name="eslint-plugin-jsdoc-rules-text-escaping-options-43"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-42"></a>
+<a name="eslint-plugin-jsdoc-rules-text-escaping-options-42"></a>
 #### Options
 
-<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-43-escapehtml"></a>
-<a name="eslint-plugin-jsdoc-rules-text-escaping-options-43-escapehtml"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-42-escapehtml"></a>
+<a name="eslint-plugin-jsdoc-rules-text-escaping-options-42-escapehtml"></a>
 ##### <code>escapeHTML</code>
 
 This option escapes all `<` and `&` characters (except those followed by
 whitespace which are treated as literals by Visual Studio Code).
 
-<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-43-escapemarkdown"></a>
-<a name="eslint-plugin-jsdoc-rules-text-escaping-options-43-escapemarkdown"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-42-escapemarkdown"></a>
+<a name="eslint-plugin-jsdoc-rules-text-escaping-options-42-escapemarkdown"></a>
 ##### <code>escapeMarkdown</code>
 
 This option escapes the first backtick (`` ` ``) in a paired sequence.
@@ -23561,8 +23437,8 @@ for valid types (based on the tag's `type` value), and either portion checked
 for presence (based on `false` `name` or `type` values or their `required`
 value). See the setting for more details.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-valid-types-options-44"></a>
-<a name="eslint-plugin-jsdoc-rules-valid-types-options-44"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-valid-types-options-43"></a>
+<a name="eslint-plugin-jsdoc-rules-valid-types-options-43"></a>
 #### Options
 
 - `allowEmptyNamepaths` (default: true) - Set to `false` to bulk disallow