fix: sync rule type header comments

eslint · mdjermanovic · Jan 17, 2025 · Dec 26, 2024 · Dec 26, 2024 · Dec 27, 2024
commit 1858b6559f26fe3d08fd5ab7143767a53653f55a
@@ -28,12 +28,29 @@
 import { Linter } from "../index";
 
 export interface Deprecated extends Linter.RulesRecord {
+
+    /**
+     * Rule to enforce line breaks between arguments of a function call.
+     *
+     * @since 6.2.0
+     * @deprecated since 8.53.0, please use the [corresponding rule](https://eslint.style/rules/js/function-call-argument-newline) in `@stylistic/eslint-plugin-js`.
+     * @see https://eslint.org/docs/latest/rules/function-call-argument-newline
+     */
+    "function-call-argument-newline": Linter.RuleEntry<
+        [
+            /**
+             * @default "always"
+             */
+            "always" | "never" | "consistent"
+        ]
+    >;
+
     /**
      * Rule to enforce consistent indentation.
      *
      * @since 4.0.0-alpha.0
      * @deprecated since 4.0.0, use [`indent`](https://eslint.org/docs/rules/indent) instead.
-     * @see https://eslint.org/docs/rules/indent-legacy
+     * @see https://eslint.org/docs/latest/rules/indent-legacy
      */
     "indent-legacy": Linter.RuleEntry<
         [
@@ -136,7 +153,7 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 3.5.0
      * @deprecated since 4.0.0, use [`padding-line-between-statements`](https://eslint.org/docs/rules/padding-line-between-statements) instead.
-     * @see https://eslint.org/docs/rules/lines-around-directive
+     * @see https://eslint.org/docs/latest/rules/lines-around-directive
      */
     "lines-around-directive": Linter.RuleEntry<["always" | "never"]>;
 
@@ -145,7 +162,7 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 0.18.0
      * @deprecated since 4.0.0, use [`padding-line-between-statements`](https://eslint.org/docs/rules/padding-line-between-statements) instead.
-     * @see https://eslint.org/docs/rules/newline-after-var
+     * @see https://eslint.org/docs/latest/rules/newline-after-var
      */
     "newline-after-var": Linter.RuleEntry<["always" | "never"]>;
 
@@ -154,25 +171,25 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 2.3.0
      * @deprecated since 4.0.0, use [`padding-line-between-statements`](https://eslint.org/docs/rules/padding-line-between-statements) instead.
-     * @see https://eslint.org/docs/rules/newline-before-return
+     * @see https://eslint.org/docs/latest/rules/newline-before-return
      */
     "newline-before-return": Linter.RuleEntry<[]>;
 
     /**
-     * Rule to disallow shadowing of variables inside of `catch`.
+     * Rule to disallow `catch` clause parameters from shadowing variables in the outer scope.
      *
      * @since 0.0.9
      * @deprecated since 5.1.0, use [`no-shadow`](https://eslint.org/docs/rules/no-shadow) instead.
-     * @see https://eslint.org/docs/rules/no-catch-shadow
+     * @see https://eslint.org/docs/latest/rules/no-catch-shadow
      */
     "no-catch-shadow": Linter.RuleEntry<[]>;
 
     /**
-     * Rule to disallow reassignment of native objects.
+     * Rule to disallow assignments to native objects or read-only global variables.
      *
      * @since 0.0.9
      * @deprecated since 3.3.0, use [`no-global-assign`](https://eslint.org/docs/rules/no-global-assign) instead.
-     * @see https://eslint.org/docs/rules/no-native-reassign
+     * @see https://eslint.org/docs/latest/rules/no-native-reassign
      */
     "no-native-reassign": Linter.RuleEntry<
         [
@@ -187,7 +204,7 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 0.1.2
      * @deprecated since 3.3.0, use [`no-unsafe-negation`](https://eslint.org/docs/rules/no-unsafe-negation) instead.
-     * @see https://eslint.org/docs/rules/no-negated-in-lhs
+     * @see https://eslint.org/docs/latest/rules/no-negated-in-lhs
      */
     "no-negated-in-lhs": Linter.RuleEntry<[]>;
 
@@ -196,7 +213,7 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 0.0.9
      * @deprecated since 8.50.0, use [`no-object-constructor`](https://eslint.org/docs/rules/no-object-constructor) instead.
-     * @see https://eslint.org/docs/rules/no-object-constructor
+     * @see https://eslint.org/docs/latest/rules/no-new-object
      */
     "no-new-object": Linter.RuleEntry<[]>;
 
@@ -205,25 +222,25 @@ export interface Deprecated extends Linter.RulesRecord {
      *
      * @since 2.0.0-beta.1
      * @deprecated since 8.27.0, use [`no-new-native-nonconstructor`](https://eslint.org/docs/rules/no-new-native-nonconstructor) instead.
-     * @see https://eslint.org/docs/rules/no-new-symbol
+     * @see https://eslint.org/docs/latest/rules/no-new-symbol
      */
     "no-new-symbol": Linter.RuleEntry<[]>;
 
     /**
-     * Rule to disallow spacing between function identifiers and their applications.
+     * Rule to disallow spacing between function identifiers and their applications (deprecated).
      *
      * @since 0.1.2
      * @deprecated since 3.3.0, use [`func-call-spacing`](https://eslint.org/docs/rules/func-call-spacing) instead.
-     * @see https://eslint.org/docs/rules/no-spaced-func
+     * @see https://eslint.org/docs/latest/rules/no-spaced-func
      */
     "no-spaced-func": Linter.RuleEntry<[]>;
 
     /**
-     * Rule to suggest using `Reflect` methods where applicable.
+     * Rule to require `Reflect` methods where applicable.
      *
      * @since 1.0.0-rc-2
      * @deprecated since 3.9.0
-     * @see https://eslint.org/docs/rules/prefer-reflect
+     * @see https://eslint.org/docs/latest/rules/prefer-reflect
      */
     "prefer-reflect": Linter.RuleEntry<
         [