Skip to content

Commit 2e1dfce

Browse files
committed
Add spaces afer @param and @return, as per Volker's request.
1 parent 09e0693 commit 2e1dfce

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+707
-707
lines changed

mathjax3-ts/adaptors/browserAdaptor.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ declare global {
4040
/**
4141
* Function to create an HTML adpator for browsers
4242
*
43-
* @return{HTMLAdaptor} The newly created adaptor
43+
* @return {HTMLAdaptor} The newly created adaptor
4444
*/
4545
export function browserAdaptor() {
4646
return new HTMLAdaptor<HTMLElement, Text, Document>(window);

mathjax3-ts/adaptors/jsdomAdaptor.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,8 @@ import {HTMLAdaptor} from './HTMLAdaptor.js';
2626
/**
2727
* Function for creating an HTML adaptor using jsdom
2828
*
29-
* @param{any} JSDOM The jsdom object to use for this adaptor
30-
* @return{HTMLAdaptor} The newly created adaptor
29+
* @param {any} JSDOM The jsdom object to use for this adaptor
30+
* @return {HTMLAdaptor} The newly created adaptor
3131
*/
3232
export function jsdomAdaptor(JSDOM: any) {
3333
return new HTMLAdaptor<HTMLElement, Text, Document>(new JSDOM().window);

mathjax3-ts/adaptors/lite/Element.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,9 @@ export class LiteElement {
6767
public styles: Styles;
6868

6969
/**
70-
* @param{string} kind The type of node to create
71-
* @param{LiteAttributeList} attributes The list of attributes to set (if any)
72-
* @param{LiteNode[]} children The children for the node (if any)
70+
* @param {string} kind The type of node to create
71+
* @param {LiteAttributeList} attributes The list of attributes to set (if any)
72+
* @param {LiteNode[]} children The children for the node (if any)
7373
* @constructor
7474
*/
7575
constructor(kind: string, attributes: LiteAttributeList = {}, children: LiteNode[] = []) {

mathjax3-ts/adaptors/lite/List.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,15 +36,15 @@ export class LiteList<N> {
3636
public nodes: N[] = [];
3737

3838
/**
39-
* @param{N[]} children The children for the fragment
39+
* @param {N[]} children The children for the fragment
4040
* @constructor
4141
*/
4242
constructor(children: N[]) {
4343
this.nodes = [...children];
4444
}
4545

4646
/**
47-
* @param{N} node A node to append to the fragment
47+
* @param {N} node A node to append to the fragment
4848
*/
4949
public append(node: N) {
5050
this.nodes.push(node);

mathjax3-ts/adaptors/lite/Parser.ts

Lines changed: 36 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -142,31 +142,31 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
142142
}
143143

144144
/**
145-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
146-
* @param{LiteElement} node The node to add a text element to
147-
* @param{string} text The text for the text node
148-
* @return{LiteText} The text element
145+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
146+
* @param {LiteElement} node The node to add a text element to
147+
* @param {string} text The text for the text node
148+
* @return {LiteText} The text element
149149
*/
150150
protected addText(adaptor: LiteAdaptor, node: LiteElement, text: string) {
151151
text = Entities.translate(text);
152152
return adaptor.append(node, adaptor.text(text)) as LiteText;
153153
}
154154

155155
/**
156-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
157-
* @param{LiteElement} node The node to add a comment to
158-
* @param{string} comment The text for the comment node
159-
* @return{LiteText} The comment element
156+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
157+
* @param {LiteElement} node The node to add a comment to
158+
* @param {string} comment The text for the comment node
159+
* @return {LiteText} The comment element
160160
*/
161161
protected addComment(adaptor: LiteAdaptor, node: LiteElement, comment: string) {
162162
return adaptor.append(node, new LiteComment(comment)) as LiteComment;
163163
}
164164

165165
/**
166-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
167-
* @param{LiteElement} node The node to close
168-
* @param{string} tag The close tag being processed
169-
* @return{LiteElement} The first unclosed parent node
166+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
167+
* @param {LiteElement} node The node to close
168+
* @param {string} tag The close tag being processed
169+
* @return {LiteElement} The first unclosed parent node
170170
*/
171171
protected closeTag(adaptor: LiteAdaptor, node: LiteElement, tag: string) {
172172
const kind = tag.slice(2,tag.length - 1).toLowerCase();
@@ -177,11 +177,11 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
177177
}
178178

179179
/**
180-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
181-
* @param{LiteElement} node The parent node for the tag
182-
* @param{string} tag The tag being processed
183-
* @param{string[]} parts The rest of the text/tag array
184-
* @return{LiteElement} The node to which the next tag will be added
180+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
181+
* @param {LiteElement} node The parent node for the tag
182+
* @param {string} tag The tag being processed
183+
* @param {string[]} parts The rest of the text/tag array
184+
* @return {LiteElement} The node to which the next tag will be added
185185
*/
186186
protected openTag(adaptor: LiteAdaptor, node: LiteElement, tag: string, parts: string[]) {
187187
const PCDATA = (this.constructor as typeof LiteParser).PCDATA;
@@ -223,9 +223,9 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
223223
}
224224

225225
/**
226-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
227-
* @param{LiteElement} node The node getting the attributes
228-
* @param{string[]} attributes The array of space, name, value1, value2, value3
226+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
227+
* @param {LiteElement} node The node getting the attributes
228+
* @param {string[]} attributes The array of space, name, value1, value2, value3
229229
* as described above.
230230
*/
231231
protected addAttributes(adaptor: LiteAdaptor, node: LiteElement, attributes: string[]) {
@@ -241,10 +241,10 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
241241
}
242242

243243
/**
244-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
245-
* @param{LiteElement} node The node whose PCDATA content is being collected
246-
* @param{string} kind The tag name being handled
247-
* @param{string[]} parts The array of text/tag data for the document
244+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
245+
* @param {LiteElement} node The node whose PCDATA content is being collected
246+
* @param {string} kind The tag name being handled
247+
* @param {string[]} parts The array of text/tag data for the document
248248
*/
249249
protected handlePCDATA(adaptor: LiteAdaptor, node: LiteElement, kind: string, parts: string[]) {
250250
const pcdata = [] as string[];
@@ -271,8 +271,8 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
271271
* tags into the document structure. That way, you can parse fragements or
272272
* full documents and still get a valid document.
273273
*
274-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
275-
* @param{LiteDocuemnt} root The document being checked
274+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
275+
* @param {LiteDocuemnt} root The document being checked
276276
*/
277277
protected checkDocument(adaptor: LiteAdaptor, root: LiteDocument) {
278278
if (adaptor.childNodes(adaptor.body(root)).length !== 1) return;
@@ -316,9 +316,9 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
316316
}
317317

318318
/**
319-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
320-
* @param{LiteElement} node The node to serialize
321-
* @return{string} The serialized element (like outerHTML)
319+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
320+
* @param {LiteElement} node The node to serialize
321+
* @return {string} The serialized element (like outerHTML)
322322
*/
323323
public serialize(adaptor: LiteAdaptor, node: LiteElement) {
324324
const SELF_CLOSING = (this.constructor as typeof LiteParser).SELF_CLOSING;
@@ -334,9 +334,9 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
334334
}
335335

336336
/**
337-
* @param{LiteAdaptor} adaptor The adaptor for managing nodes
338-
* @param{LiteElement} node The node whose innerHTML is needed
339-
* @return{string} The serialized element (like innerHTML)
337+
* @param {LiteAdaptor} adaptor The adaptor for managing nodes
338+
* @param {LiteElement} node The node whose innerHTML is needed
339+
* @return {string} The serialized element (like innerHTML)
340340
*/
341341
public serializeInner(adaptor: LiteAdaptor, node: LiteElement) {
342342
return adaptor.childNodes(node).map(x => {
@@ -348,16 +348,16 @@ export class LiteParser implements MinDOMParser<LiteDocument> {
348348
}
349349

350350
/**
351-
* @param{string} text The attribute value to be HTML escaped
352-
* @return{string} The string with " replaced by entities
351+
* @param {string} text The attribute value to be HTML escaped
352+
* @return {string} The string with " replaced by entities
353353
*/
354354
public protectAttribute(text: string) {
355355
return text.replace(/"/, '&quot;');
356356
}
357357

358358
/**
359-
* @param{string} text The text to be HTML escaped
360-
* @return{string} The string with &, <, and > replaced by entities
359+
* @param {string} text The text to be HTML escaped
360+
* @return {string} The string with &, <, and > replaced by entities
361361
*/
362362
public protectHTML(text: string) {
363363
return text.replace(/&/g, '&amp;')

mathjax3-ts/adaptors/lite/Text.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ export class LiteText {
4646
}
4747

4848
/**
49-
* @param{string} text The text for the node
49+
* @param {string} text The text for the node
5050
* @constructor
5151
*/
5252
constructor(text: string = "") {

mathjax3-ts/adaptors/liteAdaptor.ts

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
6464
public parser: LiteParser;
6565

6666
/**
67-
* @param{OptionList} options The options for the lite adaptor (e.g., fontSize)
67+
* @param {OptionList} options The options for the lite adaptor (e.g., fontSize)
6868
* @constructor
6969
*/
7070
constructor(options: OptionList = null) {
@@ -97,15 +97,15 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
9797
}
9898

9999
/**
100-
* @param{string} text The text of the comment
101-
* @return{LiteComment} The comment node
100+
* @param {string} text The text of the comment
101+
* @return {LiteComment} The comment node
102102
*/
103103
public comment(text: string) {
104104
return new LiteComment(text);
105105
}
106106

107107
/**
108-
* @return{LiteDocument} A new document element
108+
* @return {LiteDocument} A new document element
109109
*/
110110
public createDocument() {
111111
return new LiteDocument();
@@ -159,9 +159,9 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
159159
}
160160

161161
/**
162-
* @param{LiteELement} node The node to be searched
163-
* @param{string} id The id of the node to look for
164-
* @return{LiteElement} The child node having the given id
162+
* @param {LiteELement} node The node to be searched
163+
* @param {string} id The id of the node to look for
164+
* @return {LiteElement} The child node having the given id
165165
*/
166166
public elementById(node: LiteElement, id: string) {
167167
let stack = [] as LiteNode[];
@@ -182,9 +182,9 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
182182
}
183183

184184
/**
185-
* @param{LiteELement} node The node to be searched
186-
* @param{string} name The name of the class to find
187-
* @return{LiteElement[]} The nodes with the given class
185+
* @param {LiteELement} node The node to be searched
186+
* @param {string} name The name of the class to find
187+
* @return {LiteElement[]} The nodes with the given class
188188
*/
189189
public elementsByClass(node: LiteElement, name: string) {
190190
let stack = [] as LiteNode[];
@@ -243,8 +243,8 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
243243
}
244244

245245
/**
246-
* @param{LiteNode} node The node whose index is needed
247-
* @return{number} THe index of the node it its parent's children array
246+
* @param {LiteNode} node The node whose index is needed
247+
* @return {number} THe index of the node it its parent's children array
248248
*/
249249
public childIndex(node: LiteNode) {
250250
return (node.parent ? node.parent.children.findIndex(n => n === node) : -1);
@@ -539,8 +539,8 @@ export class LiteAdaptor extends AbstractDOMAdaptor<LiteElement, LiteText, LiteD
539539
/**
540540
* The function to call to obtain a LiteAdaptor
541541
*
542-
* @param{OptionList} options The options for the adaptor
543-
* @return{LiteAdaptor} The newly created adaptor
542+
* @param {OptionList} options The options for the adaptor
543+
* @return {LiteAdaptor} The newly created adaptor
544544
*/
545545
export function liteAdaptor(options: OptionList = null) {
546546
return new LiteAdaptor(options);

0 commit comments

Comments
 (0)