Fix invalid jsdoc tags

This commit is contained in:
Daniel Imms
2022-10-15 08:41:49 -07:00
parent 49e0480f78
commit 9f1a71485c
6 changed files with 17 additions and 17 deletions
+4 -4
View File
@@ -126,7 +126,7 @@ export class SearchAddon extends Disposable implements ITerminalAddon {
* doesn't exist, do nothing. * doesn't exist, do nothing.
* @param term The search term. * @param term The search term.
* @param searchOptions Search options. * @param searchOptions Search options.
* @return Whether a result was found. * @returns Whether a result was found.
*/ */
public findNext(term: string, searchOptions?: ISearchOptions): boolean { public findNext(term: string, searchOptions?: ISearchOptions): boolean {
if (!this._terminal) { if (!this._terminal) {
@@ -307,7 +307,7 @@ export class SearchAddon extends Disposable implements ITerminalAddon {
* doesn't exist, do nothing. * doesn't exist, do nothing.
* @param term The search term. * @param term The search term.
* @param searchOptions Search options. * @param searchOptions Search options.
* @return Whether a result was found. * @returns Whether a result was found.
*/ */
public findPrevious(term: string, searchOptions?: ISearchOptions): boolean { public findPrevious(term: string, searchOptions?: ISearchOptions): boolean {
if (!this._terminal) { if (!this._terminal) {
@@ -480,7 +480,7 @@ export class SearchAddon extends Disposable implements ITerminalAddon {
* @param searchPosition The position to start the search. * @param searchPosition The position to start the search.
* @param searchOptions Search options. * @param searchOptions Search options.
* @param isReverseSearch Whether the search should start from the right side of the terminal and search to the left. * @param isReverseSearch Whether the search should start from the right side of the terminal and search to the left.
* @return The search result if it was found. * @returns The search result if it was found.
*/ */
protected _findInLine(term: string, searchPosition: ISearchPosition, searchOptions: ISearchOptions = {}, isReverseSearch: boolean = false): ISearchResult | undefined { protected _findInLine(term: string, searchPosition: ISearchPosition, searchOptions: ISearchOptions = {}, isReverseSearch: boolean = false): ISearchResult | undefined {
const terminal = this._terminal!; const terminal = this._terminal!;
@@ -662,7 +662,7 @@ export class SearchAddon extends Disposable implements ITerminalAddon {
/** /**
* Selects and scrolls to a result. * Selects and scrolls to a result.
* @param result The result to select. * @param result The result to select.
* @return Whether a result was selected. * @returns Whether a result was selected.
*/ */
private _selectResult(result: ISearchResult | undefined, options?: ISearchDecorationOptions, noScroll?: boolean): boolean { private _selectResult(result: ISearchResult | undefined, options?: ISearchDecorationOptions, noScroll?: boolean): boolean {
const terminal = this._terminal!; const terminal = this._terminal!;
+1 -1
View File
@@ -89,7 +89,7 @@ export class CompositionHelper {
/** /**
* Handles the keydown event, routing any necessary events to the CompositionHelper functions. * Handles the keydown event, routing any necessary events to the CompositionHelper functions.
* @param ev The keydown event. * @param ev The keydown event.
* @return Whether the Terminal should continue processing the keydown event. * @returns Whether the Terminal should continue processing the keydown event.
*/ */
public keydown(ev: KeyboardEvent): boolean { public keydown(ev: KeyboardEvent): boolean {
if (this._isComposing || this._isSendingComposition) { if (this._isComposing || this._isSendingComposition) {
+1 -1
View File
@@ -118,7 +118,7 @@ export class SelectionModel {
/** /**
* Handle the buffer being trimmed, adjust the selection position. * Handle the buffer being trimmed, adjust the selection position.
* @param amount The amount the buffer is being trimmed. * @param amount The amount the buffer is being trimmed.
* @return Whether a refresh is necessary. * @returns Whether a refresh is necessary.
*/ */
public handleTrim(amount: number): boolean { public handleTrim(amount: number): boolean {
// Adjust the selection position based on the trimmed amount. // Adjust the selection position based on the trimmed amount.
+2 -2
View File
@@ -82,7 +82,7 @@ export class CircularList<T> extends Disposable implements ICircularList<T> {
* Note that for performance reasons there is no bounds checking here, the index reference is * Note that for performance reasons there is no bounds checking here, the index reference is
* circular so this should always return a value and never throw. * circular so this should always return a value and never throw.
* @param index The index of the value to get. * @param index The index of the value to get.
* @return The value corresponding to the index. * @returns The value corresponding to the index.
*/ */
public get(index: number): T | undefined { public get(index: number): T | undefined {
return this._array[this._getCyclicIndex(index)]; return this._array[this._getCyclicIndex(index)];
@@ -138,7 +138,7 @@ export class CircularList<T> extends Disposable implements ICircularList<T> {
/** /**
* Removes and returns the last value on the list. * Removes and returns the last value on the list.
* @return The popped value. * @returns The popped value.
*/ */
public pop(): T | undefined { public pop(): T | undefined {
return this._array[this._getCyclicIndex(this._length-- - 1)]; return this._array[this._getCyclicIndex(this._length-- - 1)];
+4 -4
View File
@@ -1080,7 +1080,7 @@ declare module 'xterm-headless' {
* Return true if the sequence was handled; false if we should try * Return true if the sequence was handled; false if we should try
* a previous handler (set by addCsiHandler or setCsiHandler). * a previous handler (set by addCsiHandler or setCsiHandler).
* The most recently added handler is tried first. * The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerCsiHandler(id: IFunctionIdentifier, callback: (params: (number | number[])[]) => boolean): IDisposable; registerCsiHandler(id: IFunctionIdentifier, callback: (params: (number | number[])[]) => boolean): IDisposable;
@@ -1099,7 +1099,7 @@ declare module 'xterm-headless' {
* Return true if the sequence was handled; false if we should try * Return true if the sequence was handled; false if we should try
* a previous handler (set by addDcsHandler or setDcsHandler). * a previous handler (set by addDcsHandler or setDcsHandler).
* The most recently added handler is tried first. * The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerDcsHandler(id: IFunctionIdentifier, callback: (data: string, param: (number | number[])[]) => boolean): IDisposable; registerDcsHandler(id: IFunctionIdentifier, callback: (data: string, param: (number | number[])[]) => boolean): IDisposable;
@@ -1112,7 +1112,7 @@ declare module 'xterm-headless' {
* Return true if the sequence was handled; false if we should try * Return true if the sequence was handled; false if we should try
* a previous handler (set by addEscHandler or setEscHandler). * a previous handler (set by addEscHandler or setEscHandler).
* The most recently added handler is tried first. * The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerEscHandler(id: IFunctionIdentifier, handler: () => boolean): IDisposable; registerEscHandler(id: IFunctionIdentifier, handler: () => boolean): IDisposable;
@@ -1130,7 +1130,7 @@ declare module 'xterm-headless' {
* Return true if the sequence was handled; false if we should try * Return true if the sequence was handled; false if we should try
* a previous handler (set by addOscHandler or setOscHandler). * a previous handler (set by addOscHandler or setOscHandler).
* The most recently added handler is tried first. * The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerOscHandler(ident: number, callback: (data: string) => boolean): IDisposable; registerOscHandler(ident: number, callback: (data: string) => boolean): IDisposable;
} }
+5 -5
View File
@@ -905,7 +905,7 @@ declare module 'xterm' {
* with a string of text that is eligible for joining and returns an array * with a string of text that is eligible for joining and returns an array
* where each entry is an array containing the start (inclusive) and end * where each entry is an array containing the start (inclusive) and end
* (exclusive) indexes of ranges that should be rendered as a single unit. * (exclusive) indexes of ranges that should be rendered as a single unit.
* @return The ID of the new joiner, this can be used to deregister * @returns The ID of the new joiner, this can be used to deregister
*/ */
registerCharacterJoiner(handler: (text: string) => [number, number][]): number; registerCharacterJoiner(handler: (text: string) => [number, number][]): number;
@@ -1558,7 +1558,7 @@ declare module 'xterm' {
* array will contain subarrays with their numercial values. * array will contain subarrays with their numercial values.
* Return `true` if the sequence was handled, `false` if the parser should try * Return `true` if the sequence was handled, `false` if the parser should try
* a previous handler. The most recently added handler is tried first. * a previous handler. The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerCsiHandler(id: IFunctionIdentifier, callback: (params: (number | number[])[]) => boolean | Promise<boolean>): IDisposable; registerCsiHandler(id: IFunctionIdentifier, callback: (params: (number | number[])[]) => boolean | Promise<boolean>): IDisposable;
@@ -1576,7 +1576,7 @@ declare module 'xterm' {
* The function gets the payload and numerical parameters as arguments. * The function gets the payload and numerical parameters as arguments.
* Return `true` if the sequence was handled, `false` if the parser should try * Return `true` if the sequence was handled, `false` if the parser should try
* a previous handler. The most recently added handler is tried first. * a previous handler. The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerDcsHandler(id: IFunctionIdentifier, callback: (data: string, param: (number | number[])[]) => boolean | Promise<boolean>): IDisposable; registerDcsHandler(id: IFunctionIdentifier, callback: (data: string, param: (number | number[])[]) => boolean | Promise<boolean>): IDisposable;
@@ -1588,7 +1588,7 @@ declare module 'xterm' {
* @param callback The function to handle the sequence. * @param callback The function to handle the sequence.
* Return `true` if the sequence was handled, `false` if the parser should try * Return `true` if the sequence was handled, `false` if the parser should try
* a previous handler. The most recently added handler is tried first. * a previous handler. The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerEscHandler(id: IFunctionIdentifier, handler: () => boolean | Promise<boolean>): IDisposable; registerEscHandler(id: IFunctionIdentifier, handler: () => boolean | Promise<boolean>): IDisposable;
@@ -1605,7 +1605,7 @@ declare module 'xterm' {
* The callback is called with OSC data string. * The callback is called with OSC data string.
* Return `true` if the sequence was handled, `false` if the parser should try * Return `true` if the sequence was handled, `false` if the parser should try
* a previous handler. The most recently added handler is tried first. * a previous handler. The most recently added handler is tried first.
* @return An IDisposable you can call to remove this handler. * @returns An IDisposable you can call to remove this handler.
*/ */
registerOscHandler(ident: number, callback: (data: string) => boolean | Promise<boolean>): IDisposable; registerOscHandler(ident: number, callback: (data: string) => boolean | Promise<boolean>): IDisposable;
} }