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-factory/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # createFactory
 
-> Create a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+> Create a function for generating 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 createFactory = require( '@stdlib/random/tools/unary-factory' );
 
 #### createFactory( prng, idtypes odtypes, policies\[, options] )
 
-Returns a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+Returns a function for generating pseudorandom values drawn from a unary PRNG.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -63,9 +63,9 @@ var factory = createFactory( exponential, idt, odt, policies, options );
 
 The function has the following parameters:
 
--   **prng**: unary pseudorandom number generator. Must have the following methods:
+-   **prng**: unary pseudorandom value generator. Must have the following methods:
 
-    -   **factory**: method which returns a new unary pseudorandom number generator.
+    -   **factory**: method which returns a new unary pseudorandom value generator.
 
 -   **idtypes**: list of supported input data types.
 
@@ -79,11 +79,11 @@ The function has the following parameters:
 
 The function supports the following options:
 
--   **order**: default memory layout [order][@stdlib/ndarray/orders].
+-   **order**: default [memory layout][@stdlib/ndarray/orders].
 
 #### factory( \[options] )
 
-Returns a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+Returns a function for generating pseudorandom values drawn from a unary PRNG.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -108,13 +108,13 @@ var random = factory();
 The function supports the following options:
 
 -   **prng**: pseudorandom number generator for generating uniformly distributed pseudorandom numbers on the interval `[0,1)`. If provided, the function **ignores** both the `state` and `seed` options. In order to seed the underlying pseudorandom number generator, one must seed the provided `prng` (assuming the provided `prng` is seedable).
--   **seed**: pseudorandom number generator seed.
--   **state**: a [`Uint32Array`][@stdlib/array/uint32] containing pseudorandom number generator state. If provided, the function ignores the `seed` option.
--   **copy**: boolean indicating whether to copy a provided pseudorandom number generator state. Setting this option to `false` allows sharing state between two or more pseudorandom number generators. Setting this option to `true` ensures that an underlying generator has exclusive control over its internal state. Default: `true`.
+-   **seed**: pseudorandom value generator seed.
+-   **state**: a [`Uint32Array`][@stdlib/array/uint32] containing pseudorandom value generator state. If provided, the function ignores the `seed` option.
+-   **copy**: boolean indicating whether to copy a provided pseudorandom value generator state. Setting this option to `false` allows sharing state between two or more pseudorandom value generators. Setting this option to `true` ensures that an underlying generator has exclusive control over its internal state. Default: `true`.
 
 #### random( 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' );
@@ -142,7 +142,7 @@ var v = random( [ 2, 2 ], 2.0 );
 The function 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 function accepts the following options:
@@ -186,7 +186,7 @@ var dt = getDType( v );
 
 #### random.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' );
@@ -218,7 +218,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.
 
 #### random.PRNG
@@ -250,7 +250,7 @@ var prng = random.PRNG;
 
 #### random.seed
 
-The value used to seed the underlying pseudorandom number generator.
+The value used to seed the underlying pseudorandom value generator.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -305,7 +305,7 @@ var seed = random.seed;
 
 #### random.seedLength
 
-Length of the underlying pseudorandom number generator seed.
+Length of the underlying pseudorandom value generator seed.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -360,7 +360,7 @@ var len = random.seedLength;
 
 #### random.state
 
-Writable property for getting and setting the underlying pseudorandom number generator state.
+Writable property for getting and setting the underlying pseudorandom value generator state.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -415,7 +415,7 @@ var state = random.state;
 
 #### random.stateLength
 
-Length of the underlying pseudorandom number generator state.
+Length of the underlying pseudorandom value generator state.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );
@@ -470,7 +470,7 @@ var len = random.stateLength;
 
 #### random.byteLength
 
-Size (in bytes) of underlying pseudorandom number generator state.
+Size (in bytes) of underlying pseudorandom value generator state.
 
 ```javascript
 var dtypes = require( '@stdlib/ndarray/dtypes' );

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

@@ -1,14 +1,14 @@
 
 {{alias}}( prng, idtypes, odtypes, policies[, options] )
-    Returns a function for generating pseudorandom numbers drawn from single-
-    parameter probability distribution.
+    Returns a function for generating pseudorandom values drawn from a unary
+    PRNG.
 
     Parameters
     ----------
     prng: Function
-        Unary pseudorandom number generator. Must have the following methods:
+        Unary pseudorandom value generator. Must have the following methods:
 
-        - factory: returns a new unary pseudorandom number generator.
+        - factory: returns a new unary pseudorandom value generator.
 
     idtypes: Array<string>
         List of supported input data types.
@@ -30,9 +30,8 @@
     Returns
     -------
     fcn: Function
-        Factory function for generating pseudorandom numbers drawn from single-
-        parameter probability distribution. The function accepts a single
-        optional argument:
+        Factory function for generating pseudorandom values drawn from a unary
+        PRNG. The function accepts a single optional argument:
 
         - options: function options.
 

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

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Create a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+* Create a function for generating pseudorandom values drawn from a unary PRNG.
 *
 * @module @stdlib/random/tools/unary-factory
 *

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

@@ -42,10 +42,10 @@ var format = require( '@stdlib/string/format' );
 // MAIN //
 
 /**
-* Returns a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+* Returns a function for generating pseudorandom values drawn from a unary PRNG.
 *
-* @param {Function} prng - unary pseudorandom number generator
-* @param {Function} prng.factory - method which returns a new unary pseudorandom number generator
+* @param {Function} prng - unary pseudorandom value generator
+* @param {Function} prng.factory - method which returns a new 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
@@ -152,14 +152,14 @@ function createFactory( prng, idtypes, odtypes, policies, options ) {
 	return factory;
 
 	/**
-	* Returns a function for generating pseudorandom numbers drawn from a single-parameter probability distribution.
+	* Returns a function for generating pseudorandom values drawn from a unary PRNG.
 	*
 	* @private
 	* @param {Options} [options] - function options
 	* @param {PRNG} [options.prng] - pseudorandom number generator which generates uniformly distributed pseudorandom numbers
-	* @param {*} [options.seed] - pseudorandom number generator seed
-	* @param {*} [options.state] - pseudorandom number generator state
-	* @param {boolean} [options.copy] - boolean indicating whether to copy a provided pseudorandom number generator state
+	* @param {*} [options.seed] - pseudorandom value generator seed
+	* @param {*} [options.state] - pseudorandom value generator state
+	* @param {boolean} [options.copy] - boolean indicating whether to copy a provided pseudorandom value generator state
 	* @throws {TypeError} options argument must be an object
 	* @throws {TypeError} must provide valid options
 	* @throws {Error} must provide a valid state
@@ -196,20 +196,20 @@ function createFactory( prng, idtypes, odtypes, policies, options ) {
 		return rand;
 
 		/**
-		* Returns an ndarray filled with pseudorandom numbers drawn from a single-parameter probability distribution.
+		* Returns an ndarray filled with pseudorandom values drawn from a unary PRNG.
 		*
 		* @private
 		* @param {NonNegativeIntegerArray} shape - output ndarray shape
-		* @param {(number|ComplexLike|ndarrayLike)} param1 - distribution parameter
+		* @param {(ndarrayLike|*)} param1 - PRNG parameter
 		* @param {Options} [options] - function options
 		* @param {string} [options.dtype] - output 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 array
@@ -222,14 +222,14 @@ function createFactory( prng, idtypes, odtypes, policies, options ) {
 		}
 
 		/**
-		* Fills an ndarray with pseudorandom numbers drawn from a single-parameter probability distribution.
+		* Fills an ndarray with pseudorandom values drawn from a unary PRNG.
 		*
 		* @private
-		* @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
 		* @returns {ndarray} output ndarray
 		*/
 		function assign( param1, out ) {
@@ -277,7 +277,7 @@ function createFactory( prng, idtypes, odtypes, policies, options ) {
 		}
 
 		/**
-		* Returns the current pseudorandom number generator state.
+		* Returns the current pseudorandom value generator state.
 		*
 		* @private
 		* @returns {*} current state
@@ -287,7 +287,7 @@ function createFactory( prng, idtypes, odtypes, policies, options ) {
 		}
 
 		/**
-		* Sets the pseudorandom number generator state.
+		* Sets the pseudorandom value generator state.
 		*
 		* @private
 		* @param {*} s - generator state

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

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