Add @see tag (#310)

* Add support for @see tag Also fix no-redundant-jsdoc2 test. It was not testing anything before. * Move test to correctly named folder
microsoft · Sep 18, 2020 · e609d63 · e609d63
1 parent 5c36c59
commit e609d63
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 4 deletions.
diff --git a/src/rules/noRedundantJsdoc2Rule.ts b/src/rules/noRedundantJsdoc2Rule.ts
@@ -59,11 +59,12 @@ function walk(ctx: Lint.WalkContext<void>): void {
     });
 
     function checkTag(tag: ts.JSDocTag): void {
-        // @ts-ignore (until support for 4.0 is added)
-        const jsdocDeprecatedTag = ts.SyntaxKind.JSDocDeprecatedTag || 0;
+        const jsdocSeeTag = (ts.SyntaxKind as any).JSDocSeeTag || 0;
+        const jsdocDeprecatedTag = (ts.SyntaxKind as any).JSDocDeprecatedTag || 0;
         switch (tag.kind) {
+            case jsdocSeeTag:
             case jsdocDeprecatedTag:
-                // A deprecated tag always has meaning
+                // @deprecated and @see always have meaning
                 break;
             case ts.SyntaxKind.JSDocTag: {
                 const { tagName } = tag;

diff --git a/test/no-redundant-jsdoc/declarationFile.d.ts → test/no-redundant-jsdoc2/test.ts.lint b/test/no-redundant-jsdoc/declarationFile.d.ts → test/no-redundant-jsdoc2/test.ts.lint
@@ -1,2 +1,4 @@
 /** @deprecated */
 export const x: number;
+/** @see x */
+export const y: number;
diff --git a/test/no-redundant-jsdoc/tslint.json → test/no-redundant-jsdoc2/tslint.json b/test/no-redundant-jsdoc/tslint.json → test/no-redundant-jsdoc2/tslint.json
@@ -1,6 +1,6 @@
 {
   "rulesDirectory": ["../../bin/rules"],
   "rules": {
-    "no-redundant-jsdoc": true
+    "no-redundant-jsdoc2": true
   }
 }