fix: avoid infinite recursion and update examples

---
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: na
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - 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: kgryte

lib/node_modules/@stdlib/utils/parallel/README.md

@@ -222,11 +222,6 @@ var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 var parallel = require( '@stdlib/utils/parallel' );
 
-var nFiles = 100;
-var files;
-var opts;
-var dir;
-
 function template( id ) {
     var file = '';
 
@@ -259,52 +254,54 @@ function createScripts( dir, nFiles ) {
     var files;
     var i;
 
-    files = new Array( nFiles );
+    files = [];
     for ( i = 0; i < nFiles; i++ ) {
         content = template( i.toString() );
         fpath = path.join( dir, i+'.js' );
         writeFileSync( fpath, content, {
             'encoding': 'utf8'
         });
-        files[ i ] = fpath;
+        files.push( fpath );
     }
     return files;
 }
 
-function cleanup() {
-    var i;
-
-    // Delete the temporary files...
-    for ( i = 0; i < files.length; i++ ) {
-        unlinkSync( files[ i ] );
-    }
-    // Remove temporary directory:
-    fs.rmdirSync( dir );
-}
-
-function done( error ) {
-    if ( error ) {
-        throw error;
-    }
-    cleanup();
-    console.log( 'Done!' );
-}
+var nFiles = 10;
 
-// Make a temporary directory to store files...
-dir = createDir();
+// Make a temporary directory to store files:
+var dir = createDir();
 
-// Create temporary files...
-files = createScripts( dir, nFiles );
+// Create temporary files:
+var files = createScripts( dir, nFiles );
 
 // Set the runner options:
-opts = {
+var opts = {
     'concurrency': 3,
     'workers': 3,
     'ordered': false
 };
 
 // Run all temporary scripts:
 parallel( files, opts, done );
+
+function done( error ) {
+    if ( error ) {
+        console.log( error.message );
+    }
+    cleanup();
+    console.log( 'Done!' );
+}
+
+function cleanup() {
+    var i;
+
+    // Delete the temporary files...
+    for ( i = 0; i < files.length; i++ ) {
+        unlinkSync( files[ i ] );
+    }
+    // Remove temporary directory:
+    fs.rmdirSync( dir );
+}
 ```
 
 </section>

lib/node_modules/@stdlib/utils/parallel/docs/repl.txt

@@ -53,16 +53,6 @@
     clbk: Function
         Callback to invoke after executing all scripts.
 
-    Examples
-    --------
-    > function done( error ) { if ( error ) { throw error; } };
-    > var files = [ './a.js', './b.js' ];
-    > {{alias}}( files, done );
-
-    // Specify the number of workers:
-    > var opts = { 'workers': 8 };
-    > {{alias}}( files, opts, done );
-
     See Also
     --------
 

lib/node_modules/@stdlib/utils/parallel/docs/types/index.d.ts

@@ -94,7 +94,7 @@ type Callback = Nullary | Unary;
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *
@@ -127,7 +127,7 @@ declare function parallel( files: Array<string>, clbk: Callback ): void;
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *

lib/node_modules/@stdlib/utils/parallel/examples/index.js

@@ -26,11 +26,6 @@ var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 var parallel = require( './../lib' );
 
-var nFiles = 100;
-var files;
-var opts;
-var dir;
-
 /**
 * Returns a generated script.
 *
@@ -84,33 +79,35 @@ function createScripts( dir, nFiles ) {
 	var files;
 	var i;
 
-	files = new Array( nFiles );
+	files = [];
 	for ( i = 0; i < nFiles; i++ ) {
 		content = template( i.toString() );
 		fpath = path.join( dir, i+'.js' );
 		writeFileSync( fpath, content, {
 			'encoding': 'utf8'
 		});
-		files[ i ] = fpath;
+		files.push( fpath );
 	}
 	return files;
 }
 
-/**
-* Performs clean-up tasks once all scripts have run.
-*
-* @private
-*/
-function cleanup() {
-	var i;
+var nFiles = 10;
 
-	// Delete the temporary files...
-	for ( i = 0; i < files.length; i++ ) {
-		unlinkSync( files[ i ] );
-	}
-	// Remove temporary directory:
-	fs.rmdirSync( dir );
-}
+// Make a temporary directory to store files:
+var dir = createDir();
+
+// Create temporary files:
+var files = createScripts( dir, nFiles );
+
+// Set the runner options:
+var opts = {
+	'concurrency': 3,
+	'workers': 3,
+	'ordered': false
+};
+
+// Run all temporary scripts:
+parallel( files, opts, done );
 
 /**
 * Callback invoked once all scripts finish.
@@ -120,24 +117,24 @@ function cleanup() {
 */
 function done( error ) {
 	if ( error ) {
-		throw error;
+		console.log( error.message );
 	}
 	cleanup();
 	console.log( 'Done!' );
 }
 
-// Make a temporary directory to store files...
-dir = createDir();
-
-// Create temporary files...
-files = createScripts( dir, nFiles );
-
-// Set the runner options:
-opts = {
-	'concurrency': 3,
-	'workers': 3,
-	'ordered': false
-};
+/**
+* Performs clean-up tasks once all scripts have run.
+*
+* @private
+*/
+function cleanup() {
+	var i;
 
-// Run all temporary scripts:
-parallel( files, opts, done );
+	// Delete the temporary files...
+	for ( i = 0; i < files.length; i++ ) {
+		unlinkSync( files[ i ] );
+	}
+	// Remove temporary directory:
+	fs.rmdirSync( dir );
+}

lib/node_modules/@stdlib/utils/parallel/examples/serial.js

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-/* eslint-disable node/no-sync */
+/* eslint-disable node/no-sync, stdlib/no-dynamic-require, stdlib/no-unassigned-require, stdlib/require-last-path-relative */
 
 'use strict';
 
@@ -25,11 +25,6 @@ var path = require( 'path' );
 var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 
-var nFiles = 100;
-var files;
-var dir;
-var i;
-
 /**
 * Returns a generated script.
 *
@@ -83,18 +78,35 @@ function createScripts( dir, nFiles ) {
 	var files;
 	var i;
 
-	files = new Array( nFiles );
+	files = [];
 	for ( i = 0; i < nFiles; i++ ) {
 		content = template( i.toString() );
 		fpath = path.join( dir, i+'.js' );
 		writeFileSync( fpath, content, {
 			'encoding': 'utf8'
 		});
-		files[ i ] = fpath;
+		files.push( fpath );
 	}
 	return files;
 }
 
+var nFiles = 10;
+
+// Make a temporary directory to store files:
+var dir = createDir();
+
+// Create temporary files:
+var files = createScripts( dir, nFiles );
+
+// Run all scripts sequentially...
+var i;
+for ( i = 0; i < nFiles; i++ ) {
+	require( files[ i ] );
+}
+
+cleanup();
+console.log( 'Done!' );
+
 /**
 * Performs clean-up tasks once all scripts have run.
 *
@@ -110,17 +122,3 @@ function cleanup() {
 	// Remove temporary directory:
 	fs.rmdirSync( dir );
 }
-
-// Make a temporary directory to store files...
-dir = createDir();
-
-// Create temporary files...
-files = createScripts( dir, nFiles );
-
-// Run all scripts sequentially...
-for ( i = 0; i < nFiles; i++ ) {
-	require( files[ i ] ); // eslint-disable-line stdlib/no-dynamic-require, stdlib/no-unassigned-require
-}
-
-cleanup();
-console.log( 'Done!' );

lib/node_modules/@stdlib/utils/parallel/lib/index.js

@@ -28,9 +28,10 @@
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
+*
 * var files = [ './a.js', './b.js' ];
 * parallel( files, done );
 */

lib/node_modules/@stdlib/utils/parallel/lib/main.js

@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var path = require( 'path' );
+var resolve = require( 'path' ).resolve;
 var isStringArray = require( '@stdlib/assert/is-string-array' ).primitives;
 var isFunction = require( '@stdlib/assert/is-function' );
 var format = require( '@stdlib/string/format' );
@@ -60,7 +60,7 @@ var exec = require( './node' );
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *
@@ -105,7 +105,7 @@ function parallel() {
 	// Resolve any relative paths to absolute paths...
 	dir = cwd();
 	for ( i = 0; i < files.length; i++ ) {
-		files[ i ] = path.resolve( dir, files[ i ] );
+		files[ i ] = resolve( dir, files[ i ] );
 	}
 	exec( files, opts, done );