From a11cde3df257ad398321cdaf5d990d518c93c371 Mon Sep 17 00:00:00 2001 From: Brett Zamir Date: Wed, 18 Oct 2023 16:23:36 -0700 Subject: [PATCH] docs: document `fixerMessage` --- .README/rules/require-jsdoc.md | 10 ++++++++-- docs/rules/require-jsdoc.md | 13 +++++++++++-- 2 files changed, 19 insertions(+), 4 deletions(-) diff --git a/.README/rules/require-jsdoc.md b/.README/rules/require-jsdoc.md index 8ee920a24..ef5abc597 100644 --- a/.README/rules/require-jsdoc.md +++ b/.README/rules/require-jsdoc.md @@ -9,7 +9,8 @@ functions. Adds an empty JSDoc block unless `enableFixer` is set to `false`. See the `contexts` option for how `inlineCommentBlock` can control the style -of the generated JSDoc block. +of the generated JSDoc block and `fixerMessage` for an optional message +to insert. ## Options @@ -107,6 +108,11 @@ An integer to indicate a minimum number of lines expected for a node in order for it to require documentation. Defaults to `undefined`. This option will apply to any context; see `contexts` for line counts per context. +### `fixerMessage` + +An optional message to add to the inserted JSDoc block. Defaults to the +empty string. + ## Context and settings ||| @@ -114,7 +120,7 @@ apply to any context; see `contexts` for line counts per context. |Context|`ArrowFunctionExpression`, `ClassDeclaration`, `ClassExpression`, `FunctionDeclaration`, `FunctionExpression`; others when `contexts` option enabled| |Tags|N/A| |Recommended|true| -|Options|`publicOnly`, `require`, `contexts`, `exemptEmptyConstructors`, `exemptEmptyFunctions`, `enableFixer`, `minLineCount`| +|Options|`publicOnly`, `require`, `contexts`, `exemptEmptyConstructors`, `exemptEmptyFunctions`, `enableFixer`, `minLineCount`, `fixerMessage`| ## Failing examples diff --git a/docs/rules/require-jsdoc.md b/docs/rules/require-jsdoc.md index e40c04933..93b068929 100644 --- a/docs/rules/require-jsdoc.md +++ b/docs/rules/require-jsdoc.md @@ -14,6 +14,7 @@ * [`checkSetters`](#user-content-require-jsdoc-options-checksetters) * [`enableFixer`](#user-content-require-jsdoc-options-enablefixer) * [`minLineCount`](#user-content-require-jsdoc-options-minlinecount) + * [`fixerMessage`](#user-content-require-jsdoc-options-fixermessage) * [Context and settings](#user-content-require-jsdoc-context-and-settings) * [Failing examples](#user-content-require-jsdoc-failing-examples) * [Passing examples](#user-content-require-jsdoc-passing-examples) @@ -28,7 +29,8 @@ functions. Adds an empty JSDoc block unless `enableFixer` is set to `false`. See the `contexts` option for how `inlineCommentBlock` can control the style -of the generated JSDoc block. +of the generated JSDoc block and `fixerMessage` for an optional message +to insert. @@ -148,6 +150,13 @@ An integer to indicate a minimum number of lines expected for a node in order for it to require documentation. Defaults to `undefined`. This option will apply to any context; see `contexts` for line counts per context. + + +### fixerMessage + +An optional message to add to the inserted JSDoc block. Defaults to the +empty string. + ## Context and settings @@ -157,7 +166,7 @@ apply to any context; see `contexts` for line counts per context. |Context|`ArrowFunctionExpression`, `ClassDeclaration`, `ClassExpression`, `FunctionDeclaration`, `FunctionExpression`; others when `contexts` option enabled| |Tags|N/A| |Recommended|true| -|Options|`publicOnly`, `require`, `contexts`, `exemptEmptyConstructors`, `exemptEmptyFunctions`, `enableFixer`, `minLineCount`| +|Options|`publicOnly`, `require`, `contexts`, `exemptEmptyConstructors`, `exemptEmptyFunctions`, `enableFixer`, `minLineCount`, `fixerMessage`|