eslint-plugin-jsdoc 43.0.9 → 43.1.1

package/README.md

@@ -44,6 +44,7 @@ JSDoc linting rules for ESLint.
         * [`multiline-blocks`](#user-content-eslint-plugin-jsdoc-rules-multiline-blocks)
         * [`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-blank-blocks`](#user-content-eslint-plugin-jsdoc-rules-no-blank-blocks)
         * [`no-defaults`](#user-content-eslint-plugin-jsdoc-rules-no-defaults)
         * [`no-missing-syntax`](#user-content-eslint-plugin-jsdoc-rules-no-missing-syntax)
         * [`no-multi-asterisks`](#user-content-eslint-plugin-jsdoc-rules-no-multi-asterisks)
@@ -5012,6 +5013,27 @@ function Test() {
 }
 // Settings: {"jsdoc":{"tagNamePreference":{"returns":"return"}}}
 // Message: Invalid JSDoc tag (preference). Replace "constructor" JSDoc tag with "class".
+
+/** @typedef {Object} MyObject
+ * @property {string} id - my id
+ */
+// "jsdoc/check-tag-names": ["error"|"warn", {"typed":true}]
+// Message: '@typedef' is redundant when using a type system.
+
+/**
+ * @property {string} id - my id
+ */
+// "jsdoc/check-tag-names": ["error"|"warn", {"typed":true}]
+// Message: '@property' is redundant when using a type system.
+
+/** @typedef {Object} MyObject */
+// "jsdoc/check-tag-names": ["error"|"warn", {"typed":true}]
+// Message: '@typedef' is redundant when using a type system.
+
+/** @typedef {Object} MyObject
+ */
+// "jsdoc/check-tag-names": ["error"|"warn", {"typed":true}]
+// Message: '@typedef' is redundant when using a type system.
 ````
 
 The following patterns are not considered problems:
@@ -9468,6 +9490,84 @@ function functionWithClearName() {}
 ````
 
 
+<a name="user-content-eslint-plugin-jsdoc-rules-no-blank-blocks"></a>
+<a name="eslint-plugin-jsdoc-rules-no-blank-blocks"></a>
+### <code>no-blank-blocks</code>
+
+Reports and optionally removes blocks with whitespace only.
+
+<a name="user-content-eslint-plugin-jsdoc-rules-no-blank-blocks-options-16"></a>
+<a name="eslint-plugin-jsdoc-rules-no-blank-blocks-options-16"></a>
+#### Options
+
+<a name="user-content-eslint-plugin-jsdoc-rules-no-blank-blocks-options-16-enablefixer-3"></a>
+<a name="eslint-plugin-jsdoc-rules-no-blank-blocks-options-16-enablefixer-3"></a>
+##### <code>enableFixer</code>
+
+Whether or not to auto-remove the blank block. Defaults to `false`.
+
+|||
+|---|---|
+|Context|everywhere|
+|Tags|N/A|
+|Recommended|false|
+|Settings||
+|Options|`enableFixer`|
+
+The following patterns are considered problems:
+
+````js
+/** */
+// "jsdoc/no-blank-blocks": ["error"|"warn", {"enableFixer":true}]
+// Message: No empty blocks
+
+/**
+ */
+// "jsdoc/no-blank-blocks": ["error"|"warn", {"enableFixer":true}]
+// Message: No empty blocks
+
+/**
+ *
+ */
+// "jsdoc/no-blank-blocks": ["error"|"warn", {"enableFixer":true}]
+// Message: No empty blocks
+
+/**
+ *
+ *
+ */
+// "jsdoc/no-blank-blocks": ["error"|"warn", {"enableFixer":true}]
+// Message: No empty blocks
+
+/**
+ *
+ *
+ */
+// "jsdoc/no-blank-blocks": ["error"|"warn", {"enableFixer":false}]
+// Message: No empty blocks
+
+/**
+ *
+ *
+ */
+// Message: No empty blocks
+````
+
+The following patterns are not considered problems:
+
+````js
+/** @tag */
+
+/**
+ * Text
+ */
+
+/**
+ * @tag
+ */
+````
+
+
 <a name="user-content-eslint-plugin-jsdoc-rules-no-defaults"></a>
 <a name="eslint-plugin-jsdoc-rules-no-defaults"></a>
 ### <code>no-defaults</code>
@@ -9484,12 +9584,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-16"></a>
-<a name="eslint-plugin-jsdoc-rules-no-defaults-options-16"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-defaults-options-17"></a>
+<a name="eslint-plugin-jsdoc-rules-no-defaults-options-17"></a>
 #### Options
 
-<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>
+<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>
 ##### <code>noOptionalParamNames</code>
 
 Set this to `true` to report the presence of optional parameters. May be
@@ -9498,8 +9598,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-16-contexts-3"></a>
-<a name="eslint-plugin-jsdoc-rules-no-defaults-options-16-contexts-3"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -9685,12 +9785,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-17"></a>
-<a name="eslint-plugin-jsdoc-rules-no-missing-syntax-options-17"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -9906,12 +10006,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-18"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>allowWhitespace</code> (defaults to <code>false</code>)
 
 Set to `true` if you wish to allow asterisks after a space (as with Markdown):
@@ -9922,8 +10022,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-18-preventatmiddlelines-defaults-to-true"></a>
-<a name="eslint-plugin-jsdoc-rules-no-multi-asterisks-options-18-preventatmiddlelines-defaults-to-true"></a>
+<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>
 ##### <code>preventAtMiddleLines</code> (defaults to <code>true</code>)
 
 Prevent the likes of this:
@@ -9935,8 +10035,8 @@ Prevent the likes of this:
  */
 ```
 
-<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>
+<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>
 ##### <code>preventAtEnd</code> (defaults to <code>true</code>)
 
 Prevent the likes of this:
@@ -10171,12 +10271,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-19"></a>
-<a name="eslint-plugin-jsdoc-rules-no-restricted-syntax-options-19"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -10501,12 +10601,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-20"></a>
-<a name="eslint-plugin-jsdoc-rules-no-types-options-20"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-no-types-options-21"></a>
+<a name="eslint-plugin-jsdoc-rules-no-types-options-21"></a>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -10680,8 +10780,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-21"></a>
-<a name="eslint-plugin-jsdoc-rules-no-undefined-types-options-21"></a>
+<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>
 #### Options
 
 An option object may have the following key:
@@ -11349,8 +11449,8 @@ class Foo {
 
 Requires that each JSDoc line starts with an `*`.
 
-<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>
+<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>
 #### Options
 
 This rule allows an optional string argument. If it is `"always"` then a
@@ -11361,8 +11461,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-22-tags-3"></a>
-<a name="eslint-plugin-jsdoc-rules-require-asterisk-prefix-options-22-tags-3"></a>
+<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>
 ##### <code>tags</code>
 
 If you want different values to apply to specific tags, you may use
@@ -11646,12 +11746,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-23"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>tags</code>
 
 If you want additional tags to be checked for their descriptions, you may
@@ -11675,16 +11775,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-23-abbreviations"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-abbreviations"></a>
+<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>
 ##### <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-23-newlinebeforecapsassumesbadsentenceend"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-23-newlinebeforecapsassumesbadsentenceend"></a>
+<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>
 ##### <code>newlineBeforeCapsAssumesBadSentenceEnd</code>
 
 When `false` (the new default), we will not assume capital letters after
@@ -12428,8 +12528,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-24"></a>
-<a name="eslint-plugin-jsdoc-rules-require-description-options-24"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-description-options-25"></a>
+<a name="eslint-plugin-jsdoc-rules-require-description-options-25"></a>
 #### Options
 
 An options object may have any of the following properties:
@@ -12990,14 +13090,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-25"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-26"></a>
 #### Options
 
 This rule has an object option.
 
-<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>
+<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>
 ##### <code>exemptedBy</code>
 
 Array of tags (e.g., `['type']`) whose presence on the document
@@ -13006,15 +13106,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-25-exemptnoarguments"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-exemptnoarguments"></a>
+<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>
 ##### <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-25-contexts-7"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-contexts-7"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -13026,27 +13126,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-25-checkconstructors"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checkconstructors"></a>
+<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>
 ##### <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-25-checkgetters"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checkgetters"></a>
+<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>
 ##### <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-25-checksetters"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-checksetters"></a>
+<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>
 ##### <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-25-enablefixer-3"></a>
-<a name="eslint-plugin-jsdoc-rules-require-example-options-25-enablefixer-3"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-example-options-26-enablefixer-4"></a>
+<a name="eslint-plugin-jsdoc-rules-require-example-options-26-enablefixer-4"></a>
 ##### <code>enableFixer</code>
 
 A boolean on whether to enable the fixer (which adds an empty `@example` block).
@@ -13359,12 +13459,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-26"></a>
-<a name="eslint-plugin-jsdoc-rules-require-file-overview-options-26"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>tags</code>
 
 The keys of this object are tag names, and the values are configuration
@@ -13648,8 +13748,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-27"></a>
-<a name="eslint-plugin-jsdoc-rules-require-hyphen-before-param-description-options-27"></a>
+<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>
 #### Options
 
 This rule takes one optional string argument and an optional options object.
@@ -13881,14 +13981,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-28"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29"></a>
 #### Options
 
 Accepts one optional options object with the following optional keys.
 
-<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>
+<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>
 ##### <code>publicOnly</code>
 
 This option will insist that missing jsdoc blocks are only reported for
@@ -13904,8 +14004,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-28-require"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-require"></a>
+<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>
 ##### <code>require</code>
 
 An object with the following optional boolean keys which all default to
@@ -13918,8 +14018,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-28-contexts-8"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-contexts-8"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings or objects representing the additional AST
@@ -13936,8 +14036,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-28-exemptemptyconstructors"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyconstructors"></a>
+<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>
 ##### <code>exemptEmptyConstructors</code>
 
 Default: true
@@ -13946,8 +14046,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-28-exemptemptyfunctions"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-exemptemptyfunctions"></a>
+<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>
 ##### <code>exemptEmptyFunctions</code>
 
 Default: false.
@@ -13956,16 +14056,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-28-checkconstructors-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkconstructors-1"></a>
+<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>
 ##### <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-28-checkgetters-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checkgetters-1"></a>
+<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>
 ##### <code>checkGetters</code>
 
 A value indicating whether getters should be checked. Besides setting as a
@@ -13974,8 +14074,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-28-checksetters-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-checksetters-1"></a>
+<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>
 ##### <code>checkSetters</code>
 
 A value indicating whether setters should be checked. Besides setting as a
@@ -13984,15 +14084,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-28-enablefixer-4"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-enablefixer-4"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-jsdoc-options-29-enablefixer-5"></a>
+<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-29-enablefixer-5"></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-28-minlinecount"></a>
-<a name="eslint-plugin-jsdoc-rules-require-jsdoc-options-28-minlinecount"></a>
+<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>
 ##### <code>minLineCount</code>
 
 An integer to indicate a minimum number of lines expected for a node in order
@@ -15684,12 +15784,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-29"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>setDefaultDestructuredRootDescription</code>
 
 Whether to set a default destructured root description. For example, you may
@@ -15698,15 +15798,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-29-defaultdestructuredrootdescription"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29-defaultdestructuredrootdescription"></a>
+<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>
 ##### <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-29-contexts-9"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-description-options-29-contexts-9"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -15899,12 +15999,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-30"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-name-options-30"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16043,12 +16143,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-31"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>setDefaultDestructuredRootType</code>
 
 Whether to set a default destructured root type. For example, you may wish
@@ -16057,14 +16157,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-31-defaultdestructuredroottype"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31-defaultdestructuredroottype"></a>
+<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>
 ##### <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-31-contexts-11"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-type-options-31-contexts-11"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16429,35 +16529,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-32"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-33"></a>
 #### Options
 
 An options object accepts the following optional properties:
 
-<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>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-param-options-33-enablefixer-6"></a>
+<a name="eslint-plugin-jsdoc-rules-require-param-options-33-enablefixer-6"></a>
 ##### <code>enableFixer</code>
 
 Whether to enable the fixer. Defaults to `true`.
 
-<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>
+<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>
 ##### <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-32-enablerestelementfixer"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-enablerestelementfixer"></a>
+<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>
 ##### <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-32-checkrestproperty-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkrestproperty-1"></a>
+<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>
 ##### <code>checkRestProperty</code>
 
 If set to `true`, will report (and add fixer insertions) for missing rest
@@ -16511,15 +16611,15 @@ function quux ({num, ...extra}) {
 }
 ```
 
-<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>
+<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>
 ##### <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-32-unnamedrootbase"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-unnamedrootbase"></a>
+<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>
 ##### <code>unnamedRootBase</code>
 
 An array of root names to use in the fixer when roots are missing. Defaults
@@ -16545,8 +16645,8 @@ function quux ({foo}, [bar], {baz}) {
 */
 ```
 
-<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>
+<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>
 ##### <code>exemptedBy</code>
 
 Array of tags (e.g., `['type']`) whose presence on the document block
@@ -16555,8 +16655,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-32-checktypespattern-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checktypespattern-1"></a>
+<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>
 ##### <code>checkTypesPattern</code>
 
 When one specifies a type, unless it is of a generic type, like `object`
@@ -16591,8 +16691,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-32-contexts-12"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-contexts-12"></a>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -16604,33 +16704,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-32-checkconstructors-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkconstructors-2"></a>
+<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>
 ##### <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-32-checkgetters-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkgetters-2"></a>
+<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>
 ##### <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-32-checksetters-2"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checksetters-2"></a>
+<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>
 ##### <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-32-checkdestructured-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-checkdestructured-1"></a>
+<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>
 ##### <code>checkDestructured</code>
 
 Whether to require destructured properties. Defaults to `true`.
 
-<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>
+<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>
 ##### <code>checkDestructuredRoots</code>
 
 Whether to check the existence of a corresponding `@param` for root objects
@@ -16643,8 +16743,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-32-usedefaultobjectproperties-1"></a>
-<a name="eslint-plugin-jsdoc-rules-require-param-options-32-usedefaultobjectproperties-1"></a>
+<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>
 ##### <code>useDefaultObjectProperties</code>
 
 Set to `true` if you wish to expect documentation of properties on objects
@@ -18329,8 +18429,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-33"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-check-options-33"></a>
+<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>
 #### Options
 
 - `exemptGenerators`- Because a generator might be labeled as having a
@@ -19356,12 +19456,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-34"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-description-options-34"></a>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -19515,12 +19615,12 @@ function quux () {
 
 Requires that `@returns` tag has `type` value.
 
-<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>
+<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>
 #### Options
 
-<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>
+<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>
 ##### <code>contexts</code>
 
 Set this to an array of strings representing the AST context (or an object with
@@ -19641,8 +19741,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-36"></a>
-<a name="eslint-plugin-jsdoc-rules-require-returns-options-36"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-returns-options-37"></a>
+<a name="eslint-plugin-jsdoc-rules-require-returns-options-37"></a>
 #### Options
 
 - `checkConstructors` - A value indicating whether `constructor`s should
@@ -20791,8 +20891,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-37"></a>
-<a name="eslint-plugin-jsdoc-rules-require-throws-options-37"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-throws-options-38"></a>
+<a name="eslint-plugin-jsdoc-rules-require-throws-options-38"></a>
 #### Options
 
 - `exemptedBy` - Array of tags (e.g., `['type']`) whose presence on the
@@ -21096,8 +21196,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-38"></a>
-<a name="eslint-plugin-jsdoc-rules-require-yields-options-38"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-require-yields-options-39"></a>
+<a name="eslint-plugin-jsdoc-rules-require-yields-options-39"></a>
 #### Options
 
 - `exemptedBy` - Array of tags (e.g., `['type']`) whose presence on the
@@ -21908,8 +22008,8 @@ function bodies.
 
 Will also report if multiple `@yields` tags are present.
 
-<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>
+<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>
 #### Options
 
 - `checkGeneratorsOnly` - Avoids checking the function body and merely insists
@@ -22433,12 +22533,12 @@ line break setting this rule will attempt to do when not disabled.
 You may, however, safely set the "any" option in that rule along with
 `startLines` and/or `endLines`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41"></a>
 #### Options
 
-<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>
+<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>
 ##### <code>tagSequence</code>
 
 An array of tag group objects indicating the preferred sequence for sorting tags.
@@ -22622,8 +22722,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-40-alphabetizeextras"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-alphabetizeextras"></a>
+<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>
 ##### <code>alphabetizeExtras</code>
 
 Defaults to `false`. Alphabetizes any items not within `tagSequence` after any
@@ -22633,16 +22733,16 @@ are sorted.
 If you want all your tags alphabetized, you can supply an empty array for
 `tagSequence` along with setting this option to `true`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40-linesbetween"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-linesbetween"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41-linesbetween"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41-linesbetween"></a>
 ##### <code>linesBetween</code>
 
 Indicates the number of lines to be added between tag groups. Defaults to 1.
 Do not set to 0 or 2+ if you are using `tag-lines` and `"always"` and do not
 set to 1+ if you are using `tag-lines` and `"never"`.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40-reporttaggroupspacing"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-reporttaggroupspacing"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41-reporttaggroupspacing"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41-reporttaggroupspacing"></a>
 ##### <code>reportTagGroupSpacing</code>
 
 Whether to enable reporting and fixing of line breaks between tag groups
@@ -22650,8 +22750,8 @@ as set by `linesBetween`. Defaults to `true`. Note that the very last tag
 will not have spacing applied regardless. For adding line breaks there, you
 may wish to use the `endLines` option of the `tag-lines` rule.
 
-<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-40-reportintrataggroupspacing"></a>
-<a name="eslint-plugin-jsdoc-rules-sort-tags-options-40-reportintrataggroupspacing"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-sort-tags-options-41-reportintrataggroupspacing"></a>
+<a name="eslint-plugin-jsdoc-rules-sort-tags-options-41-reportintrataggroupspacing"></a>
 ##### <code>reportIntraTagGroupSpacing</code>
 
 Whether to enable reporting and fixing of line breaks within tags of a given
@@ -23029,8 +23129,8 @@ 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>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42"></a>
 #### Options
 
 The first option is a single string set to "always", "never", or "any"
@@ -23044,36 +23144,36 @@ between tags.
 
 The second option is an object with the following optional properties.
 
-<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>
+<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>
 ##### <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-41-applytoendtag-defaults-to-true"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-applytoendtag-defaults-to-true"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-applytoendtag-defaults-to-true"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-applytoendtag-defaults-to-true"></a>
 ##### <code>applyToEndTag</code> (defaults to <code>true</code>)
 
 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-41-startlines-defaults-to-0"></a>
-<a name="eslint-plugin-jsdoc-rules-tag-lines-options-41-startlines-defaults-to-0"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-startlines-defaults-to-0"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-startlines-defaults-to-0"></a>
 ##### <code>startLines</code> (defaults to <code>0</code>)
 
 If not set to `null`, will enforce end lines to the given count before the
 first tag only, unless there is only whitespace content, in which case,
 a line count will not be enforced.
 
-<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>
+<a name="user-content-eslint-plugin-jsdoc-rules-tag-lines-options-42-endlines-defaults-to-0"></a>
+<a name="eslint-plugin-jsdoc-rules-tag-lines-options-42-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>
+<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>
 ##### <code>tags</code> (default to empty object)
 
 Overrides the default behavior depending on specific tags.
@@ -23548,19 +23648,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-42"></a>
-<a name="eslint-plugin-jsdoc-rules-text-escaping-options-42"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-text-escaping-options-43"></a>
+<a name="eslint-plugin-jsdoc-rules-text-escaping-options-43"></a>
 #### Options
 
-<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>
+<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>
 ##### <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-42-escapemarkdown"></a>
-<a name="eslint-plugin-jsdoc-rules-text-escaping-options-42-escapemarkdown"></a>
+<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>
 ##### <code>escapeMarkdown</code>
 
 This option escapes the first backtick (`` ` ``) in a paired sequence.
@@ -23767,8 +23867,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-43"></a>
-<a name="eslint-plugin-jsdoc-rules-valid-types-options-43"></a>
+<a name="user-content-eslint-plugin-jsdoc-rules-valid-types-options-44"></a>
+<a name="eslint-plugin-jsdoc-rules-valid-types-options-44"></a>
 #### Options
 
 - `allowEmptyNamepaths` (default: true) - Set to `false` to bulk disallow