docs: update README examples to use const and let

etc/eslint/.eslintrc.markdown.js

@@ -20,7 +20,7 @@
 
 // MODULES //
 
 // FIXME: remove the next line and uncomment the subsequent line once all remark JSDoc ESLint rules are completed
 var copy = require( './../../lib/node_modules/@stdlib/utils/copy' );
 
 // Var copy = require( './utils/copy.js' );
@@ -123,7 +123,7 @@
 *
 * @private
 */
 eslint.rules[ 'stdlib/jsdoc-return-annotations-values' ] = 'off'; // FIXME: remove this once we can reliably lint Markdown code blocks
 
 /**
 * Allow use of undeclared variables, as variables may be defined in previous code blocks or be implied.
@@ -146,6 +146,13 @@
 */
 eslint.rules[ 'node/no-unpublished-require' ] = 'off';
 
+/**
+* Allow modern ECMAScript syntax.
+*
+* @private
+*/
+eslint.rules[ 'node/no-unsupported-features/es-syntax' ] = 'off';
+
 
 // EXPORTS //
 

etc/eslint/overrides/index.js

@@ -158,7 +158,8 @@ var overrides = [
 			'stdlib/return-annotations-values': 'off',
 			'strict': 'off',
 			'vars-on-top': 'off',
-			'node/no-unpublished-require': 'off'
+			'node/no-unpublished-require': 'off',
+			'node/no-unsupported-features/es-syntax': 'off'
 		}
 	},
 	{

etc/eslint/rules/spellcheck.js

@@ -83,15 +83,21 @@ rules[ '@cspell/spellchecker' ] = [ 'warn', {
 			'exponentiated',
 			'evalpoly',
 			'evalrational',
+			'gmean',
+			'hmean',
 			'hommel',
 			'iget',
+			'indegree',
+			'indegrees',
 			'iset',
+			'isnan',
 			'logcdf',
 			'logit',
 			'logpdf',
 			'logpmf',
 			'lpad',
 			'ltrim',
+			'memberof',
 			'napi',
 			'nargs',
 			'ncols',
@@ -102,12 +108,14 @@ rules[ '@cspell/spellchecker' ] = [ 'warn', {
 			'ndarrays',
 			'nrows',
 			'nsubmodes',
+			'numel',
 			'pvalues',
 			'randn',
 			'randu',
 			'rpad',
 			'rtrim',
 			'significand',
+			'significands',
 			'stdev',
 			'strided',
 			'stringifying',

lib/node_modules/@stdlib/_tools/benchmarks/browser-build/README.md

@@ -37,7 +37,7 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var build = require( '@stdlib/_tools/benchmarks/browser-build' );
+const build = require( '@stdlib/_tools/benchmarks/browser-build' );
 ```
 
 #### build( root, output, \[options,] clbk )
@@ -47,10 +47,10 @@ Given a `root` directory from which to search for benchmarks and an output direc
 <!-- eslint-disable stdlib/no-redeclare -->
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
-var root = cwd();
-var out = root;
+const root = cwd();
+const out = root;
 
 build( root, out, clbk );
 
@@ -79,12 +79,12 @@ To provide an alternative glob pattern, set the `pattern` option.
 <!-- eslint-disable stdlib/no-redeclare -->
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
-var root = cwd();
-var out = root;
+const root = cwd();
+const out = root;
 
-var opts = {
+const opts = {
     'pattern': '**/bench.js'
 };
 
@@ -107,12 +107,12 @@ To mount a bundle on a URL path, set the `mount`option.
 <!-- eslint-disable stdlib/no-redeclare -->
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
-var root = cwd();
-var out = root;
+const root = cwd();
+const out = root;
 
-var opts = {
+const opts = {
     'mount': '/www/public/'
 };
 
@@ -153,17 +153,17 @@ function clbk( error, bool ) {
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var join = require( 'path' ).join;
-var resolve = require( 'path' ).resolve;
-var mkdirp = require( 'mkdirp' ).sync;
-var build = require( '@stdlib/_tools/benchmarks/browser-build' );
+const join = require( 'path' ).join;
+const resolve = require( 'path' ).resolve;
+const mkdirp = require( 'mkdirp' ).sync;
+const build = require( '@stdlib/_tools/benchmarks/browser-build' );
 
-var root = join( __dirname, 'fixtures' );
-var out = resolve( __dirname, '../build' );
+const root = join( __dirname, 'fixtures' );
+const out = resolve( __dirname, '../build' );
 
 mkdirp( out );
 
-var opts = {
+const opts = {
     'pattern': 'index.js',
     'bundle': 'benchmark_bundle.js',
     'html': 'benchmarks.html'

lib/node_modules/@stdlib/_tools/benchmarks/bundle/README.md

@@ -37,15 +37,15 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var bundle = require( '@stdlib/_tools/benchmarks/bundle' );
+const bundle = require( '@stdlib/_tools/benchmarks/bundle' );
 ```
 
 #### bundle( root, \[options,] clbk )
 
 Given a `root` directory from which to search for benchmarks, bundle benchmarks into a single file using [browserify][browserify].
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
 bundle( cwd(), clbk );
 
@@ -65,9 +65,9 @@ The function accepts the following `options`:
 To specify an output file path, set the `out` option.
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
-var opts = {
+const opts = {
     'out': '/foo/bar/bundle.js'
 };
 
@@ -88,9 +88,9 @@ function clbk( error, bool ) {
 To provide an alternative glob pattern, set the `pattern` option.
 
 ```javascript
-var cwd = require( '@stdlib/process/cwd' );
+const cwd = require( '@stdlib/process/cwd' );
 
-var opts = {
+const opts = {
     'pattern': '**/bench.js'
 };
 
@@ -127,12 +127,12 @@ function clbk( error, bundle ) {
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var join = require( 'path' ).join;
-var bundle = require( '@stdlib/_tools/benchmarks/bundle' );
+const join = require( 'path' ).join;
+const bundle = require( '@stdlib/_tools/benchmarks/bundle' );
 
-var root = join( __dirname, 'fixtures' );
+const root = join( __dirname, 'fixtures' );
 
-var opts = {
+const opts = {
     'pattern': '*.js'
 };
 

lib/node_modules/@stdlib/_tools/benchmarks/html/README.md

@@ -37,15 +37,15 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var build = require( '@stdlib/_tools/benchmarks/html' );
+const build = require( '@stdlib/_tools/benchmarks/html' );
 ```
 
 #### build( bundle, \[options,] clbk )
 
 Given a `bundle` URL from which to load a benchmarks bundle, returns an HTML file for running benchmarks.
 
 ```javascript
-var bundle = '/foo/bar/bundle.js';
+const bundle = '/foo/bar/bundle.js';
 
 build( bundle, clbk );
 
@@ -65,9 +65,9 @@ The function accepts the following `options`:
 To specify an output file path, set the `out` option.
 
 ```javascript
-var bundle = '/foo/bar/bundle.js';
+const bundle = '/foo/bar/bundle.js';
 
-var opts = {
+const opts = {
     'out': '/foo/bar/benchmarks.html'
 };
 
@@ -101,7 +101,7 @@ function clbk( error ) {
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var build = require( '@stdlib/_tools/benchmarks/html' );
+const build = require( '@stdlib/_tools/benchmarks/html' );
 
 build( '/foo/bar/bundle.js', onBuild );
 

lib/node_modules/@stdlib/_tools/bib/citation-reference/README.md

@@ -33,7 +33,7 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var toReference = require( '@stdlib/_tools/bib/citation-reference' );
+const toReference = require( '@stdlib/_tools/bib/citation-reference' );
 ```
 
 <a name="to-reference"></a>
@@ -65,7 +65,7 @@ To use a specific bibliographic database, set the `database` option.
 <!-- run-disable -->
 
 ```javascript
-var opts = {
+const opts = {
     'database': '/foo/bar/baz/bib.bib'
 };
 
@@ -84,7 +84,7 @@ To use a particular [Citation Style Language][csl] (CSL), set the `csl` option.
 <!-- run-disable -->
 
 ```javascript
-var opts = {
+const opts = {
     'csl': '/foo/bar/baz/style.csl'
 };
 
@@ -105,7 +105,7 @@ Synchronously returns a reference corresponding to a citation identifier.
 <!-- run-disable -->
 
 ```javascript
-var ref = toReference.sync( '@press:1992' );
+const ref = toReference.sync( '@press:1992' );
 // returns '...'
 ```
 
@@ -139,7 +139,7 @@ The method accepts the same `options` as [`toReference()`](#to-reference) above.
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var toReference = require( '@stdlib/_tools/bib/citation-reference' );
+const toReference = require( '@stdlib/_tools/bib/citation-reference' );
 
 /* bib.bib
 @book{press:1992,
@@ -152,7 +152,7 @@ var toReference = require( '@stdlib/_tools/bib/citation-reference' );
 }
 */
 
-var opts = {
+const opts = {
     'database': 'bib.bib',
     'csl': 'chicago-author-date.csl'
 };

lib/node_modules/@stdlib/_tools/browserify/file-list/README.md

@@ -37,15 +37,15 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var bundle = require( '@stdlib/_tools/browserify/file-list' );
+const bundle = require( '@stdlib/_tools/browserify/file-list' );
 ```
 
 #### bundle( files, \[dest,] clbk )
 
 Bundles files into a single file using [browserify][browserify].
 
 ```javascript
-var files = [
+const files = [
     '/foo/bar.js',
     '/beep/boop.js'
 ];
@@ -63,7 +63,7 @@ function clbk( error, bundle ) {
 To specify an output file path, provide a `dest` argument.
 
 ```javascript
-var files = [
+const files = [
     '/foo/bar.js',
     '/beep/boop.js'
 ];
@@ -102,11 +102,11 @@ function clbk( error ) {
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var join = require( 'path' ).join;
-var bundle = require( '@stdlib/_tools/browserify/file-list' );
+const join = require( 'path' ).join;
+const bundle = require( '@stdlib/_tools/browserify/file-list' );
 
-var fpath = join( __dirname, 'examples', 'fixtures', 'index.js' );
-var files = [ fpath ];
+const fpath = join( __dirname, 'examples', 'fixtures', 'index.js' );
+const files = [ fpath ];
 
 bundle( files, onBundle );
 

lib/node_modules/@stdlib/_tools/browserify/string/README.md

@@ -37,15 +37,15 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var bundle = require( '@stdlib/_tools/browserify/string' );
+const bundle = require( '@stdlib/_tools/browserify/string' );
 ```
 
 #### bundle( str, \[dest,] \[options,] clbk )
 
 Generates a bundle from a `string` using [browserify][browserify].
 
 ```javascript
-var str = 'module.exports = require( "url" );';
+const str = 'module.exports = require( "url" );';
 
 bundle( str, clbk );
 
@@ -60,7 +60,7 @@ function clbk( error, bundle ) {
 To specify an output file path, provide a `dest` argument.
 
 ```javascript
-var str = 'module.exports = require( "url" );';
+const str = 'module.exports = require( "url" );';
 
 bundle( str, './bundle.js', clbk );
 
@@ -106,11 +106,11 @@ The function accepts any [browserify][browserify] `option`, as well as the follo
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var bundle = require( '@stdlib/_tools/browserify/string' );
+const bundle = require( '@stdlib/_tools/browserify/string' );
 
-var str = 'module.exports = require( "path" ).join;';
+const str = 'module.exports = require( "path" ).join;';
 
-var opts = {
+const opts = {
     'exportName': 'beep'
 };