docs: update descriptions to be more neutral regarding output values

---
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: passed
  - task: lint_package_json
    status: passed
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - 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: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/random/tools/unary/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # Random
 
-> Constructor for creating ndarrays filled with pseudorandom numbers drawn from a single-parameter probability distribution.
+> Constructor for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.
 
 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
 
@@ -42,7 +42,7 @@ var Random = require( '@stdlib/random/tools/unary' );
 
 #### Random( prng, idtypes odtypes, policies\[, options] )
 
-Returns an interface for creating ndarrays filled with pseudorandom numbers drawn from a single-parameter probability distribution.
+Returns an interface for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -63,7 +63,7 @@ var rand = new Random( exponential, idt, odt, policies, options );
 
 The constructor has the following parameters:
 
--   **prng**: unary pseudorandom number generator.
+-   **prng**: unary pseudorandom value generator.
 
 -   **idtypes**: list of supported input data types.
 
@@ -77,11 +77,11 @@ The constructor has the following parameters:
 
 The constructor supports the following options:
 
--   **order**: default memory layout [order][@stdlib/ndarray/orders].
+-   **order**: default [memory layout][@stdlib/ndarray/orders].
 
 #### Random.prototype.generate( shape, param1\[, options] )
 
-Returns an ndarray filled with pseudorandom numbers drawn from a probability distribution.
+Returns an ndarray filled with pseudorandom values drawn from a unary PRNG.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -106,7 +106,7 @@ var v = rand.generate( [ 2, 2 ], 2.0 );
 The method has the following parameters:
 
 -   **shape**: output ndarray shape.
--   **param1**: distribution parameter. May be either a scalar or an ndarray. If an ndarray, must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] with the specified output ndarray shape.
+-   **param1**: PRNG parameter. May be either a scalar or an ndarray. If an ndarray, must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] with the specified output ndarray shape.
 -   **options**: function options (_optional_).
 
 The method accepts the following options:
@@ -147,7 +147,7 @@ var dt = getDType( v );
 
 #### Random.prototype.assign( param1, out )
 
-Fills an ndarray with pseudorandom numbers drawn from a probability distribution.
+Fills an ndarray with pseudorandom values drawn from a unary PRNG.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -176,7 +176,7 @@ var bool = ( v === out );
 
 The method has the following parameters:
 
--   **param1**: distribution parameter. May be either a scalar or an ndarray. If an ndarray, must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] with the output ndarray.
+-   **param1**: PRNG parameter. May be either a scalar or an ndarray. If an ndarray, must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] with the output ndarray.
 -   **out**: output ndarray.
 
 </section>

lib/node_modules/@stdlib/random/tools/unary/docs/repl.txt

@@ -1,12 +1,12 @@
 
 {{alias}}( prng, idtypes, odtypes, policies[, options] )
-    Returns an interface for creating ndarrays filled with pseudorandom numbers
-    drawn from a single-parameter probability distribution.
+    Returns an interface for creating ndarrays filled with pseudorandom values
+    drawn from a unary PRNG.
 
     Parameters
     ----------
     prng: Function
-        Unary pseudorandom number generator.
+        Unary pseudorandom value generator.
 
     idtypes: Array<string>
         List of supported input data types.
@@ -23,12 +23,12 @@
         Function options.
 
     options.order: string (optional)
-        Default memory layout order.
+        Default memory layout.
 
     Returns
     -------
     out: Object
-        Instance having methods for generating pseudorandom numbers.
+        Instance having methods for generating pseudorandom values.
 
     Examples
     --------
@@ -39,17 +39,16 @@
 
 
 {{alias}}.prototype.generate( shape, param1[, options] )
-    Returns an ndarray filled with pseudorandom numbers drawn from a probability
-    distribution.
+    Returns an ndarray filled with pseudorandom values drawn from a unary PRNG.
 
     Parameters
     ----------
     shape: Array<integer>
         Output shape.
 
-    param1: number|ComplexLike|ndarray
-        Distribution parameter. If an ndarray, must be broadcast compatible with
-        the specified output shape.
+    param1: ndarray|any
+        PRNG parameter. If an ndarray, must be broadcast compatible with the
+        specified output shape.
 
     options: Object (optional)
         Function options.
@@ -89,14 +88,13 @@
 
 
 {{alias}}.prototype.assign( param1, out[, options] )
-    Fills an ndarray with pseudorandom numbers drawn from a probability
-    distribution.
+    Fills an ndarray with pseudorandom values drawn from a unary PRNG.
 
     Parameters
     ----------
-    param1: number|ComplexLike|ndarray
-        Distribution parameter. If an ndarray, must be broadcast compatible with
-        the output ndarray.
+    param1: ndarray|any
+        PRNG parameter. If an ndarray, must be broadcast compatible with the
+        output ndarray.
 
     out: ndarray
         Output ndarray.

lib/node_modules/@stdlib/random/tools/unary/lib/index.js

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Constructor for creating ndarrays filled with pseudorandom numbers drawn from a single-parameter probability distribution.
+* Constructor for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.
 *
 * @module @stdlib/random/tools/unary
 *

lib/node_modules/@stdlib/random/tools/unary/lib/main.js

@@ -64,10 +64,10 @@ var validate = require( './validate.js' );
 // MAIN //
 
 /**
-* Constructor for creating ndarrays filled with pseudorandom numbers drawn from a single-parameter probability distribution.
+* Constructor for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.
 *
 * @constructor
-* @param {Function} prng - unary pseudorandom number generator
+* @param {Function} prng - unary pseudorandom value generator
 * @param {StringArray} idtypes - list of supported input data types
 * @param {StringArray} odtypes - list of supported output data types
 * @param {Object} policies - policies
@@ -181,22 +181,22 @@ function Random( prng, idtypes, odtypes, policies, options ) {
 }
 
 /**
-* Returns an ndarray filled with pseudorandom numbers drawn from a probability distribution.
+* Returns an ndarray filled with pseudorandom values drawn from a unary PRNG.
 *
 * @name generate
 * @memberof Random.prototype
 * @type {Function}
 * @param {NonNegativeIntegerArray} shape - output shape
-* @param {(number|ComplexLike|ndarrayLike)} param1 - distribution parameter
+* @param {(ndarrayLike|*)} param1 - PRNG parameter
 * @param {Options} [options] - function options
 * @param {string} [options.dtype] - output ndarray data type
 * @param {string} [options.order] - memory layout (either row-major or column-major)
 * @param {string} [options.mode] - specifies how to handle indices which exceed ndarray dimensions
 * @param {StringArray} [options.submode] - specifies how to handle subscripts which exceed ndarray dimensions on a per dimension basis
 * @param {boolean} [options.readonly] - boolean indicating whether an ndarray should be read-only
 * @throws {TypeError} first argument must be a valid shape
-* @throws {TypeError} must provide valid distribution parameters
-* @throws {TypeError} distribution parameters and the desired shape must be broadcast compatible
+* @throws {TypeError} must provide valid PRNG parameters
+* @throws {TypeError} PRNG parameters and the desired shape must be broadcast compatible
 * @throws {TypeError} options argument must be an object
 * @throws {TypeError} must provide valid options
 * @returns {ndarray} output ndarray
@@ -245,7 +245,7 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 			throw err;
 		}
 	}
-	// Check whether we've been provided a scalar distribution parameter...
+	// Check whether we've been provided a scalar PRNG parameter...
 	if ( isNumber( param1 ) ) {
 		p1 = param1;
 		dt = 'float64';
@@ -262,17 +262,19 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 		dt = getDType( param1 );
 		sh = getShape( param1 );
 
-		// Check whether the distribution parameter is a zero-dimensional array...
+		// Check whether the PRNG parameter is a zero-dimensional array...
 		if ( sh.length === 0 ) {
 			p1 = param1.get();
 			FLG = true;
 		} else {
-			// Broadcast the distribution parameter to the desired shape:
+			// Broadcast the PRNG parameter to the desired shape:
 			p1 = broadcast( param1, shape ); // delegate to `broadcast` to ensure broadcast compatibility
 			FLG = false;
 		}
 	} else {
-		throw new TypeError( format( 'invalid argument. Second argument must be either a scalar or an ndarray-like object. Value: `%s`.', param1 ) );
+		p1 = param1;
+		dt = 'generic';
+		FLG = true;
 	}
 	if ( !contains( this._idtypes, dt ) ) {
 		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes, '", "' ), dt ) );
@@ -307,7 +309,7 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 		}
 		return new ndarray( dt, buf, shape, st, 0, ord, opts );
 	}
-	// If provided a scalar distribution parameter, we can simply fill a linear buffer with pseudorandom numbers (as all pseudorandom numbers are drawn from the same distribution) and then wrap as an ndarray...
+	// If provided a scalar PRNG parameter, we can simply fill a linear buffer with pseudorandom values (as all pseudorandom values are drawn from the same PRNG) and then wrap as an ndarray...
 	if ( FLG ) {
 		if ( dt === 'generic' ) {
 			buf = filledBy( len, wrapper );
@@ -327,7 +329,7 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 	st = shape2strides( shape, ord );
 	out = new ndarray( dt, buf, shape, st, 0, ord, opts );
 
-	// Fill the output array with pseudorandom numbers:
+	// Fill the output array with pseudorandom values:
 	unary( [ p1, out ], prng );
 
 	return out;
@@ -344,16 +346,16 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 });
 
 /**
-* Fills an ndarray with pseudorandom numbers drawn from a probability distribution.
+* Fills an ndarray with pseudorandom values drawn from a unary PRNG.
 *
 * @name assign
 * @memberof Random.prototype
 * @type {Function}
-* @param {(number|ComplexLike|ndarrayLike)} param1 - distribution parameter
+* @param {(ndarrayLike|*)} param1 - PRNG parameter
 * @param {ndarrayLike} out - output ndarray
 * @throws {TypeError} second argument must be an ndarray
-* @throws {TypeError} must provide valid distribution parameters
-* @throws {TypeError} distribution parameters and the output ndarray must be broadcast compatible
+* @throws {TypeError} must provide valid PRNG parameters
+* @throws {TypeError} PRNG parameters and the output ndarray must be broadcast compatible
 * @throws {Error} cannot write to a read-only ndarray
 * @returns {ndarray} output ndarray
 *
@@ -391,7 +393,7 @@ setReadOnly( Random.prototype, 'assign', function assign( param1, out ) {
 	if ( isReadOnly( out ) ) {
 		throw new Error( 'invalid argument. The output ndarray must be writable. Cannot write to a read-only ndarray.' );
 	}
-	// Check whether we've been provided a scalar distribution parameter...
+	// Check whether we've been provided a scalar PRNG parameter...
 	if ( isNumber( param1 ) ) {
 		// Wrap the scalar in a broadcasted ndarray:
 		pdt = 'float64';
@@ -405,11 +407,13 @@ setReadOnly( Random.prototype, 'assign', function assign( param1, out ) {
 		// Wrap the scalar in a broadcasted ndarray:
 		p1 = broadcastScalar( param1, pdt, getShape( out ), getOrder( out ) );
 	} else if ( isndarrayLike( param1 ) ) {
-		// Broadcast the distribution parameter to the desired shape:
+		// Broadcast the PRNG parameter to the desired shape:
 		pdt = getDType( param1 );
 		p1 = broadcast( param1, getShape( out ) ); // delegate to `broadcast` to ensure broadcast compatibility
 	} else {
-		throw new TypeError( format( 'invalid argument. First argument must be either a scalar or an ndarray-like object. Value: `%s`.', param1 ) );
+		// Wrap the scalar in a broadcasted ndarray:
+		pdt = 'generic';
+		p1 = broadcastScalar( param1, pdt, getShape( out ), getOrder( out ) );
 	}
 	if ( !contains( this._idtypes, pdt ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes, '", "' ), pdt ) );
@@ -418,7 +422,7 @@ setReadOnly( Random.prototype, 'assign', function assign( param1, out ) {
 	if ( !contains( this._odtypes, odt ) ) {
 		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._odtypes, '", "' ), odt ) );
 	}
-	// Fill the output array with pseudorandom numbers:
+	// Fill the output array with pseudorandom values:
 	unary( [ p1, out ], this._prng );
 
 	return out;

lib/node_modules/@stdlib/random/tools/unary/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/random/tools/unary",
   "version": "0.0.0",
-  "description": "Constructor for creating ndarrays filled with pseudorandom numbers drawn from a single-parameter probability distribution.",
+  "description": "Constructor for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",