docs: address lint errors in TSDoc comments

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---

Author: Planeshifter

lib/node_modules/@stdlib/ndarray/base/sub2ind/docs/types/index.d.ts

@@ -16,6 +16,8 @@
 * limitations under the License.
 */
 
+/* eslint-disable jsdoc/check-param-names */
+
 // TypeScript Version: 4.1
 
 /// <reference types="@stdlib/types"/>
@@ -118,7 +120,7 @@ import { ArrayLike } from '@stdlib/types/array';
 * var shape = [ 3, 3, 3 ];
 * var strides = [ 9, 3, 1 ];
 * var offset = 0;
-* var mode = [ 'throw' ]
+* var mode = [ 'throw' ];
 *
 * var idx = sub2ind( shape, strides, offset, 1, 2, 2, mode );
 * // returns 17

lib/node_modules/@stdlib/ndarray/dispatch/docs/types/index.d.ts

@@ -16,6 +16,10 @@
 * limitations under the License.
 */
 
+// FIXME: Re-enable `stdlib/tsdoc-declarations-doctest` lint rule once `@stdlib/ndarray/base/ternary`, `@stdlib/ndarray/base/quaternary`, and `@stdlib/ndarray/base/quinary` exist...
+
+/* eslint-disable stdlib/tsdoc-declarations-doctest */
+
 // TypeScript Version: 4.1
 
 /// <reference types="@stdlib/types"/>

lib/node_modules/@stdlib/ndarray/fill-slice/docs/types/index.d.ts

@@ -163,7 +163,7 @@ declare function fillSlice<T extends complexndarray>( x: T, value: number | Comp
 * // returns true
 *
 * var arr = ndarray2array( x );
-* // returns [ [ 0, 0, 0, 0, 0, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ] ]
+* // returns [ [ 0, 0, 0, 0 ], [ 0, 0, 5, 5 ], [ 0, 0, 5, 5 ] ]
 *
 * @example
 * var zeros = require( '@stdlib/ndarray/zeros' );
@@ -186,7 +186,7 @@ declare function fillSlice<T extends complexndarray>( x: T, value: number | Comp
 * // returns true
 *
 * var arr = ndarray2array( x );
-* // returns [ [ 0, 0, 0, 0, 0, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ] ]
+* // returns [ [ 0, 0, 0, 0 ], [ 0, 0, 5, 5 ], [ 0, 0, 5, 5 ] ]
 */
 declare function fillSlice<T = unknown, U extends typedndarray<T> = typedndarray<T>>( x: U, value: Element<U>, s: MultiSlice | ArrayLike<SliceArgument>, options?: Options ): U;
 
@@ -256,7 +256,7 @@ declare function fillSlice<T = unknown, U extends typedndarray<T> = typedndarray
 * // returns true
 *
 * var arr = ndarray2array( x );
-* // returns [ [ 0, 0, 0, 0, 0, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ] ]
+* // returns [ [ 0, 0, 0, 0 ], [ 0, 0, 5, 5 ], [ 0, 0, 5, 5 ] ]
 *
 * @example
 * var zeros = require( '@stdlib/ndarray/zeros' );
@@ -279,7 +279,7 @@ declare function fillSlice<T = unknown, U extends typedndarray<T> = typedndarray
 * // returns true
 *
 * var arr = ndarray2array( x );
-* // returns [ [ 0, 0, 0, 0, 0, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ], [ 0, 0, 0, 0, 0, 0, 5, 5 ] ]
+* // returns [ [ 0, 0, 0, 0 ], [ 0, 0, 5, 5 ], [ 0, 0, 5, 5 ] ]
 */
 declare function fillSlice<T = unknown, U = unknown>( x: genericndarray<T>, value: U, s: MultiSlice | ArrayLike<SliceArgument>, options?: Options ): genericndarray<T | U>;
 

lib/node_modules/@stdlib/ndarray/filter/docs/types/index.d.ts

@@ -1233,7 +1233,7 @@ declare function filter<T = unknown, V = unknown>( x: typedndarray<T>, options:
 * var buffer = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] );
 * var shape = [ 2, 3 ];
 * var strides = [ 3, 1 ];
-* var offset = 1;
+* var offset = 0;
 *
 * var x = ndarray( 'complex128', buffer, shape, strides, offset, 'row-major' );
 * // returns <ndarray>
@@ -1269,7 +1269,7 @@ declare function filter<T = unknown, V = unknown>( x: typedndarray<T>, options:
 * var buffer = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] );
 * var shape = [ 2, 3 ];
 * var strides = [ 3, 1 ];
-* var offset = 1;
+* var offset = 0;
 *
 * var x = ndarray( 'complex128', buffer, shape, strides, offset, 'row-major' );
 * // returns <ndarray>

lib/node_modules/@stdlib/ndarray/flatten-by/docs/types/index.d.ts

@@ -195,11 +195,11 @@ declare function flattenBy<T extends ComplexLike = ComplexLike, U extends typedn
 * var x = ndarray( 'uint8c', buffer, shape, strides, offset, 'row-major' );
 * // returns <ndarray>
 *
-* var y = flattenBy( x, scale );
+* var y = flattenBy( x, invert );
 * // returns <ndarray>
 *
 * var arr = ndarray2array( y );
-* // returns [ false, true, false, true, false, true ]
+* // returns [ 0, 1, 0, 1, 0, 1 ]
 */
 declare function flattenBy<T extends typedndarray<boolean> = typedndarray<boolean>, ThisArg = unknown>( x: T, fcn: Callback<boolean, T, boolean, ThisArg>, thisArg?: ThisParameterType<Callback<boolean, T, boolean, ThisArg>> ): T;
 
@@ -347,11 +347,11 @@ declare function flattenBy<T extends ComplexLike = ComplexLike, U extends typedn
 *     'depth': 2
 * };
 *
-* var y = flattenBy( x, opts, scale );
+* var y = flattenBy( x, opts, invert );
 * // returns <ndarray>
 *
 * var arr = ndarray2array( y );
-* // returns [ false, true, false, true, false, true ]
+* // returns [ 0, 1, 0, 1, 0, 1 ]
 */
 declare function flattenBy<T extends typedndarray<boolean> = typedndarray<boolean>, ThisArg = unknown>( x: T, options: BaseOptions, fcn: Callback<boolean, T, boolean, ThisArg>, thisArg?: ThisParameterType<Callback<boolean, T, boolean, ThisArg>> ): T;
 

lib/node_modules/@stdlib/ndarray/reject/docs/types/index.d.ts

@@ -1233,7 +1233,7 @@ declare function reject<T = unknown, V = unknown>( x: typedndarray<T>, options:
 * var buffer = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] );
 * var shape = [ 2, 3 ];
 * var strides = [ 3, 1 ];
-* var offset = 1;
+* var offset = 0;
 *
 * var x = ndarray( 'complex128', buffer, shape, strides, offset, 'row-major' );
 * // returns <ndarray>
@@ -1269,7 +1269,7 @@ declare function reject<T = unknown, V = unknown>( x: typedndarray<T>, options:
 * var buffer = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] );
 * var shape = [ 2, 3 ];
 * var strides = [ 3, 1 ];
-* var offset = 1;
+* var offset = 0;
 *
 * var x = ndarray( 'complex128', buffer, shape, strides, offset, 'row-major' );
 * // returns <ndarray>