Update docs and use utility to resolve root search directory

Author: kgryte

lib/node_modules/@stdlib/_tools/pkgs/names/README.md

@@ -47,7 +47,7 @@ function onList( error, names ) {
 
 The function accepts the following `options`:
 
--   **dir**: root directory from which to search for packages. May be either an absolute path or a path relative to the `stdlib/lib/node_modules/` directory. Default: `/path/to/stdlib/lib/node_modules/`.
+-   **dir**: directory from which to search for packages. May be either an absolute path or a path relative to the `stdlib/lib/node_modules/` directory. Default: `/path/to/stdlib/lib/node_modules/`.
 -   **pattern**: glob pattern used to find packages. Default: `'**/package.json'` (note: pattern **must** end with `package.json`).
 -   **ignore**: list of glob patterns used to exclude matches.
 
@@ -185,7 +185,7 @@ Options:
 
 ### Notes
 
--   If not provided a `dir` argument, the search directory is the current working directory.
+-   If not provided a `dir` argument, the search directory is the top-level `stdlib` package directory.
 
 -   To provide multiple exclusion glob patterns, set multiple `--ignore` option arguments.
 

lib/node_modules/@stdlib/_tools/pkgs/names/lib/async.js

@@ -35,7 +35,7 @@ var getRoot = require( './root.js' );
 * Asynchronously generates a list of stdlib package names.
 *
 * @param {Options} [options] - function options
-* @param {string} [options.dir] - root directory from which to search for packages
+* @param {string} [options.dir] - directory from which to search for packages
 * @param {string} [options.pattern='**\/package.json'] - glob pattern
 * @param {StringArray} [options.ignore] - glob pattern(s) to exclude matches
 * @param {Callback} clbk - callback to invoke after finding packages

lib/node_modules/@stdlib/_tools/pkgs/names/lib/root.js

@@ -21,11 +21,12 @@
 // MODULES //
 
 var resolve = require( 'path' ).resolve;
+var rootDir = require( '@stdlib/_tools/utils/root-dir' );
 
 
 // VARIABLES //
 
-var ROOT = resolve( __dirname, './../../../../../' );
+var ROOT = resolve( rootDir(), 'lib', 'node_modules' );
 
 
 // MAIN //

lib/node_modules/@stdlib/_tools/pkgs/names/lib/sync.js

@@ -34,7 +34,7 @@ var getRoot = require( './root.js' );
 * Synchronously generates a list of stdlib package names.
 *
 * @param {Options} [options] - function options
-* @param {string} [options.dir] - root directory from which to search for packages
+* @param {string} [options.dir] - directory from which to search for packages
 * @param {string} [options.pattern='**\/package.json'] - glob pattern
 * @param {StringArray} [options.ignore] - glob pattern(s) to exclude matches
 * @throws {TypeError} options argument must be an object