Adopt @link for jsdoc comments (#1122)

Fixes #1015

jsonrpc/src/common/cancellation.ts

@@ -21,7 +21,7 @@ export interface CancellationToken {
 	readonly isCancellationRequested: boolean;
 
 	/**
-	 * An [event](#Event) which fires upon cancellation.
+	 * An {@link Event event} which fires upon cancellation.
 	 */
 	readonly onCancellationRequested: Event<any>;
 }

protocol/src/common/protocol.colorProvider.ts

@@ -31,7 +31,7 @@ export interface DocumentColorRegistrationOptions extends TextDocumentRegistrati
 //---- Color Symbol Provider ---------------------------
 
 /**
- * Parameters for a [DocumentColorRequest](#DocumentColorRequest).
+ * Parameters for a {@link DocumentColorRequest}.
  */
 export interface DocumentColorParams extends WorkDoneProgressParams, PartialResultParams {
 	/**
@@ -42,8 +42,8 @@ export interface DocumentColorParams extends WorkDoneProgressParams, PartialResu
 
 /**
  * A request to list all color symbols found in a given text document. The request's
- * parameter is of type [DocumentColorParams](#DocumentColorParams) the
- * response is of type [ColorInformation[]](#ColorInformation) or a Thenable
+ * parameter is of type {@link DocumentColorParams} the
+ * response is of type {@link ColorInformation ColorInformation[]} or a Thenable
  * that resolves to such.
  */
 export namespace DocumentColorRequest {
@@ -54,7 +54,7 @@ export namespace DocumentColorRequest {
 }
 
 /**
- * Parameters for a [ColorPresentationRequest](#ColorPresentationRequest).
+ * Parameters for a {@link ColorPresentationRequest}.
  */
 export interface ColorPresentationParams extends WorkDoneProgressParams, PartialResultParams {
 	/**
@@ -75,8 +75,8 @@ export interface ColorPresentationParams extends WorkDoneProgressParams, Partial
 
 /**
  * A request to list all presentation for a color. The request's
- * parameter is of type [ColorPresentationParams](#ColorPresentationParams) the
- * response is of type [ColorInformation[]](#ColorInformation) or a Thenable
+ * parameter is of type {@link ColorPresentationParams} the
+ * response is of type {@link ColorInformation ColorInformation[]} or a Thenable
  * that resolves to such.
  */
 export namespace ColorPresentationRequest {

protocol/src/common/protocol.declaration.ts

@@ -44,8 +44,8 @@ export interface DeclarationParams extends TextDocumentPositionParams, WorkDoneP
 /**
  * A request to resolve the type definition locations of a symbol at a given text
  * document position. The request's parameter is of type [TextDocumentPositionParams]
- * (#TextDocumentPositionParams) the response is of type [Declaration](#Declaration)
- * or a typed array of [DeclarationLink](#DeclarationLink) or a Thenable that resolves
+ * (#TextDocumentPositionParams) the response is of type {@link Declaration}
+ * or a typed array of {@link DeclarationLink} or a Thenable that resolves
  * to such.
  */
 export namespace DeclarationRequest {

protocol/src/common/protocol.foldingRange.ts

@@ -75,7 +75,7 @@ export interface FoldingRangeRegistrationOptions extends TextDocumentRegistratio
 }
 
 /**
- * Parameters for a [FoldingRangeRequest](#FoldingRangeRequest).
+ * Parameters for a {@link FoldingRangeRequest}.
  */
 export interface FoldingRangeParams extends WorkDoneProgressParams, PartialResultParams {
 	/**
@@ -86,8 +86,8 @@ export interface FoldingRangeParams extends WorkDoneProgressParams, PartialResul
 
 /**
  * A request to provide folding ranges in a document. The request's
- * parameter is of type [FoldingRangeParams](#FoldingRangeParams), the
- * response is of type [FoldingRangeList](#FoldingRangeList) or a Thenable
+ * parameter is of type {@link FoldingRangeParams}, the
+ * response is of type {@link FoldingRangeList} or a Thenable
  * that resolves to such.
  */
 export namespace FoldingRangeRequest {

protocol/src/common/protocol.implementation.ts

@@ -46,7 +46,7 @@ export interface ImplementationParams extends TextDocumentPositionParams, WorkDo
 /**
  * A request to resolve the implementation locations of a symbol at a given text
  * document position. The request's parameter is of type [TextDocumentPositionParams]
- * (#TextDocumentPositionParams) the response is of type [Definition](#Definition) or a
+ * (#TextDocumentPositionParams) the response is of type {@link Definition} or a
  * Thenable that resolves to such.
  */
 export namespace ImplementationRequest {

protocol/src/common/protocol.inlayHint.ts

@@ -92,8 +92,8 @@ export type InlayHintParams = WorkDoneProgressParams & {
 
 /**
  * A request to provide inlay hints in a document. The request's parameter is of
- * type [InlayHintsParams](#InlayHintsParams), the response is of type
- * [InlayHint[]](#InlayHint[]) or a Thenable that resolves to such.
+ * type {@link InlayHintsParams}, the response is of type
+ * {@link InlayHint InlayHint[]} or a Thenable that resolves to such.
  *
  * @since 3.17.0
  */
@@ -106,8 +106,8 @@ export namespace InlayHintRequest {
 
 /**
  * A request to resolve additional properties for an inlay hint.
- * The request's parameter is of type [InlayHint](#InlayHint), the response is
- * of type [InlayHint](#InlayHint) or a Thenable that resolves to such.
+ * The request's parameter is of type {@link InlayHint}, the response is
+ * of type {@link InlayHint} or a Thenable that resolves to such.
  *
  * @since 3.17.0
  */

protocol/src/common/protocol.inlineValue.ts

@@ -80,8 +80,8 @@ export type InlineValueParams = WorkDoneProgressParams & {
 
 /**
  * A request to provide inline values in a document. The request's parameter is of
- * type [InlineValueParams](#InlineValueParams), the response is of type
- * [InlineValue[]](#InlineValue[]) or a Thenable that resolves to such.
+ * type {@link InlineValueParams}, the response is of type
+ * {@link InlineValue InlineValue[]} or a Thenable that resolves to such.
  *
  * @since 3.17.0
  */

protocol/src/common/protocol.moniker.ts

@@ -123,8 +123,8 @@ export interface MonikerParams extends TextDocumentPositionParams, WorkDoneProgr
 
 /**
  * A request to get the moniker of a symbol at a given text document position.
- * The request parameter is of type [TextDocumentPositionParams](#TextDocumentPositionParams).
- * The response is of type [Moniker[]](#Moniker[]) or `null`.
+ * The request parameter is of type {@link TextDocumentPositionParams}.
+ * The response is of type {@link Moniker Moniker[]} or `null`.
  */
 export namespace MonikerRequest {
 	export const method: 'textDocument/moniker' = 'textDocument/moniker';

protocol/src/common/protocol.selectionRange.ts

@@ -45,8 +45,8 @@ export interface SelectionRangeParams extends WorkDoneProgressParams, PartialRes
 
 /**
  * A request to provide selection ranges in a document. The request's
- * parameter is of type [SelectionRangeParams](#SelectionRangeParams), the
- * response is of type [SelectionRange[]](#SelectionRange[]) or a Thenable
+ * parameter is of type {@link SelectionRangeParams}, the
+ * response is of type {@link SelectionRange SelectionRange[]} or a Thenable
  * that resolves to such.
  */
 export namespace SelectionRangeRequest {