Skip to content

Commit 76db518

Browse files
authored
docs: update blas/ext/base/dcusumors to follow current project conventions
PR-URL: #5169 Reviewed-by: Philipp Burckhardt <[email protected]>
1 parent 8e5b82c commit 76db518

File tree

8 files changed

+37
-37
lines changed

8 files changed

+37
-37
lines changed

lib/node_modules/@stdlib/blas/ext/base/dcusumors/README.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -61,11 +61,11 @@ The function has the following parameters:
6161
- **N**: number of indexed elements.
6262
- **sum**: initial sum.
6363
- **x**: input [`Float64Array`][@stdlib/array/float64].
64-
- **strideX**: index increment for `x`.
64+
- **strideX**: stride length for `x`.
6565
- **y**: output [`Float64Array`][@stdlib/array/float64].
66-
- **strideY**: index increment for `y`.
66+
- **strideY**: stride length for `y`.
6767

68-
The `N` and stride parameters determine which elements in the strided arrays are accessed at runtime. For example, to compute the cumulative sum of every other element in the strided input array,
68+
The `N` and stride parameters determine which elements in the strided arrays are accessed at runtime. For example, to compute the cumulative sum of every other element:
6969

7070
```javascript
7171
var Float64Array = require( '@stdlib/array/float64' );
@@ -115,7 +115,7 @@ The function has the following additional parameters:
115115
- **offsetX**: starting index for `x`.
116116
- **offsetY**: starting index for `y`.
117117

118-
While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, offset parameters support indexing semantics based on starting indices. For example, to calculate the cumulative sum of every other value in the strided input array starting from the second value and to store in the last `N` elements of the strided output array starting from the last element
118+
While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, the offset parameters support indexing semantics based on starting indices. For example, to calculate the cumulative sum of every other value in the strided input array starting from the second value and to store in the last `N` elements of the strided output array starting from the last element:
119119

120120
```javascript
121121
var Float64Array = require( '@stdlib/array/float64' );
@@ -211,9 +211,9 @@ The function accepts the following arguments:
211211
- **N**: `[in] CBLAS_INT` number of indexed elements.
212212
- **sum**: `[in] double` initial sum.
213213
- **X**: `[in] double*` input array.
214-
- **strideX**: `[in] CBLAS_INT` index increment for `X`.
214+
- **strideX**: `[in] CBLAS_INT` stride length for `X`.
215215
- **Y**: `[out] double*` output array.
216-
- **strideY**: `[in] CBLAS_INT` index increment for `Y`.
216+
- **strideY**: `[in] CBLAS_INT` stride length for `Y`.
217217
218218
```c
219219
void stdlib_strided_dcusumors( const CBLAS_INT N, double sum, const double *X, const CBLAS_INT strideX, double *Y, const CBLAS_INT strideY );
@@ -239,10 +239,10 @@ The function accepts the following arguments:
239239
- **N**: `[in] CBLAS_INT` number of indexed elements.
240240
- **sum**: `[in] double` initial sum.
241241
- **X**: `[in] double*` input array.
242-
- **strideX**: `[in] CBLAS_INT` index increment for `X`.
242+
- **strideX**: `[in] CBLAS_INT` stride length for `X`.
243243
- **offsetX**: `[in] CBLAS_INT` starting index for `X`.
244244
- **Y**: `[out] double*` output array.
245-
- **strideY**: `[in] CBLAS_INT` index increment for `Y`.
245+
- **strideY**: `[in] CBLAS_INT` stride length for `Y`.
246246
- **offsetY**: `[in] CBLAS_INT` starting index for `Y`.
247247
248248
```c

lib/node_modules/@stdlib/blas/ext/base/dcusumors/docs/repl.txt

+9-9
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
Computes the cumulative sum of double-precision floating-point strided array
44
elements using ordinary recursive summation.
55

6-
The `N` and stride parameters determine which elements in the strided
7-
arrays are accessed at runtime.
6+
The `N` and stride parameters determine which elements in the strided arrays
7+
are accessed at runtime.
88

99
Indexing is relative to the first index. To introduce an offset, use a typed
1010
array view.
@@ -23,13 +23,13 @@
2323
Input array.
2424

2525
strideX: integer
26-
Index increment for `x`.
26+
Stride length for `x`.
2727

2828
y: Float64Array
2929
Output array.
3030

3131
strideY: integer
32-
Index increment for `y`.
32+
Stride length for `y`.
3333

3434
Returns
3535
-------
@@ -44,7 +44,7 @@
4444
> {{alias}}( x.length, 0.0, x, 1, y, 1 )
4545
<Float64Array>[ 1.0, -1.0, 1.0 ]
4646

47-
// Using `N` and `stride` parameters:
47+
// Using `N` and stride parameters:
4848
> x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 1.0, -5.0, 2.0, -1.0 ] );
4949
> y = new {{alias:@stdlib/array/float64}}( x.length );
5050
> {{alias}}( 3, 0.0, x, 2, y, 2 )
@@ -67,8 +67,8 @@
6767
semantics.
6868

6969
While typed array views mandate a view offset based on the underlying
70-
buffer, the offset parameters support indexing semantics based on a
71-
starting index.
70+
buffer, the offset parameters support indexing semantics based on starting
71+
indices.
7272

7373
Parameters
7474
----------
@@ -82,7 +82,7 @@
8282
Input array.
8383

8484
strideX: integer
85-
Index increment for `x`.
85+
Stride length for `x`.
8686

8787
offsetX: integer
8888
Starting index for `x`.
@@ -91,7 +91,7 @@
9191
Output array.
9292

9393
strideY: integer
94-
Index increment for `y`.
94+
Stride length for `y`.
9595

9696
offsetY: integer
9797
Starting index for `y`.

lib/node_modules/@stdlib/blas/ext/base/dcusumors/docs/types/index.d.ts

+6-6
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@ interface Routine {
2828
* @param N - number of indexed elements
2929
* @param sum - initial sum
3030
* @param x - input array
31-
* @param strideX - `x` stride length
31+
* @param strideX - stride length for `x`
3232
* @param y - output array
33-
* @param strideY - `y` stride length
33+
* @param strideY - stride length for `y`
3434
* @returns output array
3535
*
3636
* @example
@@ -50,10 +50,10 @@ interface Routine {
5050
* @param N - number of indexed elements
5151
* @param sum - initial sum
5252
* @param x - input array
53-
* @param strideX - `x` stride length
53+
* @param strideX - stride length for `x`
5454
* @param offsetX - starting index for `x`
5555
* @param y - output array
56-
* @param strideY - `y` stride length
56+
* @param strideY - stride length for `y`
5757
* @param offsetY - starting index for `y`
5858
* @returns output array
5959
*
@@ -75,9 +75,9 @@ interface Routine {
7575
* @param N - number of indexed elements
7676
* @param sum - initial sum
7777
* @param x - input array
78-
* @param strideX - `x` stride length
78+
* @param strideX - stride length for `x`
7979
* @param y - output array
80-
* @param strideY - `y` stride length
80+
* @param strideY - stride length for `y`
8181
* @returns output array
8282
*
8383
* @example

lib/node_modules/@stdlib/blas/ext/base/dcusumors/lib/dcusumors.js

+2-2
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ var ndarray = require( './ndarray.js' );
3232
* @param {PositiveInteger} N - number of indexed elements
3333
* @param {number} sum - initial sum
3434
* @param {Float64Array} x - input array
35-
* @param {integer} strideX - `x` stride length
35+
* @param {integer} strideX - stride length for `x`
3636
* @param {Float64Array} y - output array
37-
* @param {integer} strideY - `y` stride length
37+
* @param {integer} strideY - stride length for `y`
3838
* @returns {Float64Array} output array
3939
*
4040
* @example

lib/node_modules/@stdlib/blas/ext/base/dcusumors/lib/dcusumors.native.js

+2-2
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@ var addon = require( './../src/addon.node' );
3131
* @param {PositiveInteger} N - number of indexed elements
3232
* @param {number} sum - initial sum
3333
* @param {Float64Array} x - input array
34-
* @param {integer} strideX - `x` stride length
34+
* @param {integer} strideX - stride length for `x`
3535
* @param {Float64Array} y - output array
36-
* @param {integer} strideY - `y` stride length
36+
* @param {integer} strideY - stride length for `y`
3737
* @returns {Float64Array} output array
3838
*
3939
* @example

lib/node_modules/@stdlib/blas/ext/base/dcusumors/lib/ndarray.js

+2-2
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,10 @@
2626
* @param {PositiveInteger} N - number of indexed elements
2727
* @param {number} sum - initial sum
2828
* @param {Float64Array} x - input array
29-
* @param {integer} strideX - `x` stride length
29+
* @param {integer} strideX - stride length for `x`
3030
* @param {NonNegativeInteger} offsetX - starting index for `x`
3131
* @param {Float64Array} y - output array
32-
* @param {integer} strideY - `y` stride length
32+
* @param {integer} strideY - stride length for `y`
3333
* @param {NonNegativeInteger} offsetY - starting index for `y`
3434
* @returns {Float64Array} output array
3535
*

lib/node_modules/@stdlib/blas/ext/base/dcusumors/lib/ndarray.native.js

+2-2
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ var addon = require( './../src/addon.node' );
3131
* @param {PositiveInteger} N - number of indexed elements
3232
* @param {number} sum - initial sum
3333
* @param {Float64Array} x - input array
34-
* @param {integer} strideX - `x` stride length
34+
* @param {integer} strideX - stride length for `x`
3535
* @param {NonNegativeInteger} offsetX - starting index for `x`
3636
* @param {Float64Array} y - output array
37-
* @param {integer} strideY - `y` stride length
37+
* @param {integer} strideY - stride length for `y`
3838
* @param {NonNegativeInteger} offsetY - starting index for `y`
3939
* @returns {Float64Array} output array
4040
*

lib/node_modules/@stdlib/blas/ext/base/dcusumors/src/main.c

+6-6
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@
2626
* @param N number of indexed elements
2727
* @param sum initial sum
2828
* @param X input array
29-
* @param strideX X stride length
29+
* @param strideX stride length for X
3030
* @param Y output array
31-
* @param strideY Y stride length
31+
* @param strideY stride length for Y
3232
*/
3333
void API_SUFFIX(stdlib_strided_dcusumors)( const CBLAS_INT N, double sum, const double *X, const CBLAS_INT strideX, double *Y, const CBLAS_INT strideY ) {
3434
const CBLAS_INT ox = stdlib_strided_stride2offset( N, strideX );
@@ -42,11 +42,11 @@ void API_SUFFIX(stdlib_strided_dcusumors)( const CBLAS_INT N, double sum, const
4242
* @param N number of indexed elements
4343
* @param sum initial sum
4444
* @param X input array
45-
* @param strideX X index increment
46-
* @param offsetX X starting index
45+
* @param strideX stride length for X
46+
* @param offsetX starting index for X
4747
* @param Y output array
48-
* @param strideY Y index increment
49-
* @param offsetY Y starting index
48+
* @param strideY stride length for Y
49+
* @param offsetY stating index for Y
5050
*/
5151
void API_SUFFIX(stdlib_strided_dcusumors_ndarray)( const CBLAS_INT N, double sum, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, double *Y, const CBLAS_INT strideY, const CBLAS_INT offsetY ) {
5252
CBLAS_INT ix;

0 commit comments

Comments
 (0)