Skip to content

Commit 8e9d94b

Browse files
committed
Fix TSDoc issues identified by API Extractor
1 parent cee8054 commit 8e9d94b

File tree

8 files changed

+1391
-8
lines changed

8 files changed

+1391
-8
lines changed

tsdoc/etc/tsdoc.api.md

Lines changed: 1383 additions & 0 deletions
Large diffs are not rendered by default.

tsdoc/src/configuration/TSDocTagDefinition.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ export interface ITSDocTagDefinitionInternalParameters extends ITSDocTagDefiniti
4444
*/
4545
export class TSDocTagDefinition {
4646
/**
47-
* The TSDoc tag name. TSDoc tag names start with an at-sign ("@") followed
47+
* The TSDoc tag name. TSDoc tag names start with an at-sign (`@`) followed
4848
* by ASCII letters using "camelCase" capitalization.
4949
*/
5050
public readonly tagName: string;

tsdoc/src/nodes/DocBlockTag.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ export class DocBlockTag extends DocNode {
5252
}
5353

5454
/**
55-
* The TSDoc tag name. TSDoc tag names start with an at-sign ("@") followed
55+
* The TSDoc tag name. TSDoc tag names start with an at-sign (`@`) followed
5656
* by ASCII letters using "camelCase" capitalization.
5757
*/
5858
public get tagName(): string {

tsdoc/src/nodes/DocComment.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ export class DocComment extends DocNode {
171171
* manually.
172172
*
173173
* This method is provided as convenience for simple use cases. To customize the output, or if you need
174-
* to render into a `StringBuilder, use the {@link TSDocEmitter} class instead.
174+
* to render into a `StringBuilder`, use the {@link TSDocEmitter} class instead.
175175
*/
176176
public emitAsTsdoc(): string {
177177
const stringBuilder: StringBuilder = new StringBuilder();

tsdoc/src/nodes/DocHtmlStartTag.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ export class DocHtmlStartTag extends DocNode {
121121
}
122122

123123
/**
124-
* If true, then the HTML tag ends with "/>" instead of ">".
124+
* If true, then the HTML tag ends with `/>` instead of `>`.
125125
*/
126126
public get selfClosingTag(): boolean {
127127
return this._selfClosingTag;

tsdoc/src/nodes/DocInlineTagBase.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ export interface IDocInlineTagBaseParsedParameters extends IDocNodeParsedParamet
2424
}
2525

2626
/**
27-
* The abstract base class for {@link DocInlineTag}, {@link DocLink}, and {@link DocInheritDoc}.
27+
* The abstract base class for {@link DocInlineTag}, {@link DocLinkTag}, and {@link DocInheritDocTag}.
2828
*/
2929
export abstract class DocInlineTagBase extends DocNode {
3030
private readonly _openingDelimiterExcerpt: DocExcerpt | undefined;
@@ -78,7 +78,7 @@ export abstract class DocInlineTagBase extends DocNode {
7878
}
7979

8080
/**
81-
* The TSDoc tag name. TSDoc tag names start with an at-sign ("@") followed
81+
* The TSDoc tag name. TSDoc tag names start with an at-sign (`@`) followed
8282
* by ASCII letters using "camelCase" capitalization.
8383
*
8484
* @remarks

tsdoc/src/parser/TSDocMessageId.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ export const enum TSDocMessageId {
166166
MissingTag = 'tsdoc-missing-tag',
167167

168168
/**
169-
* The "@" character looks like part of a TSDoc tag; use a backslash to escape it.
169+
* The `@` character looks like part of a TSDoc tag; use a backslash to escape it.
170170
*/
171171
AtSignInWord = 'tsdoc-at-sign-in-word',
172172

tsdoc/src/transforms/DocNodeTransforms.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ export class DocNodeTransforms {
88
/**
99
* trimSpacesInParagraphNodes() collapses extra spacing characters from plain text nodes.
1010
*
11-
* @remark
11+
* @remarks
1212
* This is useful when emitting HTML, where any number of spaces are equivalent
1313
* to a single space. It's also useful when emitting Markdown, where spaces
1414
* can be misinterpreted as an indented code block.

0 commit comments

Comments
 (0)