diff --git a/deps/npm/.travis.yml b/deps/npm/.travis.yml
index e971a85534c59a..d555682984faf5 100644
--- a/deps/npm/.travis.yml
+++ b/deps/npm/.travis.yml
@@ -8,7 +8,7 @@ env:
- DEPLOY_VERSION=testing
before_install:
- "npm config set spin false"
- - "npm install -g npm/npm"
+ - "npm install -g npm/npm#2.x"
- "sudo mkdir -p /var/run/couchdb"
script: "npm run-script test-all"
notifications:
diff --git a/deps/npm/AUTHORS b/deps/npm/AUTHORS
index 92dee7cfc1e21d..5e822a9f8d539b 100644
--- a/deps/npm/AUTHORS
+++ b/deps/npm/AUTHORS
@@ -288,3 +288,17 @@ Cedric Nelson If you have a complaint about a package in the public npm registry,
and cannot resolve it with the package
owner, please email
-support@npmjs.com and explain the situation.Legal Stuff
Any data published to The npm Registry (including user account information) may be removed or modified at the sole discretion of the npm server administrators.
@@ -183,5 +183,5 @@Add a package as a git submodule
+Ping npm registry
npm.commands.submodule(packages, callback)
+npm.registry.ping(registry, options, function (er, pong))
DESCRIPTION
-For each package specified, npm will check if it has a git repository url
-in its package.json description then add it as a git submodule at
-node_modules/<pkg name>
.
-This is a convenience only. From then on, it's up to you to manage
-updates by using the appropriate git commands. npm will stubbornly
-refuse to update, modify, or remove anything with a .git
subfolder
-in it.
-This command also does not install missing dependencies, if the package
-does not include them in its git repository. If npm ls
reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do npm explore <pkgname> -- npm install
to install the
-dependencies into the submodule folder.
-SEE ALSO
-
-- npm help json
-- git help submodule
-
+Attempts to connect to the given registry, returning a pong
+object with various metadata if it succeeds.
+This function is primarily useful for debugging connection issues
+to npm registries.
2.11.3
+2.13.4
This is the API documentation for npm. To find documentation of the command line @@ -109,5 +109,5 @@
<protocol>
is one of git
, git+ssh
, git+http
, or
git+https
. If no <commit-ish>
is specified, then master
is
used.
Examples:
- git+ssh://git@github.com:npm/npm.git#v1.0.27
- git+https://isaacs@github.com/npm/npm.git
- git://github.com/npm/npm.git#v1.0.27
+ The following git environment variables are recognized by npm and will be added
+ to the environment when running git:
+
+GIT_ASKPASS
+GIT_PROXY_COMMAND
+GIT_SSH
+GIT_SSH_COMMAND
+GIT_SSL_CAINFO
+GIT_SSL_NO_VERIFY
+See the git man page for details.
+Examples:
+npm install git+ssh://git@github.com:npm/npm.git#v1.0.27
+npm install git+https://isaacs@github.com/npm/npm.git
+npm install git://github.com/npm/npm.git#v1.0.27
+GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@github.com:npm/npm.git
+
+
npm install <githubname>/<githubrepo>[#<commit-ish>]
:
npm install github:<githubname>/<githubrepo>[#<commit-ish>]
:
@@ -264,5 +277,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-link.html b/deps/npm/html/doc/cli/npm-link.html
index fa2d33cc3a879a..398b0fe1d9ec8a 100644
--- a/deps/npm/html/doc/cli/npm-link.html
+++ b/deps/npm/html/doc/cli/npm-link.html
@@ -72,5 +72,5 @@ SYNOPSIS
-
+
diff --git a/deps/npm/html/doc/cli/npm-logout.html b/deps/npm/html/doc/cli/npm-logout.html
index add0967b268527..6262d13a76aaf0 100644
--- a/deps/npm/html/doc/cli/npm-logout.html
+++ b/deps/npm/html/doc/cli/npm-logout.html
@@ -55,5 +55,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-ls.html b/deps/npm/html/doc/cli/npm-ls.html
index 90a2aa75033e20..4de901b68a6aba 100644
--- a/deps/npm/html/doc/cli/npm-ls.html
+++ b/deps/npm/html/doc/cli/npm-ls.html
@@ -22,7 +22,7 @@ SYNOPSIS
limit the results to only the paths to the packages named. Note that
nested packages will also show the paths to the specified packages.
For example, running npm ls promzard
in npm's source tree will show:
-npm@2.11.3 /path/to/npm
+npm@2.13.4 /path/to/npm
└─┬ init-package-json@0.0.4
└── promzard@0.1.5
It will print out extraneous, missing, and invalid packages.
@@ -97,5 +97,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-outdated.html b/deps/npm/html/doc/cli/npm-outdated.html
index e0ecfd26c2d746..130680af335a67 100644
--- a/deps/npm/html/doc/cli/npm-outdated.html
+++ b/deps/npm/html/doc/cli/npm-outdated.html
@@ -67,5 +67,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-owner.html b/deps/npm/html/doc/cli/npm-owner.html
index 9b83f7e6735eba..3829433275b955 100644
--- a/deps/npm/html/doc/cli/npm-owner.html
+++ b/deps/npm/html/doc/cli/npm-owner.html
@@ -49,5 +49,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-pack.html b/deps/npm/html/doc/cli/npm-pack.html
index ccebbe323da364..68d85d08d46f64 100644
--- a/deps/npm/html/doc/cli/npm-pack.html
+++ b/deps/npm/html/doc/cli/npm-pack.html
@@ -41,5 +41,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-submodule.html b/deps/npm/html/doc/cli/npm-ping.html
similarity index 69%
rename from deps/npm/html/doc/cli/npm-submodule.html
rename to deps/npm/html/doc/cli/npm-ping.html
index 30bde01b318f47..a441ebdbff9106 100644
--- a/deps/npm/html/doc/cli/npm-submodule.html
+++ b/deps/npm/html/doc/cli/npm-ping.html
@@ -1,34 +1,24 @@
- npm-submodule
+ npm-ping
-
+
-npm-submodule
Add a package as a git submodule
+npm-ping
Ping npm registry
SYNOPSIS
-npm submodule <pkg>
+npm ping [--registry <registry>]
DESCRIPTION
-If the specified package has a git repository url in its package.json
-description, then this command will add it as a git submodule at
-node_modules/<pkg name>
.
-This is a convenience only. From then on, it's up to you to manage
-updates by using the appropriate git commands. npm will stubbornly
-refuse to update, modify, or remove anything with a .git
subfolder
-in it.
-This command also does not install missing dependencies, if the package
-does not include them in its git repository. If npm ls
reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do npm explore <pkgname> -- npm install
to install the
-dependencies into the submodule folder.
+Ping the configured or given npm registry and verify authentication.
SEE ALSO
-- package.json(5)
-- git help submodule
+- npm-config(1)
+- npm-config(7)
+- npmrc(5)
@@ -42,4 +32,4 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-prefix.html b/deps/npm/html/doc/cli/npm-prefix.html
index f9af61318d4c46..7e10292cdf5e90 100644
--- a/deps/npm/html/doc/cli/npm-prefix.html
+++ b/deps/npm/html/doc/cli/npm-prefix.html
@@ -38,5 +38,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-prune.html b/deps/npm/html/doc/cli/npm-prune.html
index 58125c416497b8..96bae39a16568b 100644
--- a/deps/npm/html/doc/cli/npm-prune.html
+++ b/deps/npm/html/doc/cli/npm-prune.html
@@ -41,5 +41,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-publish.html b/deps/npm/html/doc/cli/npm-publish.html
index ba1bad9e26c8a4..a29b247dd676a9 100644
--- a/deps/npm/html/doc/cli/npm-publish.html
+++ b/deps/npm/html/doc/cli/npm-publish.html
@@ -66,5 +66,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-rebuild.html b/deps/npm/html/doc/cli/npm-rebuild.html
index 38bc945329aa9c..c6176df61bc6f0 100644
--- a/deps/npm/html/doc/cli/npm-rebuild.html
+++ b/deps/npm/html/doc/cli/npm-rebuild.html
@@ -38,5 +38,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-repo.html b/deps/npm/html/doc/cli/npm-repo.html
index 63b850a61edfd1..372bb717042fd6 100644
--- a/deps/npm/html/doc/cli/npm-repo.html
+++ b/deps/npm/html/doc/cli/npm-repo.html
@@ -42,5 +42,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-restart.html b/deps/npm/html/doc/cli/npm-restart.html
index faafb1d00e45c8..1ce1cbe6b4dd0f 100644
--- a/deps/npm/html/doc/cli/npm-restart.html
+++ b/deps/npm/html/doc/cli/npm-restart.html
@@ -53,5 +53,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-rm.html b/deps/npm/html/doc/cli/npm-rm.html
index 09ece656aa2f55..018aa4d3f220f4 100644
--- a/deps/npm/html/doc/cli/npm-rm.html
+++ b/deps/npm/html/doc/cli/npm-rm.html
@@ -39,5 +39,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-root.html b/deps/npm/html/doc/cli/npm-root.html
index c3092e686fd899..0ae95fb9b7e78d 100644
--- a/deps/npm/html/doc/cli/npm-root.html
+++ b/deps/npm/html/doc/cli/npm-root.html
@@ -35,5 +35,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-run-script.html b/deps/npm/html/doc/cli/npm-run-script.html
index 03f1aa201a2a69..1635c415b6de35 100644
--- a/deps/npm/html/doc/cli/npm-run-script.html
+++ b/deps/npm/html/doc/cli/npm-run-script.html
@@ -34,8 +34,9 @@ SYNOPSIS
node_modules/.bin
to the PATH
provided to scripts. Any binaries provided by
locally-installed dependencies can be used without the node_modules/.bin
prefix. For example, if there is a devDependency
on tap
in your package,
-you should write "scripts": {"test": "tap test/\*.js"}
instead of "scripts":
-{"test": "node_modules/.bin/tap test/\*.js"}
to run your tests.
+you should write:
+"scripts": {"test": "tap test/\*.js"}
+
instead of "scripts": {"test": "node_modules/.bin/tap test/\*.js"}
to run your tests.
SEE ALSO
- npm-scripts(7)
@@ -56,5 +57,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-search.html b/deps/npm/html/doc/cli/npm-search.html
index fc065f99915d96..8c7a2d5a777c12 100644
--- a/deps/npm/html/doc/cli/npm-search.html
+++ b/deps/npm/html/doc/cli/npm-search.html
@@ -49,5 +49,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-shrinkwrap.html b/deps/npm/html/doc/cli/npm-shrinkwrap.html
index b6f8ddc6d0489a..fe2e91b76aab1b 100644
--- a/deps/npm/html/doc/cli/npm-shrinkwrap.html
+++ b/deps/npm/html/doc/cli/npm-shrinkwrap.html
@@ -164,5 +164,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-star.html b/deps/npm/html/doc/cli/npm-star.html
index 273ba24060f395..39245e05cdb42e 100644
--- a/deps/npm/html/doc/cli/npm-star.html
+++ b/deps/npm/html/doc/cli/npm-star.html
@@ -36,5 +36,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-stars.html b/deps/npm/html/doc/cli/npm-stars.html
index 1899557adf5ab3..10207445fcc7c2 100644
--- a/deps/npm/html/doc/cli/npm-stars.html
+++ b/deps/npm/html/doc/cli/npm-stars.html
@@ -37,5 +37,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-start.html b/deps/npm/html/doc/cli/npm-start.html
index eb36bd5b29f623..68779a395a82f6 100644
--- a/deps/npm/html/doc/cli/npm-start.html
+++ b/deps/npm/html/doc/cli/npm-start.html
@@ -34,5 +34,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-stop.html b/deps/npm/html/doc/cli/npm-stop.html
index c772f894616830..122c0bce8c5048 100644
--- a/deps/npm/html/doc/cli/npm-stop.html
+++ b/deps/npm/html/doc/cli/npm-stop.html
@@ -34,5 +34,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-tag.html b/deps/npm/html/doc/cli/npm-tag.html
index 414e84a0dd165a..a2b3c68acd95da 100644
--- a/deps/npm/html/doc/cli/npm-tag.html
+++ b/deps/npm/html/doc/cli/npm-tag.html
@@ -62,5 +62,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-test.html b/deps/npm/html/doc/cli/npm-test.html
index 1adc889770378d..8b50bb79007c69 100644
--- a/deps/npm/html/doc/cli/npm-test.html
+++ b/deps/npm/html/doc/cli/npm-test.html
@@ -37,5 +37,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-uninstall.html b/deps/npm/html/doc/cli/npm-uninstall.html
index aae5ca9b4d8571..46724414455814 100644
--- a/deps/npm/html/doc/cli/npm-uninstall.html
+++ b/deps/npm/html/doc/cli/npm-uninstall.html
@@ -57,5 +57,5 @@ SYNOPSIS
-
+
diff --git a/deps/npm/html/doc/cli/npm-unpublish.html b/deps/npm/html/doc/cli/npm-unpublish.html
index 1f042fc55e3292..6cc3f2d3fdc994 100644
--- a/deps/npm/html/doc/cli/npm-unpublish.html
+++ b/deps/npm/html/doc/cli/npm-unpublish.html
@@ -47,5 +47,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-update.html b/deps/npm/html/doc/cli/npm-update.html
index ae6685d449547a..4989cf5d9e2918 100644
--- a/deps/npm/html/doc/cli/npm-update.html
+++ b/deps/npm/html/doc/cli/npm-update.html
@@ -119,5 +119,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/cli/npm-version.html b/deps/npm/html/doc/cli/npm-version.html
index 941df172003f9f..172eb65f6f4cc0 100644
--- a/deps/npm/html/doc/cli/npm-version.html
+++ b/deps/npm/html/doc/cli/npm-version.html
@@ -16,13 +16,14 @@ SYNOPSIS
Run this in a package directory to bump the version and write the new
data back to package.json
and, if present, npm-shrinkwrap.json
.
The newversion
argument should be a valid semver string, or a
-valid second argument to semver.inc (one of "patch", "minor", "major",
-"prepatch", "preminor", "premajor", "prerelease"). In the second case,
+valid second argument to semver.inc (one of patch
, minor
, major
,
+prepatch
, preminor
, premajor
, prerelease
). In the second case,
the existing version will be incremented by 1 in the specified field.
-If run in a git repo, it will also create a version commit and tag, and fail if
-the repo is not clean. This behavior is controlled by git-tag-version
(see
-below), and can be disabled on the command line by running npm
---no-git-tag-version version
+If run in a git repo, it will also create a version commit and tag.
+This behavior is controlled by git-tag-version
(see below), and can
+be disabled on the command line by running npm --no-git-tag-version version
.
+It will fail if the working directory is not clean, unless the --force
+flag is set.
If supplied with --message
(shorthand: -m
) config option, npm will
use it as a commit message when creating a version commit. If the
message
config contains %s
then that will be replaced with the
@@ -39,13 +40,34 @@
SYNOPSIS
2048-bit RSA key, ID 6C481CF6, created 2010-08-31
Enter passphrase:
-
If "preversion", "version", "postversion" in the "scripts" property of
-the package.json, it will execute by running npm version
. preversion
-and version ware executed before bump the package version, postversion
-was executed after bump the package version. For example to run npm version
-after passed all test:
-"scripts": { "preversion": "npm test" }
-
CONFIGURATION
+
If preversion
, version
, or postversion
are in the scripts
property of
+the package.json, they will be executed as part of running npm version
.
The exact order of execution is as follows:
+--force
flag is set.preversion
script. These scripts have access to the old version
in package.json.
+A typical use would be running your full test suite before deploying.
+Any files you want added to the commit should be explicitly added using git add
.version
in package.json
as requested (patch
, minor
, major
, etc). version
script. These scripts have access to the new version
in package.json
+(so they can incorporate it into file headers in generated files for example).
+Again, scripts should explicitly add generated files to the commit using git add
.postversion
script. Use it to clean up the file system or automatically push
+the commit and/or tag.Take the following example:
+"scripts": {
+ "preversion": "npm test",
+ "version": "npm run build && git add -A dist",
+ "postversion": "git push && git push --tags && rm -rf build/temp"
+}
+
This runs all your tests, and proceeds only if they pass. Then runs your build
script, and
+adds everything in the dist
directory to the commit. After the commit, it pushes the new commit
+and tag up to the server, and deletes the build/temp
directory.
javascript package manager
npm <command> [args]
2.11.3
+2.13.4
npm is the package manager for the Node JavaScript platform. It puts modules in place so that node can find them, and manages dependency @@ -110,7 +110,7 @@
When you find issues, please report them:
@@ -118,7 +118,7 @@Be sure to include all of the output from the npm command that didn't work
as expected. The npm-debug.log
file is also helpful to provide.
Isaac Z. Schlueter :: isaacs :: @izs :: -i@izs.me
+i@izs.me{ "license" : "(ISC OR GPL-3.0)" }
If you are using a license that hasn't been assigned an SPDX identifier, or if you are using a custom license, use the following valid SPDX expression:
-{ "license" : "LicenseRef-LICENSE" }
-
Then include a LICENSE file at the top level of the package.
+{ "license" : "SEE LICENSE IN <filename>" }
+
Then include a file named <filename>
at the top level of the package.
Some old packages used license objects or a "licenses" property containing an array of license objects:
// Not valid metadata
@@ -117,7 +117,11 @@ license
{ "license": "ISC" }
{ "license": "(MIT OR Apache-2.0)" }
-
people fields: author, contributors
+
Finally, if you do not wish to grant others the right to use a private or +unpublished package under any terms:
+{ "license": "UNLICENSED"}
+
Consider also setting "private": true
to prevent accidental publication.
The "author" is one person. "contributors" is an array of people. A "person" is an object with a "name" field and optionally "url" and "email", like this:
{ "name" : "Barney Rubble"
@@ -136,6 +140,26 @@ files
which will keep files from being included, even if they would be picked
up by the files array. The ".npmignore" file works just like a
".gitignore".
+Certain files are always included, regardless of settings:
+
+package.json
+README
(and its variants)
+CHANGELOG
(and its variants)
+LICENSE
/ LICENCE
+
+Conversely, some files are always ignored:
+
+.git
+CVS
+.svn
+.hg
+.lock-wscript
+.wafpickle-N
+*.swp
+.DS_Store
+._*
+npm-debug.log
+
main
The main field is a module ID that is the primary entry point to your program.
That is, if your package is named foo
, and a user installs it, and then does
@@ -204,9 +228,12 @@
directories.lib
Tell people where the bulk of your library is. Nothing special is done
with the lib folder in any way, but it's useful meta info.
directories.bin
-If you specify a bin
directory, then all the files in that folder will
-be added as children of the bin
path.
-If you have a bin
path already, then this has no effect.
+If you specify a bin
directory in directories.bin
, all the files in
+that folder will be added.
+Because of the way the bin
directive works, specifying both a
+bin
path and setting directories.bin
is an error. If you want to
+specify individual files, use bin
, and for all the files in an
+existing bin
directory, use directories.bin
.
directories.man
A folder that is full of man pages. Sugar to generate a "man" array by
walking the folder.
@@ -487,12 +514,12 @@ private
publishConfig
dictionary described below to override the registry
config
param at publish-time.
publishConfig
-This is a set of config values that will be used at publish-time. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default.
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing.
+This is a set of config values that will be used at publish-time. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing.
See npm-config(7)
to see the list of config options that can be
overridden.
DEFAULT VALUES
@@ -538,5 +565,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/files/npmrc.html b/deps/npm/html/doc/files/npmrc.html
index 38f5c86e3e9cf3..28edc36c20f212 100644
--- a/deps/npm/html/doc/files/npmrc.html
+++ b/deps/npm/html/doc/files/npmrc.html
@@ -47,6 +47,8 @@ Per-project config file
running npm in. It has no effect when your module is published. For
example, you can't publish a module that forces itself to install
globally, or in a different location.
+Additionally, this file is not read in global mode, such as when running
+npm install -g
.
Per-user config file
$HOME/.npmrc
(or the userconfig
param, if set in the environment
or on the command line)
@@ -81,5 +83,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/files/package.json.html b/deps/npm/html/doc/files/package.json.html
index 66651bd4e5045f..cec160bd40a62b 100644
--- a/deps/npm/html/doc/files/package.json.html
+++ b/deps/npm/html/doc/files/package.json.html
@@ -91,8 +91,8 @@ license
{ "license" : "(ISC OR GPL-3.0)" }
If you are using a license that hasn't been assigned an SPDX identifier, or if
you are using a custom license, use the following valid SPDX expression:
-{ "license" : "LicenseRef-LICENSE" }
-
Then include a LICENSE file at the top level of the package.
+{ "license" : "SEE LICENSE IN <filename>" }
+
Then include a file named <filename>
at the top level of the package.
Some old packages used license objects or a "licenses" property containing an
array of license objects:
// Not valid metadata
@@ -117,7 +117,11 @@ license
{ "license": "ISC" }
{ "license": "(MIT OR Apache-2.0)" }
-
people fields: author, contributors
+
Finally, if you do not wish to grant others the right to use a private or
+unpublished package under any terms:
+{ "license": "UNLICENSED"}
+
Consider also setting "private": true
to prevent accidental publication.
+people fields: author, contributors
The "author" is one person. "contributors" is an array of people. A "person"
is an object with a "name" field and optionally "url" and "email", like this:
{ "name" : "Barney Rubble"
@@ -136,6 +140,26 @@ files
which will keep files from being included, even if they would be picked
up by the files array. The ".npmignore" file works just like a
".gitignore".
+Certain files are always included, regardless of settings:
+
+package.json
+README
(and its variants)
+CHANGELOG
(and its variants)
+LICENSE
/ LICENCE
+
+Conversely, some files are always ignored:
+
+.git
+CVS
+.svn
+.hg
+.lock-wscript
+.wafpickle-N
+*.swp
+.DS_Store
+._*
+npm-debug.log
+
main
The main field is a module ID that is the primary entry point to your program.
That is, if your package is named foo
, and a user installs it, and then does
@@ -204,9 +228,12 @@
directories.lib
Tell people where the bulk of your library is. Nothing special is done
with the lib folder in any way, but it's useful meta info.
directories.bin
-If you specify a bin
directory, then all the files in that folder will
-be added as children of the bin
path.
-If you have a bin
path already, then this has no effect.
+If you specify a bin
directory in directories.bin
, all the files in
+that folder will be added.
+Because of the way the bin
directive works, specifying both a
+bin
path and setting directories.bin
is an error. If you want to
+specify individual files, use bin
, and for all the files in an
+existing bin
directory, use directories.bin
.
directories.man
A folder that is full of man pages. Sugar to generate a "man" array by
walking the folder.
@@ -487,12 +514,12 @@ private
publishConfig
dictionary described below to override the registry
config
param at publish-time.
publishConfig
-This is a set of config values that will be used at publish-time. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default.
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing.
+This is a set of config values that will be used at publish-time. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing.
See npm-config(7)
to see the list of config options that can be
overridden.
DEFAULT VALUES
@@ -538,5 +565,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/index.html b/deps/npm/html/doc/index.html
index e45b852b5f911b..ea04d091f65ee0 100644
--- a/deps/npm/html/doc/index.html
+++ b/deps/npm/html/doc/index.html
@@ -66,6 +66,8 @@
Manage package owners
npm-pack(1)
Create a tarball from a package
+npm-ping(1)
+Ping npm registry
npm-prefix(1)
Display prefix
npm-prune(1)
@@ -152,6 +154,8 @@
Manage package owners
npm-pack(3)
Create a tarball from a package
+npm-ping(3)
+Ping npm registry
npm-prefix(3)
Display prefix
npm-prune(3)
@@ -236,5 +240,5 @@ semver(
-
+
diff --git a/deps/npm/html/doc/misc/npm-coding-style.html b/deps/npm/html/doc/misc/npm-coding-style.html
index c336977c58d29e..db41c5b982208f 100644
--- a/deps/npm/html/doc/misc/npm-coding-style.html
+++ b/deps/npm/html/doc/misc/npm-coding-style.html
@@ -147,5 +147,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-config.html b/deps/npm/html/doc/misc/npm-config.html
index baa0762f1bb49f..4ed4156cff452b 100644
--- a/deps/npm/html/doc/misc/npm-config.html
+++ b/deps/npm/html/doc/misc/npm-config.html
@@ -799,5 +799,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-developers.html b/deps/npm/html/doc/misc/npm-developers.html
index c3b26357b238b4..d2208291b8f65f 100644
--- a/deps/npm/html/doc/misc/npm-developers.html
+++ b/deps/npm/html/doc/misc/npm-developers.html
@@ -189,5 +189,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-disputes.html b/deps/npm/html/doc/misc/npm-disputes.html
index 797d3e6bce9409..33850cc3760f2a 100644
--- a/deps/npm/html/doc/misc/npm-disputes.html
+++ b/deps/npm/html/doc/misc/npm-disputes.html
@@ -13,7 +13,7 @@ npm-disputes
Handling Module
SYNOPSIS
- Get the author email with
npm owner ls <pkgname>
-- Email the author, CC support@npmjs.com
+- Email the author, CC support@npmjs.com
- After a few weeks, if there's no resolution, we'll sort it out.
Don't squat on package names. Publish code or move out of the way.
@@ -51,12 +51,12 @@ DESCRIPTION
owner (Bob).
Joe emails Bob, explaining the situation as respectfully as
possible, and what he would like to do with the module name. He
-adds the npm support staff support@npmjs.com to the CC list of
+adds the npm support staff support@npmjs.com to the CC list of
the email. Mention in the email that Bob can run npm owner add
joe foo
to add Joe as an owner of the foo
package.
After a reasonable amount of time, if Bob has not responded, or if
Bob and Joe can't come to any sort of resolution, email support
-support@npmjs.com and we'll sort it out. ("Reasonable" is
+support@npmjs.com and we'll sort it out. ("Reasonable" is
usually at least 4 weeks, but extra time is allowed around common
holidays.)
@@ -112,5 +112,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-faq.html b/deps/npm/html/doc/misc/npm-faq.html
index 01ef2c2d42f64a..a9cb75eb2d803c 100644
--- a/deps/npm/html/doc/misc/npm-faq.html
+++ b/deps/npm/html/doc/misc/npm-faq.html
@@ -213,6 +213,7 @@ How do I install node with npm?
Windows:
- http://github.com/marcelklehr/nodist
+- https://github.com/coreybutler/nvm-windows
- https://github.com/hakobera/nvmw
- https://github.com/nanjingboy/nvmw
@@ -236,7 +237,7 @@ I get ECONNREFUSED a lot. What'
To check if the registry is down, open up
https://registry.npmjs.org/ in a web browser. This will also tell
you if you are just unable to access the internet for some reason.
-If the registry IS down, let us know by emailing support@npmjs.com
+
If the registry IS down, let us know by emailing support@npmjs.com
or posting an issue at https://github.com/npm/npm/issues. If it's
down for the world (and not just on your local network) then we're
probably already being pinged about it.
@@ -307,5 +308,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-index.html b/deps/npm/html/doc/misc/npm-index.html
index 18d73b0abbb391..062f3e7d07a2ec 100644
--- a/deps/npm/html/doc/misc/npm-index.html
+++ b/deps/npm/html/doc/misc/npm-index.html
@@ -66,6 +66,8 @@ npm-pack(1)
Create a tarball from a package
+npm-ping(1)
+Ping npm registry
npm-prefix(1)
Display prefix
npm-prune(1)
@@ -152,6 +154,8 @@ npm-pack(3)
Create a tarball from a package
+npm-ping(3)
+Ping npm registry
npm-prefix(3)
Display prefix
npm-prune(3)
@@ -236,5 +240,5 @@ s
-
+
diff --git a/deps/npm/html/doc/misc/npm-registry.html b/deps/npm/html/doc/misc/npm-registry.html
index 23c36db63c6770..51118b905cdf1b 100644
--- a/deps/npm/html/doc/misc/npm-registry.html
+++ b/deps/npm/html/doc/misc/npm-registry.html
@@ -70,5 +70,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-scope.html b/deps/npm/html/doc/misc/npm-scope.html
index 027e64ed948d1f..59155bbe5fbc42 100644
--- a/deps/npm/html/doc/misc/npm-scope.html
+++ b/deps/npm/html/doc/misc/npm-scope.html
@@ -91,5 +91,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/npm-scripts.html b/deps/npm/html/doc/misc/npm-scripts.html
index 982c219fea69a3..34202641acc6e2 100644
--- a/deps/npm/html/doc/misc/npm-scripts.html
+++ b/deps/npm/html/doc/misc/npm-scripts.html
@@ -207,5 +207,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/removing-npm.html b/deps/npm/html/doc/misc/removing-npm.html
index 37253651bb5d81..c1f8b86008a081 100644
--- a/deps/npm/html/doc/misc/removing-npm.html
+++ b/deps/npm/html/doc/misc/removing-npm.html
@@ -57,5 +57,5 @@ SEE ALSO
-
+
diff --git a/deps/npm/html/doc/misc/semver.html b/deps/npm/html/doc/misc/semver.html
index bf227e4834a006..a2fd948d56f5bf 100644
--- a/deps/npm/html/doc/misc/semver.html
+++ b/deps/npm/html/doc/misc/semver.html
@@ -282,5 +282,5 @@ Ranges
-
+
diff --git a/deps/npm/html/partial/doc/README.html b/deps/npm/html/partial/doc/README.html
index 7db20d8965a693..98896e62869f1e 100644
--- a/deps/npm/html/partial/doc/README.html
+++ b/deps/npm/html/partial/doc/README.html
@@ -129,7 +129,7 @@ Legal Stuff
If you have a complaint about a package in the public npm registry,
and cannot resolve it with the package
owner, please email
-support@npmjs.com and explain the situation.
+support@npmjs.com and explain the situation.
Any data published to The npm Registry (including user account
information) may be removed or modified at the sole discretion of the
npm server administrators.
diff --git a/deps/npm/html/partial/doc/api/npm-ping.html b/deps/npm/html/partial/doc/api/npm-ping.html
new file mode 100644
index 00000000000000..ac8a29e185c66b
--- /dev/null
+++ b/deps/npm/html/partial/doc/api/npm-ping.html
@@ -0,0 +1,8 @@
+npm-ping
Ping npm registry
+SYNOPSIS
+npm.registry.ping(registry, options, function (er, pong))
+
DESCRIPTION
+Attempts to connect to the given registry, returning a pong
+object with various metadata if it succeeds.
+This function is primarily useful for debugging connection issues
+to npm registries.
diff --git a/deps/npm/html/partial/doc/api/npm-submodule.html b/deps/npm/html/partial/doc/api/npm-submodule.html
deleted file mode 100644
index cc7dd822ada426..00000000000000
--- a/deps/npm/html/partial/doc/api/npm-submodule.html
+++ /dev/null
@@ -1,21 +0,0 @@
-npm-submodule
Add a package as a git submodule
-SYNOPSIS
-npm.commands.submodule(packages, callback)
-
DESCRIPTION
-For each package specified, npm will check if it has a git repository url
-in its package.json description then add it as a git submodule at
-node_modules/<pkg name>
.
-This is a convenience only. From then on, it's up to you to manage
-updates by using the appropriate git commands. npm will stubbornly
-refuse to update, modify, or remove anything with a .git
subfolder
-in it.
-This command also does not install missing dependencies, if the package
-does not include them in its git repository. If npm ls
reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do npm explore <pkgname> -- npm install
to install the
-dependencies into the submodule folder.
-SEE ALSO
-
-- npm help json
-- git help submodule
-
diff --git a/deps/npm/html/partial/doc/api/npm.html b/deps/npm/html/partial/doc/api/npm.html
index 8e9de746a143cc..330af55335caa5 100644
--- a/deps/npm/html/partial/doc/api/npm.html
+++ b/deps/npm/html/partial/doc/api/npm.html
@@ -12,7 +12,7 @@ SYNOPSIS
npm.commands.install(["package"], cb)
})
VERSION
-2.11.3
+2.13.4
DESCRIPTION
This is the API documentation for npm.
To find documentation of the command line
diff --git a/deps/npm/html/partial/doc/cli/npm-install.html b/deps/npm/html/partial/doc/cli/npm-install.html
index 1f6aef82499e85..98dadcc9135b3f 100644
--- a/deps/npm/html/partial/doc/cli/npm-install.html
+++ b/deps/npm/html/partial/doc/cli/npm-install.html
@@ -127,11 +127,24 @@
SYNOPSIS
<protocol>
is one of git
, git+ssh
, git+http
, or
git+https
. If no <commit-ish>
is specified, then master
is
used.
Examples:
- git+ssh://git@github.com:npm/npm.git#v1.0.27
- git+https://isaacs@github.com/npm/npm.git
- git://github.com/npm/npm.git#v1.0.27
+ The following git environment variables are recognized by npm and will be added
+ to the environment when running git:
+
+GIT_ASKPASS
+GIT_PROXY_COMMAND
+GIT_SSH
+GIT_SSH_COMMAND
+GIT_SSL_CAINFO
+GIT_SSL_NO_VERIFY
+See the git man page for details.
+Examples:
+npm install git+ssh://git@github.com:npm/npm.git#v1.0.27
+npm install git+https://isaacs@github.com/npm/npm.git
+npm install git://github.com/npm/npm.git#v1.0.27
+GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@github.com:npm/npm.git
+
+
npm install <githubname>/<githubrepo>[#<commit-ish>]
:
npm install github:<githubname>/<githubrepo>[#<commit-ish>]
:
diff --git a/deps/npm/html/partial/doc/cli/npm-ls.html b/deps/npm/html/partial/doc/cli/npm-ls.html
index f240024f22fe2a..f97fb22243f5dd 100644
--- a/deps/npm/html/partial/doc/cli/npm-ls.html
+++ b/deps/npm/html/partial/doc/cli/npm-ls.html
@@ -11,7 +11,7 @@ SYNOPSIS
limit the results to only the paths to the packages named. Note that
nested packages will also show the paths to the specified packages.
For example, running npm ls promzard
in npm's source tree will show:
-npm@2.11.3 /path/to/npm
+npm@2.13.4 /path/to/npm
└─┬ init-package-json@0.0.4
└── promzard@0.1.5
It will print out extraneous, missing, and invalid packages.
diff --git a/deps/npm/html/partial/doc/cli/npm-ping.html b/deps/npm/html/partial/doc/cli/npm-ping.html
new file mode 100644
index 00000000000000..c71423d5eee4fc
--- /dev/null
+++ b/deps/npm/html/partial/doc/cli/npm-ping.html
@@ -0,0 +1,11 @@
+npm-ping
Ping npm registry
+SYNOPSIS
+npm ping [--registry <registry>]
+
DESCRIPTION
+Ping the configured or given npm registry and verify authentication.
+SEE ALSO
+
diff --git a/deps/npm/html/partial/doc/cli/npm-run-script.html b/deps/npm/html/partial/doc/cli/npm-run-script.html
index 4d3b6722f01dc1..e79376870e69ab 100644
--- a/deps/npm/html/partial/doc/cli/npm-run-script.html
+++ b/deps/npm/html/partial/doc/cli/npm-run-script.html
@@ -23,8 +23,9 @@ SYNOPSIS
node_modules/.bin
to the PATH
provided to scripts. Any binaries provided by
locally-installed dependencies can be used without the node_modules/.bin
prefix. For example, if there is a devDependency
on tap
in your package,
-you should write "scripts": {"test": "tap test/\*.js"}
instead of "scripts":
-{"test": "node_modules/.bin/tap test/\*.js"}
to run your tests.
+you should write:
+"scripts": {"test": "tap test/\*.js"}
+
instead of "scripts": {"test": "node_modules/.bin/tap test/\*.js"}
to run your tests.
SEE ALSO
- npm-scripts(7)
diff --git a/deps/npm/html/partial/doc/cli/npm-submodule.html b/deps/npm/html/partial/doc/cli/npm-submodule.html
deleted file mode 100644
index dd7c7e8878e734..00000000000000
--- a/deps/npm/html/partial/doc/cli/npm-submodule.html
+++ /dev/null
@@ -1,21 +0,0 @@
-npm-submodule
Add a package as a git submodule
-SYNOPSIS
-
npm submodule <pkg>
-
DESCRIPTION
-If the specified package has a git repository url in its package.json
-description, then this command will add it as a git submodule at
-node_modules/<pkg name>
.
-This is a convenience only. From then on, it's up to you to manage
-updates by using the appropriate git commands. npm will stubbornly
-refuse to update, modify, or remove anything with a .git
subfolder
-in it.
-This command also does not install missing dependencies, if the package
-does not include them in its git repository. If npm ls
reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do npm explore <pkgname> -- npm install
to install the
-dependencies into the submodule folder.
-SEE ALSO
-
-- package.json(5)
-- git help submodule
-
diff --git a/deps/npm/html/partial/doc/cli/npm-version.html b/deps/npm/html/partial/doc/cli/npm-version.html
index 515f19a6deaba1..1beda3d2884aad 100644
--- a/deps/npm/html/partial/doc/cli/npm-version.html
+++ b/deps/npm/html/partial/doc/cli/npm-version.html
@@ -5,13 +5,14 @@ SYNOPSIS
Run this in a package directory to bump the version and write the new
data back to package.json
and, if present, npm-shrinkwrap.json
.
The newversion
argument should be a valid semver string, or a
-valid second argument to semver.inc (one of "patch", "minor", "major",
-"prepatch", "preminor", "premajor", "prerelease"). In the second case,
+valid second argument to semver.inc (one of patch
, minor
, major
,
+prepatch
, preminor
, premajor
, prerelease
). In the second case,
the existing version will be incremented by 1 in the specified field.
-If run in a git repo, it will also create a version commit and tag, and fail if
-the repo is not clean. This behavior is controlled by git-tag-version
(see
-below), and can be disabled on the command line by running npm
---no-git-tag-version version
+If run in a git repo, it will also create a version commit and tag.
+This behavior is controlled by git-tag-version
(see below), and can
+be disabled on the command line by running npm --no-git-tag-version version
.
+It will fail if the working directory is not clean, unless the --force
+flag is set.
If supplied with --message
(shorthand: -m
) config option, npm will
use it as a commit message when creating a version commit. If the
message
config contains %s
then that will be replaced with the
@@ -28,13 +29,34 @@
SYNOPSIS
2048-bit RSA key, ID 6C481CF6, created 2010-08-31
Enter passphrase:
-
If "preversion", "version", "postversion" in the "scripts" property of
-the package.json, it will execute by running npm version
. preversion
-and version ware executed before bump the package version, postversion
-was executed after bump the package version. For example to run npm version
-after passed all test:
-"scripts": { "preversion": "npm test" }
-
CONFIGURATION
+
If preversion
, version
, or postversion
are in the scripts
property of
+the package.json, they will be executed as part of running npm version
.
The exact order of execution is as follows:
+--force
flag is set.preversion
script. These scripts have access to the old version
in package.json.
+A typical use would be running your full test suite before deploying.
+Any files you want added to the commit should be explicitly added using git add
.version
in package.json
as requested (patch
, minor
, major
, etc). version
script. These scripts have access to the new version
in package.json
+(so they can incorporate it into file headers in generated files for example).
+Again, scripts should explicitly add generated files to the commit using git add
.postversion
script. Use it to clean up the file system or automatically push
+the commit and/or tag.Take the following example:
+"scripts": {
+ "preversion": "npm test",
+ "version": "npm run build && git add -A dist",
+ "postversion": "git push && git push --tags && rm -rf build/temp"
+}
+
This runs all your tests, and proceeds only if they pass. Then runs your build
script, and
+adds everything in the dist
directory to the commit. After the commit, it pushes the new commit
+and tag up to the server, and deletes the build/temp
directory.
javascript package manager
npm <command> [args]
2.11.3
+2.13.4
npm is the package manager for the Node JavaScript platform. It puts modules in place so that node can find them, and manages dependency @@ -99,7 +99,7 @@
When you find issues, please report them:
@@ -107,7 +107,7 @@Be sure to include all of the output from the npm command that didn't work
as expected. The npm-debug.log
file is also helpful to provide.
Isaac Z. Schlueter :: isaacs :: @izs :: -i@izs.me
+i@izs.me{ "license" : "(ISC OR GPL-3.0)" }
If you are using a license that hasn't been assigned an SPDX identifier, or if you are using a custom license, use the following valid SPDX expression:
-{ "license" : "LicenseRef-LICENSE" }
-
Then include a LICENSE file at the top level of the package.
+{ "license" : "SEE LICENSE IN <filename>" }
+
Then include a file named <filename>
at the top level of the package.
Some old packages used license objects or a "licenses" property containing an array of license objects:
// Not valid metadata
@@ -106,7 +106,11 @@ license
{ "license": "ISC" }
{ "license": "(MIT OR Apache-2.0)" }
-
people fields: author, contributors
+
Finally, if you do not wish to grant others the right to use a private or +unpublished package under any terms:
+{ "license": "UNLICENSED"}
+
Consider also setting "private": true
to prevent accidental publication.
The "author" is one person. "contributors" is an array of people. A "person" is an object with a "name" field and optionally "url" and "email", like this:
{ "name" : "Barney Rubble"
@@ -125,6 +129,26 @@ files
which will keep files from being included, even if they would be picked
up by the files array. The ".npmignore" file works just like a
".gitignore".
+Certain files are always included, regardless of settings:
+
+package.json
+README
(and its variants)
+CHANGELOG
(and its variants)
+LICENSE
/ LICENCE
+
+Conversely, some files are always ignored:
+
+.git
+CVS
+.svn
+.hg
+.lock-wscript
+.wafpickle-N
+*.swp
+.DS_Store
+._*
+npm-debug.log
+
main
The main field is a module ID that is the primary entry point to your program.
That is, if your package is named foo
, and a user installs it, and then does
@@ -193,9 +217,12 @@
directories.lib
Tell people where the bulk of your library is. Nothing special is done
with the lib folder in any way, but it's useful meta info.
directories.bin
-If you specify a bin
directory, then all the files in that folder will
-be added as children of the bin
path.
-If you have a bin
path already, then this has no effect.
+If you specify a bin
directory in directories.bin
, all the files in
+that folder will be added.
+Because of the way the bin
directive works, specifying both a
+bin
path and setting directories.bin
is an error. If you want to
+specify individual files, use bin
, and for all the files in an
+existing bin
directory, use directories.bin
.
directories.man
A folder that is full of man pages. Sugar to generate a "man" array by
walking the folder.
@@ -476,12 +503,12 @@ private
publishConfig
dictionary described below to override the registry
config
param at publish-time.
publishConfig
-This is a set of config values that will be used at publish-time. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default.
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing.
+This is a set of config values that will be used at publish-time. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing.
See npm-config(7)
to see the list of config options that can be
overridden.
DEFAULT VALUES
diff --git a/deps/npm/html/partial/doc/files/npmrc.html b/deps/npm/html/partial/doc/files/npmrc.html
index f4106bebf0fd32..ed1eb0295fa5e3 100644
--- a/deps/npm/html/partial/doc/files/npmrc.html
+++ b/deps/npm/html/partial/doc/files/npmrc.html
@@ -36,6 +36,8 @@ Per-project config file
running npm in. It has no effect when your module is published. For
example, you can't publish a module that forces itself to install
globally, or in a different location.
+Additionally, this file is not read in global mode, such as when running
+npm install -g
.
Per-user config file
$HOME/.npmrc
(or the userconfig
param, if set in the environment
or on the command line)
diff --git a/deps/npm/html/partial/doc/files/package.json.html b/deps/npm/html/partial/doc/files/package.json.html
index 752a10cbe5c94b..b2e54ba742ed95 100644
--- a/deps/npm/html/partial/doc/files/package.json.html
+++ b/deps/npm/html/partial/doc/files/package.json.html
@@ -80,8 +80,8 @@ license
{ "license" : "(ISC OR GPL-3.0)" }
If you are using a license that hasn't been assigned an SPDX identifier, or if
you are using a custom license, use the following valid SPDX expression:
-{ "license" : "LicenseRef-LICENSE" }
-
Then include a LICENSE file at the top level of the package.
+{ "license" : "SEE LICENSE IN <filename>" }
+
Then include a file named <filename>
at the top level of the package.
Some old packages used license objects or a "licenses" property containing an
array of license objects:
// Not valid metadata
@@ -106,7 +106,11 @@ license
{ "license": "ISC" }
{ "license": "(MIT OR Apache-2.0)" }
-
people fields: author, contributors
+
Finally, if you do not wish to grant others the right to use a private or
+unpublished package under any terms:
+{ "license": "UNLICENSED"}
+
Consider also setting "private": true
to prevent accidental publication.
+people fields: author, contributors
The "author" is one person. "contributors" is an array of people. A "person"
is an object with a "name" field and optionally "url" and "email", like this:
{ "name" : "Barney Rubble"
@@ -125,6 +129,26 @@ files
which will keep files from being included, even if they would be picked
up by the files array. The ".npmignore" file works just like a
".gitignore".
+Certain files are always included, regardless of settings:
+
+package.json
+README
(and its variants)
+CHANGELOG
(and its variants)
+LICENSE
/ LICENCE
+
+Conversely, some files are always ignored:
+
+.git
+CVS
+.svn
+.hg
+.lock-wscript
+.wafpickle-N
+*.swp
+.DS_Store
+._*
+npm-debug.log
+
main
The main field is a module ID that is the primary entry point to your program.
That is, if your package is named foo
, and a user installs it, and then does
@@ -193,9 +217,12 @@
directories.lib
Tell people where the bulk of your library is. Nothing special is done
with the lib folder in any way, but it's useful meta info.
directories.bin
-If you specify a bin
directory, then all the files in that folder will
-be added as children of the bin
path.
-If you have a bin
path already, then this has no effect.
+If you specify a bin
directory in directories.bin
, all the files in
+that folder will be added.
+Because of the way the bin
directive works, specifying both a
+bin
path and setting directories.bin
is an error. If you want to
+specify individual files, use bin
, and for all the files in an
+existing bin
directory, use directories.bin
.
directories.man
A folder that is full of man pages. Sugar to generate a "man" array by
walking the folder.
@@ -476,12 +503,12 @@ private
publishConfig
dictionary described below to override the registry
config
param at publish-time.
publishConfig
-This is a set of config values that will be used at publish-time. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default.
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing.
+This is a set of config values that will be used at publish-time. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing.
See npm-config(7)
to see the list of config options that can be
overridden.
DEFAULT VALUES
diff --git a/deps/npm/html/partial/doc/index.html b/deps/npm/html/partial/doc/index.html
index 2048487ee27fd0..d074d9127bb6ee 100644
--- a/deps/npm/html/partial/doc/index.html
+++ b/deps/npm/html/partial/doc/index.html
@@ -55,6 +55,8 @@ npm-owner(1)
Manage package owners
npm-pack(1)
Create a tarball from a package
+npm-ping(1)
+Ping npm registry
npm-prefix(1)
Display prefix
npm-prune(1)
@@ -141,6 +143,8 @@ npm-owner(3)
Manage package owners
npm-pack(3)
Create a tarball from a package
+npm-ping(3)
+Ping npm registry
npm-prefix(3)
Display prefix
npm-prune(3)
diff --git a/deps/npm/html/partial/doc/misc/npm-disputes.html b/deps/npm/html/partial/doc/misc/npm-disputes.html
index ee9992f7702d10..ab49d1e3d18e71 100644
--- a/deps/npm/html/partial/doc/misc/npm-disputes.html
+++ b/deps/npm/html/partial/doc/misc/npm-disputes.html
@@ -2,7 +2,7 @@ npm-disputes
Handling Module
SYNOPSIS
- Get the author email with
npm owner ls <pkgname>
-- Email the author, CC support@npmjs.com
+- Email the author, CC support@npmjs.com
- After a few weeks, if there's no resolution, we'll sort it out.
Don't squat on package names. Publish code or move out of the way.
@@ -40,12 +40,12 @@ DESCRIPTION
owner (Bob).
Joe emails Bob, explaining the situation as respectfully as
possible, and what he would like to do with the module name. He
-adds the npm support staff support@npmjs.com to the CC list of
+adds the npm support staff support@npmjs.com to the CC list of
the email. Mention in the email that Bob can run npm owner add
joe foo
to add Joe as an owner of the foo
package.
After a reasonable amount of time, if Bob has not responded, or if
Bob and Joe can't come to any sort of resolution, email support
-support@npmjs.com and we'll sort it out. ("Reasonable" is
+support@npmjs.com and we'll sort it out. ("Reasonable" is
usually at least 4 weeks, but extra time is allowed around common
holidays.)
diff --git a/deps/npm/html/partial/doc/misc/npm-faq.html b/deps/npm/html/partial/doc/misc/npm-faq.html
index 448ef469483720..435d438388deb3 100644
--- a/deps/npm/html/partial/doc/misc/npm-faq.html
+++ b/deps/npm/html/partial/doc/misc/npm-faq.html
@@ -202,6 +202,7 @@ How do I install node with npm?
Windows:
- http://github.com/marcelklehr/nodist
+- https://github.com/coreybutler/nvm-windows
- https://github.com/hakobera/nvmw
- https://github.com/nanjingboy/nvmw
@@ -225,7 +226,7 @@ I get ECONNREFUSED a lot. What'
To check if the registry is down, open up
https://registry.npmjs.org/ in a web browser. This will also tell
you if you are just unable to access the internet for some reason.
-If the registry IS down, let us know by emailing support@npmjs.com
+
If the registry IS down, let us know by emailing support@npmjs.com
or posting an issue at https://github.com/npm/npm/issues. If it's
down for the world (and not just on your local network) then we're
probably already being pinged about it.
diff --git a/deps/npm/html/partial/doc/misc/npm-index.html b/deps/npm/html/partial/doc/misc/npm-index.html
index feeb5792cdb984..a75c025771f879 100644
--- a/deps/npm/html/partial/doc/misc/npm-index.html
+++ b/deps/npm/html/partial/doc/misc/npm-index.html
@@ -55,6 +55,8 @@ npm-owner(1)
Manage package owners
npm-pack(1)
Create a tarball from a package
+npm-ping(1)
+Ping npm registry
npm-prefix(1)
Display prefix
npm-prune(1)
@@ -141,6 +143,8 @@ npm-owner(3)
Manage package owners
npm-pack(3)
Create a tarball from a package
+npm-ping(3)
+Ping npm registry
npm-prefix(3)
Display prefix
npm-prune(3)
diff --git a/deps/npm/lib/cache.js b/deps/npm/lib/cache.js
index cae09b1813db9a..2e11be32f862fa 100644
--- a/deps/npm/lib/cache.js
+++ b/deps/npm/lib/cache.js
@@ -10,9 +10,9 @@
fetching a URL:
1. Check for URL in inflight URLs. If present, add cb, and return.
2. Acquire lock at {cache}/{sha(url)}.lock
- retries = {cache-lock-retries, def=3}
- stale = {cache-lock-stale, def=30000}
- wait = {cache-lock-wait, def=100}
+ retries = {cache-lock-retries, def=10}
+ stale = {cache-lock-stale, def=60000}
+ wait = {cache-lock-wait, def=10000}
3. if lock can't be acquired, then fail
4. fetch url, clear lock, call cbs
diff --git a/deps/npm/lib/cache/add-named.js b/deps/npm/lib/cache/add-named.js
index cd06aa28893dd8..64a4670b0cd321 100644
--- a/deps/npm/lib/cache/add-named.js
+++ b/deps/npm/lib/cache/add-named.js
@@ -250,7 +250,11 @@ function addNameRange (name, range, data, cb) {
var versions = Object.keys(data.versions || {})
var ms = semver.maxSatisfying(versions, range, true)
if (!ms) {
- return cb(installTargetsError(range, data))
+ if (range === "*" && versions.length) {
+ return addNameTag(name, "latest", data, cb)
+ } else {
+ return cb(installTargetsError(range, data))
+ }
}
// if we don't have a registry connection, try to see if
diff --git a/deps/npm/lib/cache/add-remote-git.js b/deps/npm/lib/cache/add-remote-git.js
index dc40cb3b64cba5..d3ecccdce9af81 100644
--- a/deps/npm/lib/cache/add-remote-git.js
+++ b/deps/npm/lib/cache/add-remote-git.js
@@ -15,7 +15,7 @@ var npa = require('npm-package-arg')
var realizePackageSpecifier = require('realize-package-specifier')
var addLocal = require('./add-local.js')
-var getCacheStat = require('./get-stat.js')
+var correctMkdir = require('../utils/correct-mkdir.js')
var git = require('../utils/git.js')
var npm = require('../npm.js')
var rm = require('../utils/gently-rm.js')
@@ -380,7 +380,7 @@ function checkoutTreeish (from, resolvedURL, resolvedTreeish, tmpdir, cb) {
}
function getGitDir (cb) {
- getCacheStat(function (er, stats) {
+ correctMkdir(remotes, function (er, stats) {
if (er) return cb(er)
// We don't need global templates when cloning. Use an empty directory for
@@ -391,11 +391,7 @@ function getGitDir (cb) {
// Ensure that both the template and remotes directories have the correct
// permissions.
fs.chown(templates, stats.uid, stats.gid, function (er) {
- if (er) return cb(er)
-
- fs.chown(remotes, stats.uid, stats.gid, function (er) {
- cb(er, stats)
- })
+ cb(er, stats)
})
})
})
@@ -429,25 +425,19 @@ function getResolved (uri, treeish) {
var parsed = url.parse(uri)
- // non-hosted SSH strings that are not URLs (git@whatever.com:foo.git) are
- // no bueno
- // https://github.com/npm/npm/issues/7961
- if (!parsed.protocol) return
-
- parsed.hash = treeish
- if (!/^git[+:]/.test(parsed.protocol)) {
- parsed.protocol = 'git+' + parsed.protocol
+ // Checks for known protocols:
+ // http:, https:, ssh:, and git:, with optional git+ prefix.
+ if (!parsed.protocol ||
+ !parsed.protocol.match(/^(((git\+)?(https?|ssh))|git|file):$/)) {
+ uri = 'git+ssh://' + uri
}
- // node incorrectly sticks a / at the start of the path We know that the host
- // won't change, so split and detect this
- // https://github.com/npm/npm/issues/3224
- var spo = uri.split(parsed.host)
- var spr = url.format(parsed).split(parsed.host)
- if (spo[1] && spo[1].charAt(0) === ':' && spr[1] && spr[1].charAt(0) === '/') {
- spr[1] = spr[1].slice(1)
+ if (!/^git[+:]/.test(uri)) {
+ uri = 'git+' + uri
}
- return spr.join(parsed.host)
+
+ // Not all URIs are actually URIs, so use regex for the treeish.
+ return uri.replace(/(?:#.*)?$/, '#' + treeish)
}
// similar to chmodr except it add permissions rather than overwriting them
diff --git a/deps/npm/lib/cache/get-stat.js b/deps/npm/lib/cache/get-stat.js
index 98f95ad6ae1b2b..6ea797a4da8ff6 100644
--- a/deps/npm/lib/cache/get-stat.js
+++ b/deps/npm/lib/cache/get-stat.js
@@ -1,74 +1,6 @@
-var mkdir = require("mkdirp")
- , fs = require("graceful-fs")
- , log = require("npmlog")
- , chownr = require("chownr")
- , npm = require("../npm.js")
- , inflight = require("inflight")
+var npm = require('../npm.js')
+var correctMkdir = require('../utils/correct-mkdir.js')
-// to maintain the cache dir's permissions consistently.
-var cacheStat = null
module.exports = function getCacheStat (cb) {
- if (cacheStat) return cb(null, cacheStat)
-
- fs.stat(npm.cache, function (er, st) {
- if (er) return makeCacheDir(cb)
- if (!st.isDirectory()) {
- log.error("getCacheStat", "invalid cache dir %j", npm.cache)
- return cb(er)
- }
- return cb(null, cacheStat = st)
- })
-}
-
-function makeCacheDir (cb) {
- cb = inflight("makeCacheDir", cb)
- if (!cb) {
- return log.verbose(
- "getCacheStat",
- "cache creation already in flight; waiting"
- )
- }
- log.verbose("getCacheStat", "cache creation not in flight; initializing")
-
- if (!process.getuid) return mkdir(npm.cache, function (er) {
- log.verbose("makeCacheDir", "UID & GID are irrelevant on", process.platform)
- cacheStat = { uid : 0, gid : 0 }
- return cb(er, cacheStat)
- })
-
- var uid = +process.getuid()
- , gid = +process.getgid()
-
- if (uid === 0) {
- if (process.env.SUDO_UID) uid = +process.env.SUDO_UID
- if (process.env.SUDO_GID) gid = +process.env.SUDO_GID
- }
-
- if (uid !== 0 || !process.env.HOME) {
- cacheStat = { uid : uid, gid : gid }
- return mkdir(npm.cache, afterMkdir)
- }
-
- fs.stat(process.env.HOME, function (er, st) {
- if (er) {
- log.error("makeCacheDir", "homeless?")
- return cb(er)
- }
- cacheStat = st
- log.silly("makeCacheDir", "cache dir uid, gid", [st.uid, st.gid])
- return mkdir(npm.cache, afterMkdir)
- })
-
- function afterMkdir (er, made) {
- if (er || !cacheStat || isNaN(cacheStat.uid) || isNaN(cacheStat.gid)) {
- return cb(er, cacheStat)
- }
-
- if (!made) return cb(er, cacheStat)
-
- // ensure that the ownership is correct.
- chownr(made, cacheStat.uid, cacheStat.gid, function (er) {
- return cb(er, cacheStat)
- })
- }
+ correctMkdir(npm.cache, cb)
}
diff --git a/deps/npm/lib/install.js b/deps/npm/lib/install.js
index 4ab248a492d5e3..9cc6a46fc0ca06 100644
--- a/deps/npm/lib/install.js
+++ b/deps/npm/lib/install.js
@@ -122,10 +122,11 @@ function install (args, cb_) {
if (er) return cb_(er)
if (problem) {
- var peerInvalidError = new Error("The package " + problem.name +
+ var peerInvalidError = new Error("The package " + problem._id +
" does not satisfy its siblings' peerDependencies requirements!")
peerInvalidError.code = "EPEERINVALID"
peerInvalidError.packageName = problem.name
+ peerInvalidError.packageVersion = problem.version
peerInvalidError.peersDepending = problem.peersDepending
return cb(peerInvalidError)
}
@@ -287,7 +288,7 @@ function findPeerInvalid_ (packageMap, fpiList) {
peer.peerDependencies[packageName]
}
}
- return { name: pkg.name, peersDepending: peersDepending }
+ return { name: pkg.name, peersDepending: peersDepending, version: pkg.version, _id: pkg._id }
}
if (pkg.dependencies) {
diff --git a/deps/npm/lib/npm.js b/deps/npm/lib/npm.js
index a2756ed7d29957..97cdad4de264bc 100644
--- a/deps/npm/lib/npm.js
+++ b/deps/npm/lib/npm.js
@@ -15,7 +15,8 @@ var EventEmitter = require("events").EventEmitter
, npm = module.exports = new EventEmitter()
, npmconf = require("./config/core.js")
, log = require("npmlog")
- , fs = require("graceful-fs")
+ , gfs = require('graceful-fs')
+ , fs = gfs.gracefulify(require('fs'))
, path = require("path")
, abbrev = require("abbrev")
, which = require("which")
@@ -133,6 +134,7 @@ var commandCache = {}
, "bin"
, "whoami"
, "dist-tag"
+ , "ping"
, "test"
, "stop"
diff --git a/deps/npm/lib/outdated.js b/deps/npm/lib/outdated.js
index fa27dfc8027ccc..ab49d109690ee6 100644
--- a/deps/npm/lib/outdated.js
+++ b/deps/npm/lib/outdated.js
@@ -344,7 +344,7 @@ function shouldUpdate (args, dir, dep, has, req, depth, cb, type) {
function updateDeps (er, d) {
if (er) {
- if (parsed.type !== 'local') return cb()
+ if (parsed.type !== 'local') return cb(er)
return updateLocalDeps()
}
diff --git a/deps/npm/lib/ping.js b/deps/npm/lib/ping.js
new file mode 100644
index 00000000000000..23b18bfba079a5
--- /dev/null
+++ b/deps/npm/lib/ping.js
@@ -0,0 +1,20 @@
+var npm = require('./npm.js')
+
+module.exports = ping
+
+ping.usage = 'npm ping\nping registry'
+
+function ping (args, silent, cb) {
+ if (typeof cb !== 'function') {
+ cb = silent
+ silent = false
+ }
+ var registry = npm.config.get('registry')
+ if (!registry) return cb(new Error('no default registry set'))
+ var auth = npm.config.getCredentialsByURI(registry)
+
+ npm.registry.ping(registry, {auth: auth}, function (er, pong) {
+ if (!silent) console.log(JSON.stringify(pong))
+ cb(er, er ? null : pong)
+ })
+}
diff --git a/deps/npm/lib/utils/correct-mkdir.js b/deps/npm/lib/utils/correct-mkdir.js
new file mode 100644
index 00000000000000..650c56fb17deb7
--- /dev/null
+++ b/deps/npm/lib/utils/correct-mkdir.js
@@ -0,0 +1,110 @@
+var chownr = require('chownr')
+var dezalgo = require('dezalgo')
+var fs = require('graceful-fs')
+var inflight = require('inflight')
+var log = require('npmlog')
+var mkdirp = require('mkdirp')
+
+// memoize the directories created by this step
+var stats = {}
+var effectiveOwner
+module.exports = function correctMkdir (path, cb) {
+ cb = dezalgo(cb)
+ if (stats[path]) return cb(null, stats[path])
+
+ fs.stat(path, function (er, st) {
+ if (er) return makeDirectory(path, cb)
+
+ if (!st.isDirectory()) {
+ log.error('correctMkdir', 'invalid dir %s', path)
+ return cb(er)
+ }
+
+ var ownerStats = calculateOwner()
+ // there's always a chance the permissions could have been frobbed, so fix
+ if (st.uid !== ownerStats.uid) {
+ stats[path] = ownerStats
+ setPermissions(path, ownerStats, cb)
+ } else {
+ stats[path] = st
+ cb(null, stats[path])
+ }
+ })
+}
+
+function calculateOwner () {
+ if (!effectiveOwner) {
+ effectiveOwner = { uid: 0, gid: 0 }
+
+ if (process.getuid) effectiveOwner.uid = +process.getuid()
+ if (process.getgid) effectiveOwner.gid = +process.getgid()
+
+ if (effectiveOwner.uid === 0) {
+ if (process.env.SUDO_UID) effectiveOwner.uid = +process.env.SUDO_UID
+ if (process.env.SUDO_GID) effectiveOwner.gid = +process.env.SUDO_GID
+ }
+ }
+
+ return effectiveOwner
+}
+
+function makeDirectory (path, cb) {
+ cb = inflight('makeDirectory:' + path, cb)
+ if (!cb) {
+ return log.verbose('makeDirectory', path, 'creation already in flight; waiting')
+ } else {
+ log.verbose('makeDirectory', path, 'creation not in flight; initializing')
+ }
+
+ var owner = calculateOwner()
+
+ if (!process.getuid) {
+ return mkdirp(path, function (er) {
+ log.verbose('makeCacheDir', 'UID & GID are irrelevant on', process.platform)
+
+ stats[path] = owner
+ return cb(er, stats[path])
+ })
+ }
+
+ if (owner.uid !== 0 || !process.env.HOME) {
+ log.silly(
+ 'makeDirectory', path,
+ 'uid:', owner.uid,
+ 'gid:', owner.gid
+ )
+ stats[path] = owner
+ mkdirp(path, afterMkdir)
+ } else {
+ fs.stat(process.env.HOME, function (er, st) {
+ if (er) {
+ log.error('makeDirectory', 'homeless?')
+ return cb(er)
+ }
+
+ log.silly(
+ 'makeDirectory', path,
+ 'uid:', st.uid,
+ 'gid:', st.gid
+ )
+ stats[path] = st
+ mkdirp(path, afterMkdir)
+ })
+ }
+
+ function afterMkdir (er, made) {
+ if (er || !stats[path] || isNaN(stats[path].uid) || isNaN(stats[path].gid)) {
+ return cb(er, stats[path])
+ }
+
+ if (!made) return cb(er, stats[path])
+
+ setPermissions(made, stats[path], cb)
+ }
+}
+
+function setPermissions (path, st, cb) {
+ chownr(path, st.uid, st.gid, function (er) {
+ return cb(er, st)
+ })
+}
diff --git a/deps/npm/lib/utils/lifecycle.js b/deps/npm/lib/utils/lifecycle.js
index 299fa56988c355..a6f2b98e88d2f3 100644
--- a/deps/npm/lib/utils/lifecycle.js
+++ b/deps/npm/lib/utils/lifecycle.js
@@ -39,8 +39,9 @@ function lifecycle (pkg, stage, wd, unsafe, failOk, cb) {
unsafe = unsafe || npm.config.get("unsafe-perm")
- if ((wd.indexOf(npm.dir) !== 0 || path.basename(wd) !== pkg.name)
- && !unsafe && pkg.scripts[stage]) {
+ if ((wd.indexOf(npm.dir) !== 0 ||
+ wd.indexOf(pkg.name) !== wd.length - pkg.name.length) &&
+ !unsafe && pkg.scripts[stage]) {
log.warn( "cannot run in wd", "%s %s (wd=%s)"
, pkg._id, pkg.scripts[stage], wd)
return cb()
diff --git a/deps/npm/lib/utils/locker.js b/deps/npm/lib/utils/locker.js
index 4479f241dab6c7..293d2da052b956 100644
--- a/deps/npm/lib/utils/locker.js
+++ b/deps/npm/lib/utils/locker.js
@@ -6,7 +6,7 @@ var log = require("npmlog")
var mkdirp = require("mkdirp")
var npm = require("../npm.js")
-var getStat = require("../cache/get-stat.js")
+var correctMkdir = require('../utils/correct-mkdir.js')
var installLocks = {}
@@ -20,25 +20,23 @@ function lockFileName (base, name) {
}
function lock (base, name, cb) {
- getStat(function (er) {
- var lockDir = resolve(npm.cache, "_locks")
- mkdirp(lockDir, function () {
- if (er) return cb(er)
+ var lockDir = resolve(npm.cache, "_locks")
+ correctMkdir(lockDir, function (er) {
+ if (er) return cb(er)
- var opts = { stale: npm.config.get("cache-lock-stale")
- , retries: npm.config.get("cache-lock-retries")
- , wait: npm.config.get("cache-lock-wait") }
- var lf = lockFileName(base, name)
- lockfile.lock(lf, opts, function (er) {
- if (er) log.warn("locking", lf, "failed", er)
+ var opts = { stale: npm.config.get("cache-lock-stale")
+ , retries: npm.config.get("cache-lock-retries")
+ , wait: npm.config.get("cache-lock-wait") }
+ var lf = lockFileName(base, name)
+ lockfile.lock(lf, opts, function (er) {
+ if (er) log.warn("locking", lf, "failed", er)
- if (!er) {
- log.verbose("lock", "using", lf, "for", resolve(base, name))
- installLocks[lf] = true
- }
+ if (!er) {
+ log.verbose("lock", "using", lf, "for", resolve(base, name))
+ installLocks[lf] = true
+ }
- cb(er)
- })
+ cb(er)
})
})
}
diff --git a/deps/npm/lib/version.js b/deps/npm/lib/version.js
index f763aad0ad8383..dbd48a0145a3d7 100644
--- a/deps/npm/lib/version.js
+++ b/deps/npm/lib/version.js
@@ -2,36 +2,38 @@
module.exports = version
-var semver = require("semver")
- , path = require("path")
- , fs = require("graceful-fs")
- , writeFileAtomic = require("write-file-atomic")
- , chain = require("slide").chain
- , log = require("npmlog")
- , npm = require("./npm.js")
- , git = require("./utils/git.js")
- , assert = require("assert")
- , lifecycle = require("./utils/lifecycle.js")
-
-version.usage = "npm version [ | major | minor | patch | prerelease | preminor | premajor ]\n"
- + "\n(run in package dir)\n"
- + "'npm -v' or 'npm --version' to print npm version "
- + "("+npm.version+")\n"
- + "'npm view version' to view a package's "
- + "published version\n"
- + "'npm ls' to inspect current package/dependency versions"
+var semver = require('semver')
+var path = require('path')
+var fs = require('graceful-fs')
+var writeFileAtomic = require('write-file-atomic')
+var chain = require('slide').chain
+var log = require('npmlog')
+var npm = require('./npm.js')
+var git = require('./utils/git.js')
+var assert = require('assert')
+var lifecycle = require('./utils/lifecycle.js')
+
+version.usage = 'npm version [ | major | minor | patch | premajor | preminor | prepatch | prerelease]' +
+ '\n(run in package dir)\n' +
+ "'npm -v' or 'npm --version' to print npm version " +
+ '(' + npm.version + ')\n' +
+ "'npm view version' to view a package's " +
+ 'published version\n' +
+ "'npm ls' to inspect current package/dependency versions"
function version (args, silent, cb_) {
- if (typeof cb_ !== "function") cb_ = silent, silent = false
+ if (typeof cb_ !== 'function') {
+ cb_ = silent
+ silent = false
+ }
if (args.length > 1) return cb_(version.usage)
- var packagePath = path.join(npm.localPrefix, "package.json")
+ var packagePath = path.join(npm.localPrefix, 'package.json')
fs.readFile(packagePath, function (er, data) {
if (data) data = data.toString()
try {
data = JSON.parse(data)
- }
- catch (e) {
+ } catch (e) {
er = e
data = null
}
@@ -39,65 +41,82 @@ function version (args, silent, cb_) {
if (!args.length) return dump(data, cb_)
if (er) {
- log.error("version", "No valid package.json found")
+ log.error('version', 'No valid package.json found')
return cb_(er)
}
var newVersion = semver.valid(args[0])
if (!newVersion) newVersion = semver.inc(data.version, args[0])
if (!newVersion) return cb_(version.usage)
- if (data.version === newVersion) return cb_(new Error("Version not changed"))
+ if (data.version === newVersion) return cb_(new Error('Version not changed'))
data.version = newVersion
var lifecycleData = Object.create(data)
- lifecycleData._id = data.name + "@" + newVersion
+ lifecycleData._id = data.name + '@' + newVersion
+ var localData = {}
var where = npm.prefix
chain([
- [lifecycle, lifecycleData, "preversion", where]
- , [version_, data, silent]
- , [lifecycle, lifecycleData, "version", where]
- , [lifecycle, lifecycleData, "postversion", where] ]
- , cb_)
+ [checkGit, localData],
+ [lifecycle, lifecycleData, 'preversion', where],
+ [updatePackage, newVersion, silent],
+ [lifecycle, lifecycleData, 'version', where],
+ [commit, localData, newVersion],
+ [lifecycle, lifecycleData, 'postversion', where] ],
+ cb_)
})
}
-function version_ (data, silent, cb_) {
+function readPackage (cb) {
+ var packagePath = path.join(npm.localPrefix, 'package.json')
+ fs.readFile(packagePath, function (er, data) {
+ if (er) return cb(new Error(er))
+ if (data) data = data.toString()
+ try {
+ data = JSON.parse(data)
+ } catch (e) {
+ er = e
+ data = null
+ }
+ cb(er, data)
+ })
+}
+
+function updatePackage (newVersion, silent, cb_) {
function cb (er) {
- if (!er && !silent) console.log("v" + data.version)
+ if (!er && !silent) console.log('v' + newVersion)
cb_(er)
}
- checkGit(function (er, hasGit) {
+ readPackage(function (er, data) {
if (er) return cb(new Error(er))
+ data.version = newVersion
+ write(data, 'package.json', cb)
+ })
+}
- write(data, "package.json", function (er) {
- if (er) return cb(new Error(er))
-
- updateShrinkwrap(data.version, function (er, hasShrinkwrap) {
- if (er || !hasGit) return cb(er)
- commit(data.version, hasShrinkwrap, cb)
- })
- })
+function commit (localData, newVersion, cb) {
+ updateShrinkwrap(newVersion, function (er, hasShrinkwrap) {
+ if (er || !localData.hasGit) return cb(er)
+ _commit(newVersion, hasShrinkwrap, cb)
})
}
function updateShrinkwrap (newVersion, cb) {
- fs.readFile(path.join(npm.localPrefix, "npm-shrinkwrap.json"), function (er, data) {
- if (er && er.code === "ENOENT") return cb(null, false)
+ fs.readFile(path.join(npm.localPrefix, 'npm-shrinkwrap.json'), function (er, data) {
+ if (er && er.code === 'ENOENT') return cb(null, false)
try {
data = data.toString()
data = JSON.parse(data)
- }
- catch (er) {
- log.error("version", "Bad npm-shrinkwrap.json data")
+ } catch (er) {
+ log.error('version', 'Bad npm-shrinkwrap.json data')
return cb(er)
}
data.version = newVersion
- write(data, "npm-shrinkwrap.json", function (er) {
+ write(data, 'npm-shrinkwrap.json', function (er) {
if (er) {
- log.error("version", "Bad npm-shrinkwrap.json data")
+ log.error('version', 'Bad npm-shrinkwrap.json data')
return cb(er)
}
cb(null, true)
@@ -114,74 +133,76 @@ function dump (data, cb) {
v[k] = process.versions[k]
})
- if (npm.config.get("json")) v = JSON.stringify(v, null, 2)
+ if (npm.config.get('json')) v = JSON.stringify(v, null, 2)
console.log(v)
cb()
}
-function checkGit (cb) {
- fs.stat(path.join(npm.localPrefix, ".git"), function (er, s) {
- var doGit = !er && s.isDirectory() && npm.config.get("git-tag-version")
+function checkGit (localData, cb) {
+ fs.stat(path.join(npm.localPrefix, '.git'), function (er, s) {
+ var doGit = !er && npm.config.get('git-tag-version')
if (!doGit) {
- if (er) log.verbose("version", "error checking for .git", er)
- log.verbose("version", "not tagging in git")
+ if (er) log.verbose('version', 'error checking for .git', er)
+ log.verbose('version', 'not tagging in git')
return cb(null, false)
}
// check for git
git.whichAndExec(
- [ "status", "--porcelain" ],
- { env : process.env },
+ [ 'status', '--porcelain' ],
+ { env: process.env },
function (er, stdout) {
- if (er && er.code === "ENOGIT") {
+ if (er && er.code === 'ENOGIT') {
log.warn(
- "version",
- "This is a Git checkout, but the git command was not found.",
- "npm could not create a Git tag for this release!"
+ 'version',
+ 'This is a Git checkout, but the git command was not found.',
+ 'npm could not create a Git tag for this release!'
)
return cb(null, false)
}
- var lines = stdout.trim().split("\n").filter(function (line) {
+ var lines = stdout.trim().split('\n').filter(function (line) {
return line.trim() && !line.match(/^\?\? /)
}).map(function (line) {
return line.trim()
})
- if (lines.length) return cb(new Error(
- "Git working directory not clean.\n"+lines.join("\n")
- ))
-
+ if (lines.length && !npm.config.get('force')) {
+ return cb(new Error(
+ 'Git working directory not clean.\n' + lines.join('\n')
+ ))
+ }
+ localData.hasGit = true
cb(null, true)
}
)
})
}
-function commit (version, hasShrinkwrap, cb) {
- var options = { env : process.env }
- var message = npm.config.get("message").replace(/%s/g, version)
- var sign = npm.config.get("sign-git-tag")
- var flag = sign ? "-sm" : "-am"
+function _commit (version, hasShrinkwrap, cb) {
+ var options = { env: process.env }
+ var message = npm.config.get('message').replace(/%s/g, version)
+ var sign = npm.config.get('sign-git-tag')
+ var flag = sign ? '-sm' : '-am'
chain(
[
- git.chainableExec([ "add", "package.json" ], options),
- hasShrinkwrap && git.chainableExec([ "add", "npm-shrinkwrap.json" ] , options),
- git.chainableExec([ "commit", "-m", message ], options),
- git.chainableExec([ "tag", npm.config.get("tag-version-prefix") + version, flag, message ], options)
+ git.chainableExec([ 'add', 'package.json' ], options),
+ hasShrinkwrap && git.chainableExec([ 'add', 'npm-shrinkwrap.json' ], options),
+ git.chainableExec([ 'commit', '-m', message ], options),
+ git.chainableExec([ 'tag', npm.config.get('tag-version-prefix') + version, flag, message ], options)
],
cb
)
}
function write (data, file, cb) {
- assert(data && typeof data === "object", "must pass data to version write")
- assert(typeof file === "string", "must pass filename to write to version write")
+ assert(data && typeof data === 'object', 'must pass data to version write')
+ assert(typeof file === 'string', 'must pass filename to write to version write')
- log.verbose("version.write", "data", data, "to", file)
+ log.verbose('version.write', 'data', data, 'to', file)
writeFileAtomic(
path.join(npm.localPrefix, file),
- new Buffer(JSON.stringify(data, null, 2) + "\n"),
+ new Buffer(JSON.stringify(data, null, 2) + '\n'),
cb
)
}
diff --git a/deps/npm/lib/view.js b/deps/npm/lib/view.js
index 47da39b642caca..9199d352ae7ff8 100644
--- a/deps/npm/lib/view.js
+++ b/deps/npm/lib/view.js
@@ -254,7 +254,13 @@ function printData (data, name, cb) {
})
})
- console.log(msg)
+ // preserve output symmetry by adding a whitespace-only line at the end if
+ // there's one at the beginning
+ if (/^\s*\n/.test(msg)) msg += "\n"
+
+ // print directly to stdout to not unnecessarily add blank lines
+ process.stdout.write(msg)
+
cb(null, data)
}
function cleanup (data) {
diff --git a/deps/npm/man/man1/npm-README.1 b/deps/npm/man/man1/npm-README.1
index 7a755a96b0bfe5..0f9a49903d7ea9 100644
--- a/deps/npm/man/man1/npm-README.1
+++ b/deps/npm/man/man1/npm-README.1
@@ -1,4 +1,4 @@
-.TH "NPM" "1" "June 2015" "" ""
+.TH "NPM" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm\fR \- a JavaScript package manager
.P
@@ -7,7 +7,7 @@ Build Status \fIhttps://img\.shields\.io/travis/npm/npm/master\.svg\fR \fIhttps:
.P
This is just enough info to get you up and running\.
.P
-Much more info available via \fBnpm help\fR once it's installed\.
+Much more info available via \fBnpm help\fP once it's installed\.
.SH IMPORTANT
.P
\fBYou need node v0\.8 or higher to run this program\.\fR
@@ -25,7 +25,7 @@ Get the MSI \fIhttp://nodejs\.org/download/\fR\|\. npm is in it\.
Get the pkg \fIhttp://nodejs\.org/download/\fR\|\. npm is in it\.
.SS Other Sorts of Unices
.P
-Run \fBmake install\fR\|\. npm will be installed with node\.
+Run \fBmake install\fP\|\. npm will be installed with node\.
.P
If you want a more fancy pants install (a different version, customized
paths, etc\.) then read on\.
@@ -60,17 +60,17 @@ npm_debug=1 sh install\.sh
.RE
.SS Even Fancier
.P
-Get the code with git\. Use \fBmake\fR to build the docs and do other stuff\.
-If you plan on hacking on npm, \fBmake link\fR is your friend\.
+Get the code with git\. Use \fBmake\fP to build the docs and do other stuff\.
+If you plan on hacking on npm, \fBmake link\fP is your friend\.
.P
If you've got the npm source code, you can also semi\-permanently set
-arbitrary config keys using the \fB\|\./configure \-\-key=val \.\.\.\fR, and then
-run npm commands by doing \fBnode cli\.js \fR\|\. (This is helpful
+arbitrary config keys using the \fB\|\./configure \-\-key=val \.\.\.\fP, and then
+run npm commands by doing \fBnode cli\.js \fP\|\. (This is helpful
for testing, or running stuff without actually installing npm itself\.)
.SH Windows Install or Upgrade
.P
You can download a zip file from https://github\.com/npm/npm/releases, and
-unpack it in the \fBnode_modules\\npm\\\fR folder inside node's installation folder\.
+unpack it in the \fBnode_modules\\npm\\\fP folder inside node's installation folder\.
.P
To upgrade to npm 2, follow the Windows upgrade instructions in
the npm Troubleshooting Guide:
@@ -105,11 +105,11 @@ Usually, the above instructions are sufficient\. That will remove
npm, but leave behind anything you've installed\.
.P
If you would like to remove all the packages that you have installed,
-then you can use the \fBnpm ls\fR command to find them, and then \fBnpm rm\fR to
+then you can use the \fBnpm ls\fP command to find them, and then \fBnpm rm\fP to
remove them\.
.P
To remove cruft left behind by npm 0\.x, you can use the included
-\fBclean\-old\.sh\fR script file\. You can run it conveniently like this:
+\fBclean\-old\.sh\fP script file\. You can run it conveniently like this:
.P
.RS 2
.nf
@@ -136,7 +136,7 @@ you have chosen\.
Although npm can be used programmatically, its API is meant for use by the CLI
\fIonly\fR, and no guarantees are made regarding its fitness for any other purpose\.
If you want to use npm to reliably perform some task, the safest thing to do is
-to invoke the desired \fBnpm\fR command with appropriate arguments\.
+to invoke the desired \fBnpm\fP command with appropriate arguments\.
.P
The semantic version of npm refers to the CLI itself, rather than the
underlying API\. \fIThe internal API is not guaranteed to remain stable even when
@@ -165,25 +165,25 @@ npm\.load(myConfigObject, function (er) {
.fi
.RE
.P
-The \fBload\fR function takes an object hash of the command\-line configs\.
-The various \fBnpm\.commands\.\fR functions take an \fBarray\fR of
+The \fBload\fP function takes an object hash of the command\-line configs\.
+The various \fBnpm\.commands\.\fP functions take an \fBarray\fR of
positional argument \fBstrings\fR\|\. The last argument to any
-\fBnpm\.commands\.\fR function is a callback\. Some commands take other
+\fBnpm\.commands\.\fP function is a callback\. Some commands take other
optional arguments\. Read the source\.
.P
You cannot set configs individually for any single npm function at this
-time\. Since \fBnpm\fR is a singleton, any call to \fBnpm\.config\.set\fR will
+time\. Since \fBnpm\fP is a singleton, any call to \fBnpm\.config\.set\fP will
change the value for \fIall\fR npm commands in that process\.
.P
-See \fB\|\./bin/npm\-cli\.js\fR for an example of pulling config values off of the
+See \fB\|\./bin/npm\-cli\.js\fP for an example of pulling config values off of the
command line arguments using nopt\. You may also want to check out \fBnpm
-help config\fR to learn about all the options you can set there\.
+help config\fP to learn about all the options you can set there\.
.SH More Docs
.P
Check out the docs \fIhttps://docs\.npmjs\.com/\fR,
especially the faq \fIhttps://docs\.npmjs\.com/misc/faq\fR\|\.
.P
-You can use the \fBnpm help\fR command to read any of them\.
+You can use the \fBnpm help\fP command to read any of them\.
.P
If you're a developer, and you want to use npm to publish your program,
you should read this \fIhttps://docs\.npmjs\.com/misc/developers\fR
@@ -237,7 +237,7 @@ https://github\.com/npm/npm/issues
.RE
.P
Be sure to include \fIall\fR of the output from the npm command that didn't work
-as expected\. The \fBnpm\-debug\.log\fR file is also helpful to provide\.
+as expected\. The \fBnpm\-debug\.log\fP file is also helpful to provide\.
.P
You can also look for isaacs in #node\.js on irc://irc\.freenode\.net\. He
will no doubt tell you to put the output in a gist or email\.
diff --git a/deps/npm/man/man1/npm-access.1 b/deps/npm/man/man1/npm-access.1
index 6e0caff8338344..c0e4f0352cb90e 100644
--- a/deps/npm/man/man1/npm-access.1
+++ b/deps/npm/man/man1/npm-access.1
@@ -1,4 +1,4 @@
-.TH "NPM\-ACCESS" "1" "June 2015" "" ""
+.TH "NPM\-ACCESS" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-access\fR \- Set access level on published packages
.SH SYNOPSIS
@@ -19,7 +19,7 @@ npm access edit []
.P
Used to set access controls on private packages\.
.P
-For all of the subcommands, \fBnpm access\fR will perform actions on the packages
+For all of the subcommands, \fBnpm access\fP will perform actions on the packages
in the current working directory if no package name is passed to the
subcommand\.
.RS 0
@@ -36,19 +36,19 @@ Show all of the access privileges for a package\. Will only show permissions
for packages to which you have at least read access\.
.IP \(bu 2
edit:
-Set the access privileges for a package at once using \fB$EDITOR\fR\|\.
+Set the access privileges for a package at once using \fB$EDITOR\fP\|\.
.RE
.SH DETAILS
.P
-\fBnpm access\fR always operates directly on the current registry, configurable
-from the command line using \fB\-\-registry=\fR\|\.
+\fBnpm access\fP always operates directly on the current registry, configurable
+from the command line using \fB\-\-registry=\fP\|\.
.P
Unscoped packages are \fIalways public\fR\|\.
.P
Scoped packages \fIdefault to restricted\fR, but you can either publish them as
-public using \fBnpm publish \-\-access=public\fR, or set their access as public using
-\fBnpm access public\fR after the initial publish\.
+public using \fBnpm publish \-\-access=public\fP, or set their access as public using
+\fBnpm access public\fP after the initial publish\.
.P
You must have privileges to set the access of a package:
.RS 0
@@ -64,7 +64,7 @@ of a team or directly as an owner\.
.P
If your account is not paid, then attempts to publish scoped packages will fail
with an HTTP 402 status code (logically enough), unless you use
-\fB\-\-access=public\fR\|\.
+\fB\-\-access=public\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-adduser.1 b/deps/npm/man/man1/npm-adduser.1
index 4c8015eff372a9..ca415540267cfd 100644
--- a/deps/npm/man/man1/npm-adduser.1
+++ b/deps/npm/man/man1/npm-adduser.1
@@ -1,4 +1,4 @@
-.TH "NPM\-ADDUSER" "1" "June 2015" "" ""
+.TH "NPM\-ADDUSER" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-adduser\fR \- Add a registry user account
.SH SYNOPSIS
@@ -10,9 +10,9 @@ npm adduser [\-\-registry=url] [\-\-scope=@orgname] [\-\-always\-auth]
.RE
.SH DESCRIPTION
.P
-Create or verify a user named \fB\fR in the specified registry, and
-save the credentials to the \fB\|\.npmrc\fR file\. If no registry is specified,
-the default registry will be used (see npm help 7 \fBnpm\-config\fR)\.
+Create or verify a user named \fB\fP in the specified registry, and
+save the credentials to the \fB\|\.npmrc\fP file\. If no registry is specified,
+the default registry will be used (see npm help 7 \fBnpm\-config\fP)\.
.P
The username, password, and email are read in from prompts\.
.P
@@ -25,20 +25,20 @@ authorize on a new machine\. When authenticating on a new machine,
the username, password and email address must all match with
your existing record\.
.P
-\fBnpm login\fR is an alias to \fBadduser\fR and behaves exactly the same way\.
+\fBnpm login\fP is an alias to \fBadduser\fP and behaves exactly the same way\.
.SH CONFIGURATION
.SS registry
.P
Default: http://registry\.npmjs\.org/
.P
-The base URL of the npm package registry\. If \fBscope\fR is also specified,
-this registry will only be used for packages with that scope\. See npm help 7 \fBnpm\-scope\fR\|\.
+The base URL of the npm package registry\. If \fBscope\fP is also specified,
+this registry will only be used for packages with that scope\. See npm help 7 \fBnpm\-scope\fP\|\.
.SS scope
.P
Default: none
.P
If specified, the user and login credentials given will be associated
-with the specified scope\. See npm help 7 \fBnpm\-scope\fR\|\. You can use both at the same time,
+with the specified scope\. See npm help 7 \fBnpm\-scope\fP\|\. You can use both at the same time,
e\.g\.
.P
.RS 2
@@ -55,7 +55,7 @@ Default: false
.P
If specified, save configuration indicating that all requests to the given
registry should include authorization information\. Useful for private
-registries\. Can be used with \fB\-\-registry\fR and / or \fB\-\-scope\fR, e\.g\.
+registries\. Can be used with \fB\-\-registry\fP and / or \fB\-\-scope\fP, e\.g\.
.P
.RS 2
.nf
@@ -64,8 +64,8 @@ npm adduser \-\-registry=http://private\-registry\.example\.com \-\-always\-auth
.RE
.P
This will ensure that all requests to that registry (including for tarballs)
-include an authorization header\. See \fBalways\-auth\fR in npm help 7 \fBnpm\-config\fR for more
-details on always\-auth\. Registry\-specific configuration of \fBalways\-auth\fR takes
+include an authorization header\. See \fBalways\-auth\fP in npm help 7 \fBnpm\-config\fP for more
+details on always\-auth\. Registry\-specific configuration of \fBalways\-auth\fP takes
precedence over any global configuration\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-bin.1 b/deps/npm/man/man1/npm-bin.1
index 2ddb41bd109051..56ee962802ac40 100644
--- a/deps/npm/man/man1/npm-bin.1
+++ b/deps/npm/man/man1/npm-bin.1
@@ -1,4 +1,4 @@
-.TH "NPM\-BIN" "1" "June 2015" "" ""
+.TH "NPM\-BIN" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-bin\fR \- Display npm bin folder
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-bugs.1 b/deps/npm/man/man1/npm-bugs.1
index d1aa52202bf1af..c8ed16b78a6280 100644
--- a/deps/npm/man/man1/npm-bugs.1
+++ b/deps/npm/man/man1/npm-bugs.1
@@ -1,4 +1,4 @@
-.TH "NPM\-BUGS" "1" "June 2015" "" ""
+.TH "NPM\-BUGS" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-bugs\fR \- Bugs for a package in a web browser maybe
.SH SYNOPSIS
@@ -12,20 +12,20 @@ npm bugs (with no args in a package dir)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-bug tracker URL, and then tries to open it using the \fB\-\-browser\fR
+bug tracker URL, and then tries to open it using the \fB\-\-browser\fP
config param\. If no package name is provided, it will search for
-a \fBpackage\.json\fR in the current folder and use the \fBname\fR property\.
+a \fBpackage\.json\fP in the current folder and use the \fBname\fP property\.
.SH CONFIGURATION
.SS browser
.RS 0
.IP \(bu 2
-Default: OS X: \fB"open"\fR, Windows: \fB"start"\fR, Others: \fB"xdg\-open"\fR
+Default: OS X: \fB"open"\fP, Windows: \fB"start"\fP, Others: \fB"xdg\-open"\fP
.IP \(bu 2
Type: String
.RE
.P
-The browser that is called by the \fBnpm bugs\fR command to open websites\.
+The browser that is called by the \fBnpm bugs\fP command to open websites\.
.SS registry
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-build.1 b/deps/npm/man/man1/npm-build.1
index ed46425c57fd64..1d348eacf5780b 100644
--- a/deps/npm/man/man1/npm-build.1
+++ b/deps/npm/man/man1/npm-build.1
@@ -1,4 +1,4 @@
-.TH "NPM\-BUILD" "1" "June 2015" "" ""
+.TH "NPM\-BUILD" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-build\fR \- Build a package
.SH SYNOPSIS
@@ -10,13 +10,13 @@ npm build
.RE
.RS 0
.IP \(bu 2
-\fB\fR:
-A folder containing a \fBpackage\.json\fR file in its root\.
+\fB\fP:
+A folder containing a \fBpackage\.json\fP file in its root\.
.RE
.SH DESCRIPTION
.P
-This is the plumbing command called by \fBnpm link\fR and \fBnpm install\fR\|\.
+This is the plumbing command called by \fBnpm link\fP and \fBnpm install\fP\|\.
.P
It should generally be called during installation, but if you need to run it
directly, run:
diff --git a/deps/npm/man/man1/npm-bundle.1 b/deps/npm/man/man1/npm-bundle.1
index 68ae0ae9aa61fc..ccd6d821fd2a1c 100644
--- a/deps/npm/man/man1/npm-bundle.1
+++ b/deps/npm/man/man1/npm-bundle.1
@@ -1,13 +1,13 @@
-.TH "NPM\-BUNDLE" "1" "June 2015" "" ""
+.TH "NPM\-BUNDLE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-bundle\fR \- REMOVED
.SH DESCRIPTION
.P
-The \fBnpm bundle\fR command has been removed in 1\.0, for the simple reason
+The \fBnpm bundle\fP command has been removed in 1\.0, for the simple reason
that it is no longer necessary, as the default behavior is now to
install packages into the local space\.
.P
-Just use \fBnpm install\fR now to do what \fBnpm bundle\fR used to do\.
+Just use \fBnpm install\fP now to do what \fBnpm bundle\fP used to do\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-cache.1 b/deps/npm/man/man1/npm-cache.1
index effe1b30b62bd8..40e124e5ed526d 100644
--- a/deps/npm/man/man1/npm-cache.1
+++ b/deps/npm/man/man1/npm-cache.1
@@ -1,4 +1,4 @@
-.TH "NPM\-CACHE" "1" "June 2015" "" ""
+.TH "NPM\-CACHE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-cache\fR \- Manipulates packages cache
.SH SYNOPSIS
@@ -27,8 +27,8 @@ add data to the local installation cache explicitly\.
.IP \(bu 2
ls:
Show the data in the cache\. Argument is a path to show in the cache
-folder\. Works a bit like the \fBfind\fR program, but limited by the
-\fBdepth\fR config\.
+folder\. Works a bit like the \fBfind\fP program, but limited by the
+\fBdepth\fP config\.
.IP \(bu 2
clean:
Delete data out of the cache folder\. If an argument is provided, then
@@ -38,9 +38,9 @@ the entire cache is cleared\.
.RE
.SH DETAILS
.P
-npm stores cache data in the directory specified in \fBnpm config get cache\fR\|\.
+npm stores cache data in the directory specified in \fBnpm config get cache\fP\|\.
For each package that is added to the cache, three pieces of information are
-stored in \fB{cache}/{name}/{version}\fR:
+stored in \fB{cache}/{name}/{version}\fP:
.RS 0
.IP \(bu 2
\|\.\.\./package/package\.json:
@@ -51,18 +51,18 @@ The tarball for that version\.
.RE
.P
-Additionally, whenever a registry request is made, a \fB\|\.cache\.json\fR file
+Additionally, whenever a registry request is made, a \fB\|\.cache\.json\fP file
is placed at the corresponding URI, to store the ETag and the requested
-data\. This is stored in \fB{cache}/{hostname}/{path}/\.cache\.json\fR\|\.
+data\. This is stored in \fB{cache}/{hostname}/{path}/\.cache\.json\fP\|\.
.P
-Commands that make non\-essential registry requests (such as \fBsearch\fR and
-\fBview\fR, or the completion scripts) generally specify a minimum timeout\.
-If the \fB\|\.cache\.json\fR file is younger than the specified timeout, then
+Commands that make non\-essential registry requests (such as \fBsearch\fP and
+\fBview\fP, or the completion scripts) generally specify a minimum timeout\.
+If the \fB\|\.cache\.json\fP file is younger than the specified timeout, then
they do not make an HTTP request to the registry\.
.SH CONFIGURATION
.SS cache
.P
-Default: \fB~/\.npm\fR on Posix, or \fB%AppData%/npm\-cache\fR on Windows\.
+Default: \fB~/\.npm\fP on Posix, or \fB%AppData%/npm\-cache\fP on Windows\.
.P
The root cache folder\.
.SH SEE ALSO
diff --git a/deps/npm/man/man1/npm-completion.1 b/deps/npm/man/man1/npm-completion.1
index 5a5d24eafd919d..feb5e79d511aff 100644
--- a/deps/npm/man/man1/npm-completion.1
+++ b/deps/npm/man/man1/npm-completion.1
@@ -1,4 +1,4 @@
-.TH "NPM\-COMPLETION" "1" "June 2015" "" ""
+.TH "NPM\-COMPLETION" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-completion\fR \- Tab Completion for npm
.SH SYNOPSIS
@@ -18,11 +18,11 @@ your ~/\.bashrc or ~/\.zshrc will make the completions available
everywhere\.
.P
You may of course also pipe the output of npm completion to a file
-such as \fB/usr/local/etc/bash_completion\.d/npm\fR if you have a system
+such as \fB/usr/local/etc/bash_completion\.d/npm\fP if you have a system
that will read that file for you\.
.P
-When \fBCOMP_CWORD\fR, \fBCOMP_LINE\fR, and \fBCOMP_POINT\fR are defined in the
-environment, \fBnpm completion\fR acts in "plumbing mode", and outputs
+When \fBCOMP_CWORD\fP, \fBCOMP_LINE\fP, and \fBCOMP_POINT\fP are defined in the
+environment, \fBnpm completion\fP acts in "plumbing mode", and outputs
completions based on the arguments\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-config.1 b/deps/npm/man/man1/npm-config.1
index 17d74488a15232..97a290c1bc693d 100644
--- a/deps/npm/man/man1/npm-config.1
+++ b/deps/npm/man/man1/npm-config.1
@@ -1,4 +1,4 @@
-.TH "NPM\-CONFIG" "1" "June 2015" "" ""
+.TH "NPM\-CONFIG" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-config\fR \- Manage the npm configuration files
.SH SYNOPSIS
@@ -18,14 +18,14 @@ npm set [\-\-global]
.SH DESCRIPTION
.P
npm gets its config settings from the command line, environment
-variables, \fBnpmrc\fR files, and in some cases, the \fBpackage\.json\fR file\.
+variables, \fBnpmrc\fP files, and in some cases, the \fBpackage\.json\fP file\.
.P
See npm help 5 npmrc for more information about the npmrc files\.
.P
-See npm help 7 \fBnpm\-config\fR for a more thorough discussion of the mechanisms
+See npm help 7 \fBnpm\-config\fP for a more thorough discussion of the mechanisms
involved\.
.P
-The \fBnpm config\fR command can be used to update and edit the contents
+The \fBnpm config\fP command can be used to update and edit the contents
of the user and global npmrc files\.
.SH Sub\-commands
.P
@@ -76,7 +76,7 @@ npm config edit
.fi
.RE
.P
-Opens the config file in an editor\. Use the \fB\-\-global\fR flag to edit the
+Opens the config file in an editor\. Use the \fB\-\-global\fP flag to edit the
global config\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-dedupe.1 b/deps/npm/man/man1/npm-dedupe.1
index 89a3302f63984a..e567831f690aa0 100644
--- a/deps/npm/man/man1/npm-dedupe.1
+++ b/deps/npm/man/man1/npm-dedupe.1
@@ -1,4 +1,4 @@
-.TH "NPM\-DEDUPE" "1" "June 2015" "" ""
+.TH "NPM\-DEDUPE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-dedupe\fR \- Reduce duplication
.SH SYNOPSIS
@@ -27,7 +27,7 @@ a
.fi
.RE
.P
-In this case, npm help \fBnpm\-dedupe\fR will transform the tree to:
+In this case, npm help \fBnpm\-dedupe\fP will transform the tree to:
.P
.RS 2
.nf
@@ -58,7 +58,7 @@ registry\.
.P
This feature is experimental, and may change in future versions\.
.P
-The \fB\-\-tag\fR argument will apply to all of the affected dependencies\. If a
+The \fB\-\-tag\fP argument will apply to all of the affected dependencies\. If a
tag with the given name exists, the tagged version is preferred over newer
versions\.
.SH SEE ALSO
diff --git a/deps/npm/man/man1/npm-deprecate.1 b/deps/npm/man/man1/npm-deprecate.1
index c50e7841099a5c..be91456a332f64 100644
--- a/deps/npm/man/man1/npm-deprecate.1
+++ b/deps/npm/man/man1/npm-deprecate.1
@@ -1,4 +1,4 @@
-.TH "NPM\-DEPRECATE" "1" "June 2015" "" ""
+.TH "NPM\-DEPRECATE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-deprecate\fR \- Deprecate a version of a package
.SH SYNOPSIS
@@ -23,9 +23,9 @@ npm deprecate my\-thing@"< 0\.2\.3" "critical bug fixed in v0\.2\.3"
.RE
.P
Note that you must be the package owner to deprecate something\. See the
-\fBowner\fR and \fBadduser\fR help topics\.
+\fBowner\fP and \fBadduser\fP help topics\.
.P
-To un\-deprecate a package, specify an empty string (\fB""\fR) for the \fBmessage\fR argument\.
+To un\-deprecate a package, specify an empty string (\fB""\fP) for the \fBmessage\fP argument\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-dist-tag.1 b/deps/npm/man/man1/npm-dist-tag.1
index 4c8e977ac5db79..b6abdb44b73e88 100644
--- a/deps/npm/man/man1/npm-dist-tag.1
+++ b/deps/npm/man/man1/npm-dist-tag.1
@@ -1,4 +1,4 @@
-.TH "NPM\-DIST\-TAG" "1" "June 2015" "" ""
+.TH "NPM\-DIST\-TAG" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-dist-tag\fR \- Modify package distribution tags
.SH SYNOPSIS
@@ -17,7 +17,7 @@ Add, remove, and enumerate distribution tags on a package:
.IP \(bu 2
add:
Tags the specified version of the package with the specified tag, or the
-\fB\-\-tag\fR config if not specified\.
+\fB\-\-tag\fP config if not specified\.
.IP \(bu 2
rm:
Clear a tag that is no longer in use from the package\.
@@ -45,32 +45,32 @@ npm install \-\-tag
.fi
.RE
.P
-This also applies to \fBnpm dedupe\fR\|\.
+This also applies to \fBnpm dedupe\fP\|\.
.P
Publishing a package sets the "latest" tag to the published version unless the
-\fB\-\-tag\fR option is used\. For example, \fBnpm publish \-\-tag=beta\fR\|\.
+\fB\-\-tag\fP option is used\. For example, \fBnpm publish \-\-tag=beta\fP\|\.
.SH PURPOSE
.P
Tags can be used to provide an alias instead of version numbers\. For
-example, \fBnpm\fR currently uses the tag "next" to identify the upcoming
+example, \fBnpm\fP currently uses the tag "next" to identify the upcoming
version, and the tag "latest" to identify the current version\.
.P
A project might choose to have multiple streams of development, e\.g\.,
"stable", "canary"\.
.SH CAVEATS
.P
-This command used to be known as \fBnpm tag\fR, which only created new tags, and so
+This command used to be known as \fBnpm tag\fP, which only created new tags, and so
had a different syntax\.
.P
Tags must share a namespace with version numbers, because they are specified in
-the same slot: \fBnpm install @\fR vs \fBnpm install @\fR\|\.
+the same slot: \fBnpm install @\fP vs \fBnpm install @\fP\|\.
.P
Tags that can be interpreted as valid semver ranges will be rejected\. For
-example, \fBv1\.4\fR cannot be used as a tag, because it is interpreted by semver as
-\fB>=1\.4\.0 <1\.5\.0\fR\|\. See https://github\.com/npm/npm/issues/6082\|\.
+example, \fBv1\.4\fP cannot be used as a tag, because it is interpreted by semver as
+\fB>=1\.4\.0 <1\.5\.0\fP\|\. See https://github\.com/npm/npm/issues/6082\|\.
.P
The simplest way to avoid semver problems with tags is to use tags that do not
-begin with a number or the letter \fBv\fR\|\.
+begin with a number or the letter \fBv\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-docs.1 b/deps/npm/man/man1/npm-docs.1
index 8e986706717c58..2a221c644cb938 100644
--- a/deps/npm/man/man1/npm-docs.1
+++ b/deps/npm/man/man1/npm-docs.1
@@ -1,4 +1,4 @@
-.TH "NPM\-DOCS" "1" "June 2015" "" ""
+.TH "NPM\-DOCS" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-docs\fR \- Docs for a package in a web browser maybe
.SH SYNOPSIS
@@ -14,21 +14,21 @@ npm home (with no args in a package dir)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-documentation URL, and then tries to open it using the \fB\-\-browser\fR
+documentation URL, and then tries to open it using the \fB\-\-browser\fP
config param\. You can pass multiple package names at once\. If no
-package name is provided, it will search for a \fBpackage\.json\fR in
-the current folder and use the \fBname\fR property\.
+package name is provided, it will search for a \fBpackage\.json\fP in
+the current folder and use the \fBname\fP property\.
.SH CONFIGURATION
.SS browser
.RS 0
.IP \(bu 2
-Default: OS X: \fB"open"\fR, Windows: \fB"start"\fR, Others: \fB"xdg\-open"\fR
+Default: OS X: \fB"open"\fP, Windows: \fB"start"\fP, Others: \fB"xdg\-open"\fP
.IP \(bu 2
Type: String
.RE
.P
-The browser that is called by the \fBnpm docs\fR command to open websites\.
+The browser that is called by the \fBnpm docs\fP command to open websites\.
.SS registry
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-edit.1 b/deps/npm/man/man1/npm-edit.1
index 14787f50739d11..1668bba248e8a5 100644
--- a/deps/npm/man/man1/npm-edit.1
+++ b/deps/npm/man/man1/npm-edit.1
@@ -1,4 +1,4 @@
-.TH "NPM\-EDIT" "1" "June 2015" "" ""
+.TH "NPM\-EDIT" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-edit\fR \- Edit an installed package
.SH SYNOPSIS
@@ -11,26 +11,26 @@ npm edit [@]
.SH DESCRIPTION
.P
Opens the package folder in the default editor (or whatever you've
-configured as the npm \fBeditor\fR config \-\- see npm help 7 \fBnpm\-config\fR\|\.)
+configured as the npm \fBeditor\fP config \-\- see npm help 7 \fBnpm\-config\fP\|\.)
.P
After it has been edited, the package is rebuilt so as to pick up any
changes in compiled packages\.
.P
-For instance, you can do \fBnpm install connect\fR to install connect
-into your package, and then \fBnpm edit connect\fR to make a few
+For instance, you can do \fBnpm install connect\fP to install connect
+into your package, and then \fBnpm edit connect\fP to make a few
changes to your locally installed copy\.
.SH CONFIGURATION
.SS editor
.RS 0
.IP \(bu 2
-Default: \fBEDITOR\fR environment variable if set, or \fB"vi"\fR on Posix,
-or \fB"notepad"\fR on Windows\.
+Default: \fBEDITOR\fP environment variable if set, or \fB"vi"\fP on Posix,
+or \fB"notepad"\fP on Windows\.
.IP \(bu 2
Type: path
.RE
.P
-The command to run for \fBnpm edit\fR or \fBnpm config edit\fR\|\.
+The command to run for \fBnpm edit\fP or \fBnpm config edit\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-explore.1 b/deps/npm/man/man1/npm-explore.1
index a90a66ac9aa3eb..73ca3b5ac43041 100644
--- a/deps/npm/man/man1/npm-explore.1
+++ b/deps/npm/man/man1/npm-explore.1
@@ -1,4 +1,4 @@
-.TH "NPM\-EXPLORE" "1" "June 2015" "" ""
+.TH "NPM\-EXPLORE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-explore\fR \- Browse an installed package
.SH SYNOPSIS
@@ -16,7 +16,7 @@ If a command is specified, then it is run in the subshell, which then
immediately terminates\.
.P
This is particularly handy in the case of git submodules in the
-\fBnode_modules\fR folder:
+\fBnode_modules\fP folder:
.P
.RS 2
.nf
@@ -25,7 +25,7 @@ npm explore some\-dependency \-\- git pull origin master
.RE
.P
Note that the package is \fInot\fR automatically rebuilt afterwards, so be
-sure to use \fBnpm rebuild \fR if you make any changes\.
+sure to use \fBnpm rebuild \fP if you make any changes\.
.SH CONFIGURATION
.SS shell
.RS 0
@@ -37,7 +37,7 @@ Type: path
.RE
.P
-The shell to run for the \fBnpm explore\fR command\.
+The shell to run for the \fBnpm explore\fP command\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-help-search.1 b/deps/npm/man/man1/npm-help-search.1
index 1dae614a2f2f73..4f2ed84de2bb1c 100644
--- a/deps/npm/man/man1/npm-help-search.1
+++ b/deps/npm/man/man1/npm-help-search.1
@@ -1,4 +1,4 @@
-.TH "NPM\-HELP\-SEARCH" "1" "June 2015" "" ""
+.TH "NPM\-HELP\-SEARCH" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-help-search\fR \- Search npm help documentation
.SH SYNOPSIS
@@ -15,8 +15,8 @@ terms provided, and then list the results, sorted by relevance\.
.P
If only one result is found, then it will show that help topic\.
.P
-If the argument to \fBnpm help\fR is not a known help topic, then it will
-call \fBhelp\-search\fR\|\. It is rarely if ever necessary to call this
+If the argument to \fBnpm help\fP is not a known help topic, then it will
+call \fBhelp\-search\fP\|\. It is rarely if ever necessary to call this
command directly\.
.SH CONFIGURATION
.SS long
diff --git a/deps/npm/man/man1/npm-help.1 b/deps/npm/man/man1/npm-help.1
index e8cd06d8c43ffe..c735cb7472d0f9 100644
--- a/deps/npm/man/man1/npm-help.1
+++ b/deps/npm/man/man1/npm-help.1
@@ -1,4 +1,4 @@
-.TH "NPM\-HELP" "1" "June 2015" "" ""
+.TH "NPM\-HELP" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-help\fR \- Get help on npm
.SH SYNOPSIS
@@ -14,8 +14,8 @@ npm help some search terms
If supplied a topic, then show the appropriate documentation page\.
.P
If the topic does not exist, or if multiple terms are provided, then run
-the \fBhelp\-search\fR command to find a match\. Note that, if \fBhelp\-search\fR
-finds a single subject, then it will run \fBhelp\fR on that topic, so unique
+the \fBhelp\-search\fP command to find a match\. Note that, if \fBhelp\-search\fP
+finds a single subject, then it will run \fBhelp\fP on that topic, so unique
matches are equivalent to specifying a topic name\.
.SH CONFIGURATION
.SS viewer
@@ -29,7 +29,7 @@ Type: path
.P
The program to use to view help content\.
.P
-Set to \fB"browser"\fR to view html help content in the default web browser\.
+Set to \fB"browser"\fP to view html help content in the default web browser\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-init.1 b/deps/npm/man/man1/npm-init.1
index e91ef4acf75b45..712fd25faa1248 100644
--- a/deps/npm/man/man1/npm-init.1
+++ b/deps/npm/man/man1/npm-init.1
@@ -1,4 +1,4 @@
-.TH "NPM\-INIT" "1" "June 2015" "" ""
+.TH "NPM\-INIT" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-init\fR \- Interactively create a package\.json file
.SH SYNOPSIS
@@ -21,7 +21,7 @@ the options in there\.
It is strictly additive, so it does not delete options from your package\.json
without a really good reason to do so\.
.P
-If you invoke it with \fB\-f\fR, \fB\-\-force\fR, \fB\-y\fR, or \fB\-\-yes\fR, it will use only
+If you invoke it with \fB\-f\fP, \fB\-\-force\fP, \fB\-y\fP, or \fB\-\-yes\fP, it will use only
defaults and not prompt you for any options\.
.SH CONFIGURATION
.SS scope
diff --git a/deps/npm/man/man1/npm-install.1 b/deps/npm/man/man1/npm-install.1
index aae70eb8b080de..e4831263eb528d 100644
--- a/deps/npm/man/man1/npm-install.1
+++ b/deps/npm/man/man1/npm-install.1
@@ -1,4 +1,4 @@
-.TH "NPM\-INSTALL" "1" "June 2015" "" ""
+.TH "NPM\-INSTALL" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-install\fR \- Install a package
.SH SYNOPSIS
@@ -22,7 +22,7 @@ This command installs a package, and any packages that it depends on\. If the
package has a shrinkwrap file, the installation of dependencies will be driven
by that\. See npm help shrinkwrap\.
.P
-A \fBpackage\fR is:
+A \fBpackage\fP is:
.RS 0
.IP \(bu 2
a) a folder containing a program described by a package\.json file
@@ -31,13 +31,13 @@ b) a gzipped tarball containing (a)
.IP \(bu 2
c) a url that resolves to (b)
.IP \(bu 2
-d) a \fB@\fR that is published on the registry (see npm help 7 \fBnpm\-registry\fR) with (c)
+d) a \fB@\fP that is published on the registry (see npm help 7 \fBnpm\-registry\fP) with (c)
.IP \(bu 2
-e) a \fB@\fR that points to (d)
+e) a \fB@\fP that points to (d)
.IP \(bu 2
-f) a \fB\fR that has a "latest" tag satisfying (e)
+f) a \fB\fP that has a "latest" tag satisfying (e)
.IP \(bu 2
-g) a \fB\fR that resolves to (b)
+g) a \fB\fP that resolves to (b)
.RE
.P
@@ -47,23 +47,23 @@ perhaps if you also want to be able to easily install it elsewhere
after packing it up into a tarball (b)\.
.RS 0
.IP \(bu 2
-\fBnpm install\fR (in package directory, no arguments):
+\fBnpm install\fP (in package directory, no arguments):
Install the dependencies in the local node_modules folder\.
- In global mode (ie, with \fB\-g\fR or \fB\-\-global\fR appended to the command),
+ In global mode (ie, with \fB\-g\fP or \fB\-\-global\fP appended to the command),
it installs the current package context (ie, the current working
directory) as a global package\.
- By default, \fBnpm install\fR will install all modules listed as dependencies\.
- With the \fB\-\-production\fR flag (or when the \fBNODE_ENV\fR environment variable
- is set to \fBproduction\fR), npm will not install modules listed in
- \fBdevDependencies\fR\|\.
+ By default, \fBnpm install\fP will install all modules listed as dependencies\.
+ With the \fB\-\-production\fP flag (or when the \fBNODE_ENV\fP environment variable
+ is set to \fBproduction\fP), npm will not install modules listed in
+ \fBdevDependencies\fP\|\.
.IP \(bu 2
-\fBnpm install \fR:
+\fBnpm install \fP:
Install a package that is sitting in a folder on the filesystem\.
.IP \(bu 2
-\fBnpm install \fR:
+\fBnpm install \fP:
Install a package that is sitting on the filesystem\. Note: if you just want
to link a dev directory into your npm root, you can do this more easily by
- using \fBnpm link\fR\|\.
+ using \fBnpm link\fP\|\.
Example:
.P
.RS 2
@@ -72,7 +72,7 @@ after packing it up into a tarball (b)\.
.fi
.RE
.IP \(bu 2
-\fBnpm install \fR:
+\fBnpm install \fP:
Fetch the tarball url, and then install it\. In order to distinguish between
this and other options, the argument must start with "http://" or "https://"
Example:
@@ -83,9 +83,9 @@ after packing it up into a tarball (b)\.
.fi
.RE
.IP \(bu 2
-\fBnpm install [@/] [\-\-save|\-\-save\-dev|\-\-save\-optional]\fR:
- Do a \fB@\fR install, where \fB\fR is the "tag" config\. (See
- npm help 7 \fBnpm\-config\fR\|\.)
+\fBnpm install [@/] [\-\-save|\-\-save\-dev|\-\-save\-optional]\fP:
+ Do a \fB@\fP install, where \fB\fP is the "tag" config\. (See
+ npm help 7 \fBnpm\-config\fP\|\.)
In most cases, this will install the latest version
of the module published on npm\.
Example:
@@ -95,24 +95,24 @@ after packing it up into a tarball (b)\.
npm install sax
.fi
.RE
- \fBnpm install\fR takes 3 exclusive, optional flags which save or update
+ \fBnpm install\fP takes 3 exclusive, optional flags which save or update
the package version in your main package\.json:
.RS 0
.IP \(bu 2
-\fB\-\-save\fR: Package will appear in your \fBdependencies\fR\|\.
+\fB\-\-save\fP: Package will appear in your \fBdependencies\fP\|\.
.IP \(bu 2
-\fB\-\-save\-dev\fR: Package will appear in your \fBdevDependencies\fR\|\.
+\fB\-\-save\-dev\fP: Package will appear in your \fBdevDependencies\fP\|\.
.IP \(bu 2
-\fB\-\-save\-optional\fR: Package will appear in your \fBoptionalDependencies\fR\|\.
+\fB\-\-save\-optional\fP: Package will appear in your \fBoptionalDependencies\fP\|\.
When using any of the above options to save dependencies to your
package\.json, there is an additional, optional flag:
.IP \(bu 2
-\fB\-\-save\-exact\fR: Saved dependencies will be configured with an
+\fB\-\-save\-exact\fP: Saved dependencies will be configured with an
exact version rather than using npm's default semver range
operator\.
-\fB\fR is optional\. The package will be downloaded from the registry
+\fB\fP is optional\. The package will be downloaded from the registry
associated with the specified scope\. If no registry is associated with
-the given scope the default registry is assumed\. See npm help 7 \fBnpm\-scope\fR\|\.
+the given scope the default registry is assumed\. See npm help 7 \fBnpm\-scope\fP\|\.
Note: if you do not include the @\-symbol on your scope name, npm will
interpret this as a GitHub repository instead, see below\. Scopes names
must also be followed by a slash\.
@@ -142,7 +142,7 @@ fetch the package by name if it is not valid\.
.RE
.RS 0
.IP \(bu 2
-\fBnpm install [@/]@\fR:
+\fBnpm install [@/]@\fP:
Install the version of the package that is referenced by the specified tag\.
If the tag does not exist in the registry data for that package, then this
will fail\.
@@ -155,7 +155,7 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install [@/]@\fR:
+\fBnpm install [@/]@\fP:
Install the specified version of the package\. This will fail if the
version has not been published to the registry\.
Example:
@@ -167,9 +167,9 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install [@/]@\fR:
+\fBnpm install [@/]@\fP:
Install a version of the package matching the specified version range\. This
- will follow the same rules for resolving dependencies described in npm help 5 \fBpackage\.json\fR\|\.
+ will follow the same rules for resolving dependencies described in npm help 5 \fBpackage\.json\fP\|\.
Note that most version ranges must be put in quotes so that your shell will
treat it as a single argument\.
Example:
@@ -181,7 +181,7 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install \fR:
+\fBnpm install \fP:
Install a package by cloning a git remote url\. The format of the git
url is:
.P
@@ -190,25 +190,44 @@ fetch the package by name if it is not valid\.
://[[:]@][:][:/][#]
.fi
.RE
- \fB\fR is one of \fBgit\fR, \fBgit+ssh\fR, \fBgit+http\fR, or
- \fBgit+https\fR\|\. If no \fB\fR is specified, then \fBmaster\fR is
+ \fB\fP is one of \fBgit\fP, \fBgit+ssh\fP, \fBgit+http\fP, or
+ \fBgit+https\fP\|\. If no \fB\fP is specified, then \fBmaster\fP is
used\.
- Examples:
+ The following git environment variables are recognized by npm and will be added
+ to the environment when running git:
+.RS 0
+.IP \(bu 2
+\fBGIT_ASKPASS\fP
+.IP \(bu 2
+\fBGIT_PROXY_COMMAND\fP
+.IP \(bu 2
+\fBGIT_SSH\fP
+.IP \(bu 2
+\fBGIT_SSH_COMMAND\fP
+.IP \(bu 2
+\fBGIT_SSL_CAINFO\fP
+.IP \(bu 2
+\fBGIT_SSL_NO_VERIFY\fP
+See the git man page for details\.
+Examples:
.P
.RS 2
.nf
- git+ssh://git@github\.com:npm/npm\.git#v1\.0\.27
- git+https://isaacs@github\.com/npm/npm\.git
- git://github\.com/npm/npm\.git#v1\.0\.27
+npm install git+ssh://git@github\.com:npm/npm\.git#v1\.0\.27
+npm install git+https://isaacs@github\.com/npm/npm\.git
+npm install git://github\.com/npm/npm\.git#v1\.0\.27
+GIT_SSH_COMMAND='ssh \-i ~/\.ssh/custom_ident' npm install git+ssh://git@github\.com:npm/npm\.git
.fi
+.RE
+
.RE
.IP \(bu 2
-\fBnpm install /[#]\fR:
+\fBnpm install /[#]\fP:
.IP \(bu 2
-\fBnpm install github:/[#]\fR:
- Install the package at \fBhttps://github\.com/githubname/githubrepo\fR by
- attempting to clone it using \fBgit\fR\|\.
- If you don't specify a \fIcommit\-ish\fR then \fBmaster\fR will be used\.
+\fBnpm install github:/[#]\fP:
+ Install the package at \fBhttps://github\.com/githubname/githubrepo\fP by
+ attempting to clone it using \fBgit\fP\|\.
+ If you don't specify a \fIcommit\-ish\fR then \fBmaster\fP will be used\.
Examples:
.P
.RS 2
@@ -218,11 +237,11 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install gist:[/][#]\fR:
- Install the package at \fBhttps://gist\.github\.com/gistID\fR by attempting to
- clone it using \fBgit\fR\|\. The GitHub username associated with the gist is
- optional and will not be saved in \fBpackage\.json\fR if \fB\-\-save\fR is used\.
- If you don't specify a \fIcommit\-ish\fR then \fBmaster\fR will be used\.
+\fBnpm install gist:[/][#]\fP:
+ Install the package at \fBhttps://gist\.github\.com/gistID\fP by attempting to
+ clone it using \fBgit\fP\|\. The GitHub username associated with the gist is
+ optional and will not be saved in \fBpackage\.json\fP if \fB\-\-save\fP is used\.
+ If you don't specify a \fIcommit\-ish\fR then \fBmaster\fP will be used\.
Example:
.P
.RS 2
@@ -231,10 +250,10 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install bitbucket:/[#]\fR:
- Install the package at \fBhttps://bitbucket\.org/bitbucketname/bitbucketrepo\fR
- by attempting to clone it using \fBgit\fR\|\.
- If you don't specify a \fIcommit\-ish\fR then \fBmaster\fR will be used\.
+\fBnpm install bitbucket:/[#]\fP:
+ Install the package at \fBhttps://bitbucket\.org/bitbucketname/bitbucketrepo\fP
+ by attempting to clone it using \fBgit\fP\|\.
+ If you don't specify a \fIcommit\-ish\fR then \fBmaster\fP will be used\.
Example:
.P
.RS 2
@@ -243,10 +262,10 @@ fetch the package by name if it is not valid\.
.fi
.RE
.IP \(bu 2
-\fBnpm install gitlab:/[#]\fR:
- Install the package at \fBhttps://gitlab\.com/gitlabname/gitlabrepo\fR
- by attempting to clone it using \fBgit\fR\|\.
- If you don't specify a \fIcommit\-ish\fR then \fBmaster\fR will be used\.
+\fBnpm install gitlab:/[#]\fP:
+ Install the package at \fBhttps://gitlab\.com/gitlabname/gitlabrepo\fP
+ by attempting to clone it using \fBgit\fP\|\.
+ If you don't specify a \fIcommit\-ish\fR then \fBmaster\fP will be used\.
Example:
.P
.RS 2
@@ -266,11 +285,11 @@ npm install sax@">=0\.1\.0 <0\.2\.0" bench supervisor
.fi
.RE
.P
-The \fB\-\-tag\fR argument will apply to all of the specified install targets\. If a
+The \fB\-\-tag\fP argument will apply to all of the specified install targets\. If a
tag with the given name exists, the tagged version is preferred over newer
versions\.
.P
-The \fB\-\-force\fR argument will force npm to fetch remote resources even if a
+The \fB\-\-force\fP argument will force npm to fetch remote resources even if a
local copy exists on disk\.
.P
.RS 2
@@ -279,25 +298,25 @@ npm install sax \-\-force
.fi
.RE
.P
-The \fB\-\-global\fR argument will cause npm to install the package globally
-rather than locally\. See npm help 5 \fBnpm\-folders\fR\|\.
+The \fB\-\-global\fP argument will cause npm to install the package globally
+rather than locally\. See npm help 5 \fBnpm\-folders\fP\|\.
.P
-The \fB\-\-link\fR argument will cause npm to link global installs into the
+The \fB\-\-link\fP argument will cause npm to link global installs into the
local space in some cases\.
.P
-The \fB\-\-no\-bin\-links\fR argument will prevent npm from creating symlinks for
+The \fB\-\-no\-bin\-links\fP argument will prevent npm from creating symlinks for
any binaries the package might contain\.
.P
-The \fB\-\-no\-optional\fR argument will prevent optional dependencies from
+The \fB\-\-no\-optional\fP argument will prevent optional dependencies from
being installed\.
.P
-The \fB\-\-no\-shrinkwrap\fR argument, which will ignore an available
+The \fB\-\-no\-shrinkwrap\fP argument, which will ignore an available
shrinkwrap file and use the package\.json instead\.
.P
-The \fB\-\-nodedir=/path/to/node/source\fR argument will allow npm to find the
+The \fB\-\-nodedir=/path/to/node/source\fP argument will allow npm to find the
node source code so that npm can compile native modules\.
.P
-See npm help 7 \fBnpm\-config\fR\|\. Many of the configuration params have some
+See npm help 7 \fBnpm\-config\fP\|\. Many of the configuration params have some
effect on installation, since that's most of what npm does\.
.SH ALGORITHM
.P
@@ -317,7 +336,7 @@ for each dep@version in what\.dependencies
.fi
.RE
.P
-For this \fBpackage{dep}\fR structure: \fBA{B,C}, B{C}, C{D}\fR,
+For this \fBpackage{dep}\fP structure: \fBA{B,C}, B{C}, C{D}\fP,
this algorithm produces:
.P
.RS 2
@@ -346,15 +365,15 @@ A \-> B \-> A' \-> B' \-> A \-> B \-> A' \-> B' \-> A \-> \.\.\.
.fi
.RE
.P
-where \fBA\fR is some version of a package, and \fBA'\fR is a different version
-of the same package\. Because \fBB\fR depends on a different version of \fBA\fR
+where \fBA\fP is some version of a package, and \fBA'\fP is a different version
+of the same package\. Because \fBB\fP depends on a different version of \fBA\fP
than the one that is already in the tree, it must install a separate
-copy\. The same is true of \fBA'\fR, which must install \fBB'\fR\|\. Because \fBB'\fR
-depends on the original version of \fBA\fR, which has been overridden, the
+copy\. The same is true of \fBA'\fP, which must install \fBB'\fP\|\. Because \fBB'\fP
+depends on the original version of \fBA\fP, which has been overridden, the
cycle falls into infinite regress\.
.P
To avoid this situation, npm flat\-out refuses to install any
-\fBname@version\fR that is already present anywhere in the tree of package
+\fBname@version\fP that is already present anywhere in the tree of package
folder ancestors\. A more correct, but more complex, solution would be
to symlink the existing version into the new location\. If this ever
affects a real use\-case, it will be investigated\.
diff --git a/deps/npm/man/man1/npm-link.1 b/deps/npm/man/man1/npm-link.1
index 9aa054dea25eb6..8063ef930e624f 100644
--- a/deps/npm/man/man1/npm-link.1
+++ b/deps/npm/man/man1/npm-link.1
@@ -1,4 +1,4 @@
-.TH "NPM\-LINK" "1" "June 2015" "" ""
+.TH "NPM\-LINK" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-link\fR \- Symlink a package folder
.SH SYNOPSIS
@@ -14,20 +14,20 @@ npm ln (with any of the previous argument usage)
.P
Package linking is a two\-step process\.
.P
-First, \fBnpm link\fR in a package folder will create a globally\-installed
-symbolic link from \fBprefix/package\-name\fR to the current folder (see
-npm help 7 \fBnpm\-config\fR for the value of \fBprefix\fR)\.
+First, \fBnpm link\fP in a package folder will create a globally\-installed
+symbolic link from \fBprefix/package\-name\fP to the current folder (see
+npm help 7 \fBnpm\-config\fP for the value of \fBprefix\fP)\.
.P
-Next, in some other location, \fBnpm link package\-name\fR will create a
-symlink from the local \fBnode_modules\fR folder to the global symlink\.
+Next, in some other location, \fBnpm link package\-name\fP will create a
+symlink from the local \fBnode_modules\fP folder to the global symlink\.
.P
-Note that \fBpackage\-name\fR is taken from \fBpackage\.json\fR,
+Note that \fBpackage\-name\fP is taken from \fBpackage\.json\fP,
not from directory name\.
.P
-The package name can be optionally prefixed with a scope\. See npm help 7 \fBnpm\-scope\fR\|\.
+The package name can be optionally prefixed with a scope\. See npm help 7 \fBnpm\-scope\fP\|\.
The scope must be preceded by an @\-symbol and followed by a slash\.
.P
-When creating tarballs for \fBnpm publish\fR, the linked packages are
+When creating tarballs for \fBnpm publish\fP, the linked packages are
"snapshotted" to their current state by resolving the symbolic links\.
.P
This is handy for installing your own stuff, so that you can work on it and
@@ -68,9 +68,9 @@ npm link node\-redis
.RE
.P
That is, it first creates a global link, and then links the global
-installation target into your project's \fBnode_modules\fR folder\.
+installation target into your project's \fBnode_modules\fP folder\.
.P
-If your linked package is scoped (see npm help 7 \fBnpm\-scope\fR) your link command must
+If your linked package is scoped (see npm help 7 \fBnpm\-scope\fP) your link command must
include that scope, e\.g\.
.P
.RS 2
diff --git a/deps/npm/man/man1/npm-logout.1 b/deps/npm/man/man1/npm-logout.1
index a4c21651e1d061..6847fbf5983f22 100644
--- a/deps/npm/man/man1/npm-logout.1
+++ b/deps/npm/man/man1/npm-logout.1
@@ -1,4 +1,4 @@
-.TH "NPM\-LOGOUT" "1" "June 2015" "" ""
+.TH "NPM\-LOGOUT" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-logout\fR \- Log out of the registry
.SH SYNOPSIS
@@ -18,21 +18,21 @@ When logged into a legacy registry that uses username and password authenticatio
clear the credentials in your user configuration\. In this case, it will \fIonly\fR affect
the current environment\.
.P
-If \fB\-\-scope\fR is provided, this will find the credentials for the registry
+If \fB\-\-scope\fP is provided, this will find the credentials for the registry
connected to that scope, if set\.
.SH CONFIGURATION
.SS registry
.P
Default: http://registry\.npmjs\.org/
.P
-The base URL of the npm package registry\. If \fBscope\fR is also specified,
+The base URL of the npm package registry\. If \fBscope\fP is also specified,
it takes precedence\.
.SS scope
.P
Default: none
.P
If specified, the user and login credentials given will be associated
-with the specified scope\. See npm help 7 \fBnpm\-scope\fR\|\. You can use both at the same time,
+with the specified scope\. See npm help 7 \fBnpm\-scope\fP\|\. You can use both at the same time,
e\.g\.
.P
.RS 2
diff --git a/deps/npm/man/man1/npm-ls.1 b/deps/npm/man/man1/npm-ls.1
index 31d93d17b4a77b..b24cc75fac870e 100644
--- a/deps/npm/man/man1/npm-ls.1
+++ b/deps/npm/man/man1/npm-ls.1
@@ -1,4 +1,4 @@
-.TH "NPM\-LS" "1" "June 2015" "" ""
+.TH "NPM\-LS" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-ls\fR \- List installed packages
.SH SYNOPSIS
@@ -16,14 +16,14 @@ npm ll [[@/] \.\.\.]
This command will print to stdout all the versions of packages that are
installed, as well as their dependencies, in a tree\-structure\.
.P
-Positional arguments are \fBname@version\-range\fR identifiers, which will
+Positional arguments are \fBname@version\-range\fP identifiers, which will
limit the results to only the paths to the packages named\. Note that
nested packages will \fIalso\fR show the paths to the specified packages\.
-For example, running \fBnpm ls promzard\fR in npm's source tree will show:
+For example, running \fBnpm ls promzard\fP in npm's source tree will show:
.P
.RS 2
.nf
-npm@2.11.3 /path/to/npm
+npm@2.13.4 /path/to/npm
└─┬ init\-package\-json@0\.0\.4
└── promzard@0\.1\.5
.fi
@@ -35,7 +35,7 @@ If a project specifies git urls for dependencies these are shown
in parentheses after the name@version to make it easier for users to
recognize potential forks of a project\.
.P
-When run as \fBll\fR or \fBla\fR, it shows extended information by default\.
+When run as \fBll\fP or \fBla\fP, it shows extended information by default\.
.SH CONFIGURATION
.SS json
.RS 0
@@ -95,7 +95,7 @@ Default: false
.RE
.P
-Display only the dependency tree for packages in \fBdependencies\fR\|\.
+Display only the dependency tree for packages in \fBdependencies\fP\|\.
.SS dev
.RS 0
.IP \(bu 2
@@ -105,7 +105,7 @@ Default: false
.RE
.P
-Display only the dependency tree for packages in \fBdevDependencies\fR\|\.
+Display only the dependency tree for packages in \fBdevDependencies\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-outdated.1 b/deps/npm/man/man1/npm-outdated.1
index e9998f4a7f719b..6967f0a98b39f7 100644
--- a/deps/npm/man/man1/npm-outdated.1
+++ b/deps/npm/man/man1/npm-outdated.1
@@ -1,4 +1,4 @@
-.TH "NPM\-OUTDATED" "1" "June 2015" "" ""
+.TH "NPM\-OUTDATED" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-outdated\fR \- Check for outdated packages
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-owner.1 b/deps/npm/man/man1/npm-owner.1
index ee291a46bbba9f..216e832c49b418 100644
--- a/deps/npm/man/man1/npm-owner.1
+++ b/deps/npm/man/man1/npm-owner.1
@@ -1,4 +1,4 @@
-.TH "NPM\-OWNER" "1" "June 2015" "" ""
+.TH "NPM\-OWNER" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-owner\fR \- Manage package owners
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-pack.1 b/deps/npm/man/man1/npm-pack.1
index 16d56c949f8827..380ebac866942c 100644
--- a/deps/npm/man/man1/npm-pack.1
+++ b/deps/npm/man/man1/npm-pack.1
@@ -1,4 +1,4 @@
-.TH "NPM\-PACK" "1" "June 2015" "" ""
+.TH "NPM\-PACK" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-pack\fR \- Create a tarball from a package
.SH SYNOPSIS
@@ -13,7 +13,7 @@ npm pack [ [ \.\.\.]]
For anything that's installable (that is, a package folder, tarball,
tarball url, name@tag, name@version, or name), this command will fetch
it to the cache, and then copy the tarball to the current working
-directory as \fB\-\.tgz\fR, and then write the filenames out to
+directory as \fB\-\.tgz\fP, and then write the filenames out to
stdout\.
.P
If the same package is specified multiple times, then the file will be
diff --git a/deps/npm/man/man1/npm-ping.1 b/deps/npm/man/man1/npm-ping.1
new file mode 100644
index 00000000000000..8eb3faecab89a6
--- /dev/null
+++ b/deps/npm/man/man1/npm-ping.1
@@ -0,0 +1,23 @@
+.TH "NPM\-PING" "1" "August 2015" "" ""
+.SH "NAME"
+\fBnpm-ping\fR \- Ping npm registry
+.SH SYNOPSIS
+.P
+.RS 2
+.nf
+npm ping [\-\-registry ]
+.fi
+.RE
+.SH DESCRIPTION
+.P
+Ping the configured or given npm registry and verify authentication\.
+.SH SEE ALSO
+.RS 0
+.IP \(bu 2
+npm help config
+.IP \(bu 2
+npm help 7 config
+.IP \(bu 2
+npm help 5 npmrc
+
+.RE
diff --git a/deps/npm/man/man1/npm-prefix.1 b/deps/npm/man/man1/npm-prefix.1
index 308b8be08e6e5d..edfb6c1f265d87 100644
--- a/deps/npm/man/man1/npm-prefix.1
+++ b/deps/npm/man/man1/npm-prefix.1
@@ -1,4 +1,4 @@
-.TH "NPM\-PREFIX" "1" "June 2015" "" ""
+.TH "NPM\-PREFIX" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-prefix\fR \- Display prefix
.SH SYNOPSIS
@@ -11,10 +11,10 @@ npm prefix [\-g]
.SH DESCRIPTION
.P
Print the local prefix to standard out\. This is the closest parent directory
-to contain a package\.json file unless \fB\-g\fR is also specified\.
+to contain a package\.json file unless \fB\-g\fP is also specified\.
.P
-If \fB\-g\fR is specified, this will be the value of the global prefix\. See
-npm help 7 \fBnpm\-config\fR for more detail\.
+If \fB\-g\fP is specified, this will be the value of the global prefix\. See
+npm help 7 \fBnpm\-config\fP for more detail\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-prune.1 b/deps/npm/man/man1/npm-prune.1
index a6178226e859d8..cdada7e0767ed8 100644
--- a/deps/npm/man/man1/npm-prune.1
+++ b/deps/npm/man/man1/npm-prune.1
@@ -1,4 +1,4 @@
-.TH "NPM\-PRUNE" "1" "June 2015" "" ""
+.TH "NPM\-PRUNE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-prune\fR \- Remove extraneous packages
.SH SYNOPSIS
@@ -18,10 +18,10 @@ removed\.
Extraneous packages are packages that are not listed on the parent
package's dependencies list\.
.P
-If the \fB\-\-production\fR flag is specified or the \fBNODE_ENV\fR environment
-variable is set to \fBproduction\fR, this command will remove the packages
-specified in your \fBdevDependencies\fR\|\. Setting \fB\-\-production=false\fR will
-negate \fBNODE_ENV\fR being set to \fBproduction\fR\|\.
+If the \fB\-\-production\fP flag is specified or the \fBNODE_ENV\fP environment
+variable is set to \fBproduction\fP, this command will remove the packages
+specified in your \fBdevDependencies\fP\|\. Setting \fB\-\-production=false\fP will
+negate \fBNODE_ENV\fP being set to \fBproduction\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-publish.1 b/deps/npm/man/man1/npm-publish.1
index 5a092c16d73240..b02ff7d444f0d7 100644
--- a/deps/npm/man/man1/npm-publish.1
+++ b/deps/npm/man/man1/npm-publish.1
@@ -1,4 +1,4 @@
-.TH "NPM\-PUBLISH" "1" "June 2015" "" ""
+.TH "NPM\-PUBLISH" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-publish\fR \- Publish a package
.SH SYNOPSIS
@@ -12,30 +12,30 @@ npm publish [\-\-tag ] [\-\-access ]
.SH DESCRIPTION
.P
Publishes a package to the registry so that it can be installed by name\. See
-npm help 7 \fBnpm\-developers\fR for details on what's included in the published package, as
+npm help 7 \fBnpm\-developers\fP for details on what's included in the published package, as
well as details on how the package is built\.
.P
By default npm will publish to the public registry\. This can be overridden by
-specifying a different default registry or using a npm help 7 \fBnpm\-scope\fR in the name
-(see npm help 5 \fBpackage\.json\fR)\.
+specifying a different default registry or using a npm help 7 \fBnpm\-scope\fP in the name
+(see npm help 5 \fBpackage\.json\fP)\.
.RS 0
.IP \(bu 2
-\fB\fR:
+\fB\fP:
A folder containing a package\.json file
.IP \(bu 2
-\fB\fR:
+\fB\fP:
A url or file path to a gzipped tar archive containing a single folder
with a package\.json file inside\.
.IP \(bu 2
-\fB[\-\-tag ]\fR
+\fB[\-\-tag ]\fP
Registers the published package with the given tag, such that \fBnpm install
-@\fR will install this version\. By default, \fBnpm publish\fR updates
-and \fBnpm install\fR installs the \fBlatest\fR tag\.
+@\fP will install this version\. By default, \fBnpm publish\fP updates
+and \fBnpm install\fP installs the \fBlatest\fP tag\.
.IP \(bu 2
-\fB[\-\-access ]\fR
+\fB[\-\-access ]\fP
Tells the registry whether this package should be published as public or
-restricted\. Only applies to scoped packages, which default to \fBrestricted\fR\|\.
-If you don't have a paid account, you must publish with \fB\-\-access public\fR
+restricted\. Only applies to scoped packages, which default to \fBrestricted\fP\|\.
+If you don't have a paid account, you must publish with \fB\-\-access public\fP
to publish scoped packages\.
.RE
diff --git a/deps/npm/man/man1/npm-rebuild.1 b/deps/npm/man/man1/npm-rebuild.1
index e8347ea552ed25..5ad90138d49a43 100644
--- a/deps/npm/man/man1/npm-rebuild.1
+++ b/deps/npm/man/man1/npm-rebuild.1
@@ -1,4 +1,4 @@
-.TH "NPM\-REBUILD" "1" "June 2015" "" ""
+.TH "NPM\-REBUILD" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-rebuild\fR \- Rebuild a package
.SH SYNOPSIS
@@ -11,13 +11,13 @@ npm rb [ [ \.\.\.]]
.RE
.RS 0
.IP \(bu 2
-\fB\fR:
+\fB\fP:
The package to rebuild
.RE
.SH DESCRIPTION
.P
-This command runs the \fBnpm build\fR command on the matched folders\. This is useful
+This command runs the \fBnpm build\fP command on the matched folders\. This is useful
when you install a new version of node, and must recompile all your C++ addons with
the new binary\.
.SH SEE ALSO
diff --git a/deps/npm/man/man1/npm-repo.1 b/deps/npm/man/man1/npm-repo.1
index bbbc8b1282b44f..9051863aa67a7a 100644
--- a/deps/npm/man/man1/npm-repo.1
+++ b/deps/npm/man/man1/npm-repo.1
@@ -1,4 +1,4 @@
-.TH "NPM\-REPO" "1" "June 2015" "" ""
+.TH "NPM\-REPO" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-repo\fR \- Open package repository page in the browser
.SH SYNOPSIS
@@ -12,20 +12,20 @@ npm repo (with no args in a package dir)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-repository URL, and then tries to open it using the \fB\-\-browser\fR
+repository URL, and then tries to open it using the \fB\-\-browser\fP
config param\. If no package name is provided, it will search for
-a \fBpackage\.json\fR in the current folder and use the \fBname\fR property\.
+a \fBpackage\.json\fP in the current folder and use the \fBname\fP property\.
.SH CONFIGURATION
.SS browser
.RS 0
.IP \(bu 2
-Default: OS X: \fB"open"\fR, Windows: \fB"start"\fR, Others: \fB"xdg\-open"\fR
+Default: OS X: \fB"open"\fP, Windows: \fB"start"\fP, Others: \fB"xdg\-open"\fP
.IP \(bu 2
Type: String
.RE
.P
-The browser that is called by the \fBnpm repo\fR command to open websites\.
+The browser that is called by the \fBnpm repo\fP command to open websites\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-restart.1 b/deps/npm/man/man1/npm-restart.1
index f45e6411439da8..203fb24c46dcfb 100644
--- a/deps/npm/man/man1/npm-restart.1
+++ b/deps/npm/man/man1/npm-restart.1
@@ -1,4 +1,4 @@
-.TH "NPM\-RESTART" "1" "June 2015" "" ""
+.TH "NPM\-RESTART" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-restart\fR \- Restart a package
.SH SYNOPSIS
@@ -40,7 +40,7 @@ postrestart
Note that the "restart" script is run \fBin addition to\fR the "stop"
and "start" scripts, not instead of them\.
.P
-This is the behavior as of \fBnpm\fR major version 2\. A change in this
+This is the behavior as of \fBnpm\fP major version 2\. A change in this
behavior will be accompanied by an increase in major version number
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-rm.1 b/deps/npm/man/man1/npm-rm.1
index 548a870f21e5a9..cd6b6b3ac9f803 100644
--- a/deps/npm/man/man1/npm-rm.1
+++ b/deps/npm/man/man1/npm-rm.1
@@ -1,4 +1,4 @@
-.TH "NPM\-RM" "1" "June 2015" "" ""
+.TH "NPM\-RM" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-rm\fR \- Remove a package
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-root.1 b/deps/npm/man/man1/npm-root.1
index 7e0eeacb3beec9..71666d0d183947 100644
--- a/deps/npm/man/man1/npm-root.1
+++ b/deps/npm/man/man1/npm-root.1
@@ -1,4 +1,4 @@
-.TH "NPM\-ROOT" "1" "June 2015" "" ""
+.TH "NPM\-ROOT" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-root\fR \- Display npm root
.SH SYNOPSIS
@@ -10,7 +10,7 @@ npm root
.RE
.SH DESCRIPTION
.P
-Print the effective \fBnode_modules\fR folder to standard out\.
+Print the effective \fBnode_modules\fP folder to standard out\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-run-script.1 b/deps/npm/man/man1/npm-run-script.1
index 351800eb59a66d..259aceb92f0512 100644
--- a/deps/npm/man/man1/npm-run-script.1
+++ b/deps/npm/man/man1/npm-run-script.1
@@ -1,4 +1,4 @@
-.TH "NPM\-RUN\-SCRIPT" "1" "June 2015" "" ""
+.TH "NPM\-RUN\-SCRIPT" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-run-script\fR \- Run arbitrary package scripts
.SH SYNOPSIS
@@ -11,16 +11,16 @@ npm run [command] [\-\- ]
.RE
.SH DESCRIPTION
.P
-This runs an arbitrary command from a package's \fB"scripts"\fR object\. If no
-\fB"command"\fR is provided, it will list the available scripts\. \fBrun[\-script]\fR is
+This runs an arbitrary command from a package's \fB"scripts"\fP object\. If no
+\fB"command"\fP is provided, it will list the available scripts\. \fBrun[\-script]\fP is
used by the test, start, restart, and stop commands, but can be called
directly, as well\. When the scripts in the package are printed out, they're
separated into lifecycle (test, start, restart) and directly\-run scripts\.
.P
-As of \fBnpm@2\.0\.0\fR \fIhttp://blog\.npmjs\.org/post/98131109725/npm\-2\-0\-0\fR, you can
-use custom arguments when executing scripts\. The special option \fB\-\-\fR is used by
+As of \fBnpm@2\.0\.0\fP \fIhttp://blog\.npmjs\.org/post/98131109725/npm\-2\-0\-0\fR, you can
+use custom arguments when executing scripts\. The special option \fB\-\-\fP is used by
getopt \fIhttp://goo\.gl/KxMmtG\fR to delimit the end of the options\. npm will pass
-all the arguments after the \fB\-\-\fR directly to your script:
+all the arguments after the \fB\-\-\fP directly to your script:
.P
.RS 2
.nf
@@ -28,20 +28,27 @@ npm run test \-\- \-\-grep="pattern"
.fi
.RE
.P
-The arguments will only be passed to the script specified after \fBnpm run\fR
+The arguments will only be passed to the script specified after \fBnpm run\fP
and not to any pre or post script\.
.P
-The \fBenv\fR script is a special built\-in command that can be used to list
+The \fBenv\fP script is a special built\-in command that can be used to list
environment variables that will be available to the script at runtime\. If an
"env" command is defined in your package it will take precedence over the
built\-in\.
.P
-In addition to the shell's pre\-existing \fBPATH\fR, \fBnpm run\fR adds
-\fBnode_modules/\.bin\fR to the \fBPATH\fR provided to scripts\. Any binaries provided by
-locally\-installed dependencies can be used without the \fBnode_modules/\.bin\fR
-prefix\. For example, if there is a \fBdevDependency\fR on \fBtap\fR in your package,
-you should write \fB"scripts": {"test": "tap test/\\*\.js"}\fR instead of \fB"scripts":
-{"test": "node_modules/\.bin/tap test/\\*\.js"}\fR to run your tests\.
+In addition to the shell's pre\-existing \fBPATH\fP, \fBnpm run\fP adds
+\fBnode_modules/\.bin\fP to the \fBPATH\fP provided to scripts\. Any binaries provided by
+locally\-installed dependencies can be used without the \fBnode_modules/\.bin\fP
+prefix\. For example, if there is a \fBdevDependency\fP on \fBtap\fP in your package,
+you should write:
+.P
+.RS 2
+.nf
+"scripts": {"test": "tap test/\\*\.js"}
+.fi
+.RE
+.P
+instead of \fB"scripts": {"test": "node_modules/\.bin/tap test/\\*\.js"}\fP to run your tests\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-search.1 b/deps/npm/man/man1/npm-search.1
index b617bbbe7032fc..eef7c072ea531d 100644
--- a/deps/npm/man/man1/npm-search.1
+++ b/deps/npm/man/man1/npm-search.1
@@ -1,4 +1,4 @@
-.TH "NPM\-SEARCH" "1" "June 2015" "" ""
+.TH "NPM\-SEARCH" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-search\fR \- Search for packages
.SH SYNOPSIS
@@ -14,8 +14,8 @@ npm se [search terms \.\.\.]
.P
Search the registry for packages matching the search terms\.
.P
-If a term starts with \fB/\fR, then it's interpreted as a regular expression\.
-A trailing \fB/\fR will be ignored in this case\. (Note that many regular
+If a term starts with \fB/\fP, then it's interpreted as a regular expression\.
+A trailing \fB/\fP will be ignored in this case\. (Note that many regular
expression characters must be escaped or quoted in most shells\.)
.SH CONFIGURATION
.SS long
diff --git a/deps/npm/man/man1/npm-shrinkwrap.1 b/deps/npm/man/man1/npm-shrinkwrap.1
index 521634d13b314f..39d910b54593b0 100644
--- a/deps/npm/man/man1/npm-shrinkwrap.1
+++ b/deps/npm/man/man1/npm-shrinkwrap.1
@@ -1,4 +1,4 @@
-.TH "NPM\-SHRINKWRAP" "1" "June 2015" "" ""
+.TH "NPM\-SHRINKWRAP" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-shrinkwrap\fR \- Lock down dependency versions
.SH SYNOPSIS
@@ -12,18 +12,18 @@ npm shrinkwrap
.P
This command locks down the versions of a package's dependencies so
that you can control exactly which versions of each dependency will be
-used when your package is installed\. The \fBpackage\.json\fR file is still
-required if you want to use \fBnpm install\fR\|\.
+used when your package is installed\. The \fBpackage\.json\fP file is still
+required if you want to use \fBnpm install\fP\|\.
.P
-By default, \fBnpm install\fR recursively installs the target's
-dependencies (as specified in \fBpackage\.json\fR), choosing the latest
+By default, \fBnpm install\fP recursively installs the target's
+dependencies (as specified in \fBpackage\.json\fP), choosing the latest
available version that satisfies the dependency's semver pattern\. In
some situations, particularly when shipping software where each change
is tightly managed, it's desirable to fully specify each version of
each dependency recursively so that subsequent builds and deploys do
not inadvertently pick up newer versions of a dependency that satisfy
the semver pattern\. Specifying specific semver patterns in each
-dependency's \fBpackage\.json\fR would facilitate this, but that's not always
+dependency's \fBpackage\.json\fP would facilitate this, but that's not always
possible or desirable, as when another author owns the npm package\.
It's also possible to check dependencies directly into source control,
but that may be undesirable for other reasons\.
@@ -68,7 +68,7 @@ and package C:
.RE
.P
If these are the only versions of A, B, and C available in the
-registry, then a normal \fBnpm install A\fR will install:
+registry, then a normal \fBnpm install A\fP will install:
.P
.RS 2
.nf
@@ -78,7 +78,7 @@ A@0\.1\.0
.fi
.RE
.P
-However, if B@0\.0\.2 is published, then a fresh \fBnpm install A\fR will
+However, if B@0\.0\.2 is published, then a fresh \fBnpm install A\fP will
install:
.P
.RS 2
@@ -105,7 +105,7 @@ npm shrinkwrap
.fi
.RE
.P
-This generates \fBnpm\-shrinkwrap\.json\fR, which will look something like this:
+This generates \fBnpm\-shrinkwrap\.json\fP, which will look something like this:
.P
.RS 2
.nf
@@ -127,30 +127,30 @@ This generates \fBnpm\-shrinkwrap\.json\fR, which will look something like this:
.RE
.P
The shrinkwrap command has locked down the dependencies based on
-what's currently installed in node_modules\. When \fBnpm install\fR
-installs a package with an \fBnpm\-shrinkwrap\.json\fR in the package
-root, the shrinkwrap file (rather than \fBpackage\.json\fR files) completely
+what's currently installed in node_modules\. When \fBnpm install\fP
+installs a package with an \fBnpm\-shrinkwrap\.json\fP in the package
+root, the shrinkwrap file (rather than \fBpackage\.json\fP files) completely
drives the installation of that package and all of its dependencies
(recursively)\. So now the author publishes A@0\.1\.0, and subsequent
installs of this package will use B@0\.0\.1 and C@0\.0\.1, regardless the
-dependencies and versions listed in A's, B's, and C's \fBpackage\.json\fR
+dependencies and versions listed in A's, B's, and C's \fBpackage\.json\fP
files\.
.SS Using shrinkwrapped packages
.P
Using a shrinkwrapped package is no different than using any other
-package: you can \fBnpm install\fR it by hand, or add a dependency to your
-\fBpackage\.json\fR file and \fBnpm install\fR it\.
+package: you can \fBnpm install\fP it by hand, or add a dependency to your
+\fBpackage\.json\fP file and \fBnpm install\fP it\.
.SS Building shrinkwrapped packages
.P
To shrinkwrap an existing package:
.RS 0
.IP 1. 3
-Run \fBnpm install\fR in the package root to install the current
+Run \fBnpm install\fP in the package root to install the current
versions of all dependencies\.
.IP 2. 3
Validate that the package works as expected with these versions\.
.IP 3. 3
-Run \fBnpm shrinkwrap\fR, add \fBnpm\-shrinkwrap\.json\fR to git, and publish
+Run \fBnpm shrinkwrap\fP, add \fBnpm\-shrinkwrap\.json\fP to git, and publish
your package\.
.RE
@@ -158,19 +158,19 @@ your package\.
To add or update a dependency in a shrinkwrapped package:
.RS 0
.IP 1. 3
-Run \fBnpm install\fR in the package root to install the current
+Run \fBnpm install\fP in the package root to install the current
versions of all dependencies\.
.IP 2. 3
-Add or update dependencies\. \fBnpm install\fR each new or updated
-package individually and then update \fBpackage\.json\fR\|\. Note that they
+Add or update dependencies\. \fBnpm install\fP each new or updated
+package individually and then update \fBpackage\.json\fP\|\. Note that they
must be explicitly named in order to be installed: running \fBnpm
-install\fR with no arguments will merely reproduce the existing
+install\fP with no arguments will merely reproduce the existing
shrinkwrap\.
.IP 3. 3
Validate that the package works as expected with the new
dependencies\.
.IP 4. 3
-Run \fBnpm shrinkwrap\fR, commit the new \fBnpm\-shrinkwrap\.json\fR, and
+Run \fBnpm shrinkwrap\fP, commit the new \fBnpm\-shrinkwrap\.json\fP, and
publish your package\.
.RE
@@ -179,19 +179,19 @@ You can use npm help outdated to view dependencies with newer versions
available\.
.SS Other Notes
.P
-A shrinkwrap file must be consistent with the package's \fBpackage\.json\fR
-file\. \fBnpm shrinkwrap\fR will fail if required dependencies are not
+A shrinkwrap file must be consistent with the package's \fBpackage\.json\fP
+file\. \fBnpm shrinkwrap\fP will fail if required dependencies are not
already installed, since that would result in a shrinkwrap that
wouldn't actually work\. Similarly, the command will fail if there are
-extraneous packages (not referenced by \fBpackage\.json\fR), since that would
-indicate that \fBpackage\.json\fR is not correct\.
+extraneous packages (not referenced by \fBpackage\.json\fP), since that would
+indicate that \fBpackage\.json\fP is not correct\.
.P
-Since \fBnpm shrinkwrap\fR is intended to lock down your dependencies for
-production use, \fBdevDependencies\fR will not be included unless you
-explicitly set the \fB\-\-dev\fR flag when you run \fBnpm shrinkwrap\fR\|\. If
-installed \fBdevDependencies\fR are excluded, then npm will print a
+Since \fBnpm shrinkwrap\fP is intended to lock down your dependencies for
+production use, \fBdevDependencies\fP will not be included unless you
+explicitly set the \fB\-\-dev\fP flag when you run \fBnpm shrinkwrap\fP\|\. If
+installed \fBdevDependencies\fP are excluded, then npm will print a
warning\. If you want them to be installed with your module by
-default, please consider adding them to \fBdependencies\fR instead\.
+default, please consider adding them to \fBdependencies\fP instead\.
.P
If shrinkwrapped package A depends on shrinkwrapped package B, B's
shrinkwrap will not be used as part of the installation of A\. However,
diff --git a/deps/npm/man/man1/npm-star.1 b/deps/npm/man/man1/npm-star.1
index 0cbc9ed2e75822..f776e22b75e9a2 100644
--- a/deps/npm/man/man1/npm-star.1
+++ b/deps/npm/man/man1/npm-star.1
@@ -1,4 +1,4 @@
-.TH "NPM\-STAR" "1" "June 2015" "" ""
+.TH "NPM\-STAR" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-star\fR \- Mark your favorite packages
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-stars.1 b/deps/npm/man/man1/npm-stars.1
index 88208b575eea81..070beaef6f5163 100644
--- a/deps/npm/man/man1/npm-stars.1
+++ b/deps/npm/man/man1/npm-stars.1
@@ -1,4 +1,4 @@
-.TH "NPM\-STARS" "1" "June 2015" "" ""
+.TH "NPM\-STARS" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-stars\fR \- View packages marked as favorites
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-start.1 b/deps/npm/man/man1/npm-start.1
index f8b70dacfb30de..ced564097ef3fc 100644
--- a/deps/npm/man/man1/npm-start.1
+++ b/deps/npm/man/man1/npm-start.1
@@ -1,4 +1,4 @@
-.TH "NPM\-START" "1" "June 2015" "" ""
+.TH "NPM\-START" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-start\fR \- Start a package
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-stop.1 b/deps/npm/man/man1/npm-stop.1
index b4d8084041461c..2a16fd59a99783 100644
--- a/deps/npm/man/man1/npm-stop.1
+++ b/deps/npm/man/man1/npm-stop.1
@@ -1,4 +1,4 @@
-.TH "NPM\-STOP" "1" "June 2015" "" ""
+.TH "NPM\-STOP" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-stop\fR \- Stop a package
.SH SYNOPSIS
diff --git a/deps/npm/man/man1/npm-submodule.1 b/deps/npm/man/man1/npm-submodule.1
deleted file mode 100644
index 771f0c0a2286a2..00000000000000
--- a/deps/npm/man/man1/npm-submodule.1
+++ /dev/null
@@ -1,41 +0,0 @@
-.\" Generated with Ronnjs 0.3.8
-.\" http://github.com/kapouer/ronnjs/
-.
-.TH "NPM\-SUBMODULE" "1" "September 2014" "" ""
-.
-.SH "NAME"
-\fBnpm-submodule\fR \-\- Add a package as a git submodule
-.
-.SH "SYNOPSIS"
-.
-.nf
-npm submodule
-.
-.fi
-.
-.SH "DESCRIPTION"
-If the specified package has a git repository url in its package\.json
-description, then this command will add it as a git submodule at \fBnode_modules/\fR\|\.
-.
-.P
-This is a convenience only\. From then on, it\'s up to you to manage
-updates by using the appropriate git commands\. npm will stubbornly
-refuse to update, modify, or remove anything with a \fB\|\.git\fR subfolder
-in it\.
-.
-.P
-This command also does not install missing dependencies, if the package
-does not include them in its git repository\. If \fBnpm ls\fR reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do \fBnpm explore \-\- npm install\fR to install the
-dependencies into the submodule folder\.
-.
-.SH "SEE ALSO"
-.
-.IP "\(bu" 4
-npm help 5 package\.json
-.
-.IP "\(bu" 4
-git help submodule
-.
-.IP "" 0
diff --git a/deps/npm/man/man1/npm-tag.1 b/deps/npm/man/man1/npm-tag.1
index c0336b2e636ccc..d20ef40888c635 100644
--- a/deps/npm/man/man1/npm-tag.1
+++ b/deps/npm/man/man1/npm-tag.1
@@ -1,4 +1,4 @@
-.TH "NPM\-TAG" "1" "June 2015" "" ""
+.TH "NPM\-TAG" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-tag\fR \- Tag a published version
.SH SYNOPSIS
@@ -13,7 +13,7 @@ npm tag @ []
THIS COMMAND IS DEPRECATED\. See npm help dist\-tag for details\.
.P
Tags the specified version of the package with the specified tag, or the
-\fB\-\-tag\fR config if not specified\.
+\fB\-\-tag\fP config if not specified\.
.P
A tag can be used when installing packages as a reference to a version instead
of using a specific version number:
@@ -32,13 +32,13 @@ npm install \-\-tag
.fi
.RE
.P
-This also applies to \fBnpm dedupe\fR\|\.
+This also applies to \fBnpm dedupe\fP\|\.
.P
Publishing a package always sets the "latest" tag to the published version\.
.SH PURPOSE
.P
Tags can be used to provide an alias instead of version numbers\. For
-example, \fBnpm\fR currently uses the tag "next" to identify the upcoming
+example, \fBnpm\fP currently uses the tag "next" to identify the upcoming
version, and the tag "latest" to identify the current version\.
.P
A project might choose to have multiple streams of development, e\.g\.,
@@ -46,16 +46,16 @@ A project might choose to have multiple streams of development, e\.g\.,
.SH CAVEATS
.P
Tags must share a namespace with version numbers, because they are
-specified in the same slot: \fBnpm install @\fR vs \fBnpm
-install @\fR\|\.
+specified in the same slot: \fBnpm install @\fP vs \fBnpm
+install @\fP\|\.
.P
Tags that can be interpreted as valid semver ranges will be
-rejected\. For example, \fBv1\.4\fR cannot be used as a tag, because it is
-interpreted by semver as \fB>=1\.4\.0 <1\.5\.0\fR\|\. See
+rejected\. For example, \fBv1\.4\fP cannot be used as a tag, because it is
+interpreted by semver as \fB>=1\.4\.0 <1\.5\.0\fP\|\. See
https://github\.com/npm/npm/issues/6082\|\.
.P
The simplest way to avoid semver problems with tags is to use tags
-that do not begin with a number or the letter \fBv\fR\|\.
+that do not begin with a number or the letter \fBv\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-test.1 b/deps/npm/man/man1/npm-test.1
index f5f409a64ababa..f6da31d6e065d6 100644
--- a/deps/npm/man/man1/npm-test.1
+++ b/deps/npm/man/man1/npm-test.1
@@ -1,4 +1,4 @@
-.TH "NPM\-TEST" "1" "June 2015" "" ""
+.TH "NPM\-TEST" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-test\fR \- Test a package
.SH SYNOPSIS
@@ -13,7 +13,7 @@
.P
This runs a package's "test" script, if one was provided\.
.P
-To run tests as a condition of installation, set the \fBnpat\fR config to
+To run tests as a condition of installation, set the \fBnpat\fP config to
true\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-uninstall.1 b/deps/npm/man/man1/npm-uninstall.1
index d59dcb14baaca1..42aabe0aee4b83 100644
--- a/deps/npm/man/man1/npm-uninstall.1
+++ b/deps/npm/man/man1/npm-uninstall.1
@@ -1,4 +1,4 @@
-.TH "NPM\-RM" "1" "June 2015" "" ""
+.TH "NPM\-RM" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-rm\fR \- Remove a package
.SH SYNOPSIS
@@ -22,22 +22,22 @@ npm uninstall sax
.fi
.RE
.P
-In global mode (ie, with \fB\-g\fR or \fB\-\-global\fR appended to the command),
+In global mode (ie, with \fB\-g\fP or \fB\-\-global\fP appended to the command),
it uninstalls the current package context as a global package\.
.P
-\fBnpm uninstall\fR takes 3 exclusive, optional flags which save or update
+\fBnpm uninstall\fP takes 3 exclusive, optional flags which save or update
the package version in your main package\.json:
.RS 0
.IP \(bu 2
-\fB\-\-save\fR: Package will be removed from your \fBdependencies\fR\|\.
+\fB\-\-save\fP: Package will be removed from your \fBdependencies\fP\|\.
.IP \(bu 2
-\fB\-\-save\-dev\fR: Package will be removed from your \fBdevDependencies\fR\|\.
+\fB\-\-save\-dev\fP: Package will be removed from your \fBdevDependencies\fP\|\.
.IP \(bu 2
-\fB\-\-save\-optional\fR: Package will be removed from your \fBoptionalDependencies\fR\|\.
+\fB\-\-save\-optional\fP: Package will be removed from your \fBoptionalDependencies\fP\|\.
.RE
.P
-Scope is optional and follows the usual rules for npm help 7 \fBnpm\-scope\fR\|\.
+Scope is optional and follows the usual rules for npm help 7 \fBnpm\-scope\fP\|\.
.P
Examples:
.P
diff --git a/deps/npm/man/man1/npm-unpublish.1 b/deps/npm/man/man1/npm-unpublish.1
index 8094933ab08440..d773cde0240172 100644
--- a/deps/npm/man/man1/npm-unpublish.1
+++ b/deps/npm/man/man1/npm-unpublish.1
@@ -1,4 +1,4 @@
-.TH "NPM\-UNPUBLISH" "1" "June 2015" "" ""
+.TH "NPM\-UNPUBLISH" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-unpublish\fR \- Remove a package from the registry
.SH SYNOPSIS
@@ -13,7 +13,7 @@ npm unpublish [@/][@]
\fBIt is generally considered bad behavior to remove versions of a library
that others are depending on!\fR
.P
-Consider using the \fBdeprecate\fR command
+Consider using the \fBdeprecate\fP command
instead, if your intent is to encourage users to upgrade\.
.P
There is plenty of room on the registry\.
@@ -29,7 +29,7 @@ Even if a package version is unpublished, that specific name and
version combination can never be reused\. In order to publish the
package again, a new version number must be used\.
.P
-The scope is optional and follows the usual rules for npm help 7 \fBnpm\-scope\fR\|\.
+The scope is optional and follows the usual rules for npm help 7 \fBnpm\-scope\fP\|\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm-update.1 b/deps/npm/man/man1/npm-update.1
index 7b548a6e13f951..5b41dce6bb84e5 100644
--- a/deps/npm/man/man1/npm-update.1
+++ b/deps/npm/man/man1/npm-update.1
@@ -1,4 +1,4 @@
-.TH "NPM\-UPDATE" "1" "June 2015" "" ""
+.TH "NPM\-UPDATE" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-update\fR \- Update a package
.SH SYNOPSIS
@@ -11,26 +11,26 @@ npm update [\-g] [ [ \.\.\.]]
.SH DESCRIPTION
.P
This command will update all the packages listed to the latest version
-(specified by the \fBtag\fR config), respecting semver\.
+(specified by the \fBtag\fP config), respecting semver\.
.P
It will also install missing packages\. As with all commands that install
-packages, the \fB\-\-dev\fR flag will cause \fBdevDependencies\fR to be processed
+packages, the \fB\-\-dev\fP flag will cause \fBdevDependencies\fP to be processed
as well\.
.P
-If the \fB\-g\fR flag is specified, this command will update globally installed
+If the \fB\-g\fP flag is specified, this command will update globally installed
packages\.
.P
If no package name is specified, all packages in the specified location (global
or local) will be updated\.
.P
-As of \fBnpm@2\.6\.1\fR, the \fBnpm update\fR will only inspect top\-level packages\.
-Prior versions of \fBnpm\fR would also recursively inspect all dependencies\.
-To get the old behavior, use \fBnpm \-\-depth 9999 update\fR, but be warned that
-simultaneous asynchronous update of all packages, including \fBnpm\fR itself
-and packages that \fBnpm\fR depends on, often causes problems up to and including
-the uninstallation of \fBnpm\fR itself\.
+As of \fBnpm@2\.6\.1\fP, the \fBnpm update\fP will only inspect top\-level packages\.
+Prior versions of \fBnpm\fP would also recursively inspect all dependencies\.
+To get the old behavior, use \fBnpm \-\-depth 9999 update\fP, but be warned that
+simultaneous asynchronous update of all packages, including \fBnpm\fP itself
+and packages that \fBnpm\fP depends on, often causes problems up to and including
+the uninstallation of \fBnpm\fP itself\.
.P
-To restore a missing \fBnpm\fR, use the command:
+To restore a missing \fBnpm\fP, use the command:
.P
.RS 2
.nf
@@ -39,12 +39,12 @@ curl \-L https://npmjs\.com/install\.sh | sh
.RE
.SH EXAMPLES
.P
-IMPORTANT VERSION NOTE: these examples assume \fBnpm@2\.6\.1\fR or later\. For
-older versions of \fBnpm\fR, you must specify \fB\-\-depth 0\fR to get the behavior
+IMPORTANT VERSION NOTE: these examples assume \fBnpm@2\.6\.1\fP or later\. For
+older versions of \fBnpm\fP, you must specify \fB\-\-depth 0\fP to get the behavior
described below\.
.P
-For the examples below, assume that the current package is \fBapp\fR and it depends
-on dependencies, \fBdep1\fR (\fBdep2\fR, \.\. etc\.)\. The published versions of \fBdep1\fR are:
+For the examples below, assume that the current package is \fBapp\fP and it depends
+on dependencies, \fBdep1\fP (\fBdep2\fP, \.\. etc\.)\. The published versions of \fBdep1\fP are:
.P
.RS 2
.nf
@@ -65,7 +65,7 @@ on dependencies, \fBdep1\fR (\fBdep2\fR, \.\. etc\.)\. The published versions o
.RE
.SS Caret Dependencies
.P
-If \fBapp\fR\|'s \fBpackage\.json\fR contains:
+If \fBapp\fP\|'s \fBpackage\.json\fP contains:
.P
.RS 2
.nf
@@ -75,11 +75,11 @@ dependencies: {
.fi
.RE
.P
-Then \fBnpm update\fR will install \fBdep1@1\.2\.2\fR, because \fB1\.2\.2\fR is \fBlatest\fR and
-\fB1\.2\.2\fR satisfies \fB^1\.1\.1\fR\|\.
+Then \fBnpm update\fP will install \fBdep1@1\.2\.2\fP, because \fB1\.2\.2\fP is \fBlatest\fP and
+\fB1\.2\.2\fP satisfies \fB^1\.1\.1\fP\|\.
.SS Tilde Dependencies
.P
-However, if \fBapp\fR\|'s \fBpackage\.json\fR contains:
+However, if \fBapp\fP\|'s \fBpackage\.json\fP contains:
.P
.RS 2
.nf
@@ -89,13 +89,13 @@ dependencies: {
.fi
.RE
.P
-In this case, running \fBnpm update\fR will install \fBdep1@1\.1\.2\fR\|\. Even though the \fBlatest\fR
-tag points to \fB1\.2\.2\fR, this version does not satisfy \fB~1\.1\.1\fR, which is equivalent
-to \fB>=1\.1\.1 <1\.2\.0\fR\|\. So the highest\-sorting version that satisfies \fB~1\.1\.1\fR is used,
-which is \fB1\.1\.2\fR\|\.
+In this case, running \fBnpm update\fP will install \fBdep1@1\.1\.2\fP\|\. Even though the \fBlatest\fP
+tag points to \fB1\.2\.2\fP, this version does not satisfy \fB~1\.1\.1\fP, which is equivalent
+to \fB>=1\.1\.1 <1\.2\.0\fP\|\. So the highest\-sorting version that satisfies \fB~1\.1\.1\fP is used,
+which is \fB1\.1\.2\fP\|\.
.SS Caret Dependencies below 1\.0\.0
.P
-Suppose \fBapp\fR has a caret dependency on a version below \fB1\.0\.0\fR, for example:
+Suppose \fBapp\fP has a caret dependency on a version below \fB1\.0\.0\fP, for example:
.P
.RS 2
.nf
@@ -105,10 +105,10 @@ dependencies: {
.fi
.RE
.P
-\fBnpm update\fR will install \fBdep1@0\.2\.0\fR, because there are no other
-versions which satisfy \fB^0\.2\.0\fR\|\.
+\fBnpm update\fP will install \fBdep1@0\.2\.0\fP, because there are no other
+versions which satisfy \fB^0\.2\.0\fP\|\.
.P
-If the dependence were on \fB^0\.4\.0\fR:
+If the dependence were on \fB^0\.4\.0\fP:
.P
.RS 2
.nf
@@ -118,13 +118,13 @@ dependencies: {
.fi
.RE
.P
-Then \fBnpm update\fR will install \fBdep1@0\.4\.1\fR, because that is the highest\-sorting
-version that satisfies \fB^0\.4\.0\fR (\fB>= 0\.4\.0 <0\.5\.0\fR)
-.SS Recording Updates with \fB\-\-save\fR
+Then \fBnpm update\fP will install \fBdep1@0\.4\.1\fP, because that is the highest\-sorting
+version that satisfies \fB^0\.4\.0\fP (\fB>= 0\.4\.0 <0\.5\.0\fP)
+.SS Recording Updates with \fB\-\-save\fP
.P
When you want to update a package and save the new version as
-the minimum required dependency in \fBpackage\.json\fR, you can use
-\fBnpm update \-\-save\fR\|\. For example if \fBpackage\.json\fR contains
+the minimum required dependency in \fBpackage\.json\fP, you can use
+\fBnpm update \-\-save\fP\|\. For example if \fBpackage\.json\fP contains
.P
.RS 2
.nf
@@ -134,8 +134,8 @@ dependencies: {
.fi
.RE
.P
-Then \fBnpm update \-\-save\fR will install \fBdep1@1\.2\.2\fR (i\.e\., \fBlatest\fR),
-and \fBpackage\.json\fR will be modified:
+Then \fBnpm update \-\-save\fP will install \fBdep1@1\.2\.2\fP (i\.e\., \fBlatest\fP),
+and \fBpackage\.json\fP will be modified:
.P
.RS 2
.nf
@@ -145,15 +145,15 @@ dependencies: {
.fi
.RE
.P
-Note that \fBnpm\fR will only write an updated version to \fBpackage\.json\fR
+Note that \fBnpm\fP will only write an updated version to \fBpackage\.json\fP
if it installs a new package\.
.SS Updating Globally\-Installed Packages
.P
-\fBnpm update \-g\fR will apply the \fBupdate\fR action to each globally\- installed
-package that is \fBoutdated\fR \-\- that is, has a version that is different from
-\fBlatest\fR\|\.
+\fBnpm update \-g\fP will apply the \fBupdate\fP action to each globally\- installed
+package that is \fBoutdated\fP \-\- that is, has a version that is different from
+\fBlatest\fP\|\.
.P
-NOTE: If a package has been upgraded to a version newer than \fBlatest\fR, it will
+NOTE: If a package has been upgraded to a version newer than \fBlatest\fP, it will
be \fIdowngraded\fR\|\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man1/npm-version.1 b/deps/npm/man/man1/npm-version.1
index 6c9444ff7788ee..1cfe826186b675 100644
--- a/deps/npm/man/man1/npm-version.1
+++ b/deps/npm/man/man1/npm-version.1
@@ -1,4 +1,4 @@
-.TH "NPM\-VERSION" "1" "June 2015" "" ""
+.TH "NPM\-VERSION" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-version\fR \- Bump a package version
.SH SYNOPSIS
@@ -11,21 +11,22 @@ npm version [ | major | minor | patch | premajor | preminor | prepat
.SH DESCRIPTION
.P
Run this in a package directory to bump the version and write the new
-data back to \fBpackage\.json\fR and, if present, \fBnpm\-shrinkwrap\.json\fR\|\.
+data back to \fBpackage\.json\fP and, if present, \fBnpm\-shrinkwrap\.json\fP\|\.
.P
-The \fBnewversion\fR argument should be a valid semver string, \fIor\fR a
-valid second argument to semver\.inc (one of "patch", "minor", "major",
-"prepatch", "preminor", "premajor", "prerelease")\. In the second case,
+The \fBnewversion\fP argument should be a valid semver string, \fIor\fR a
+valid second argument to semver\.inc (one of \fBpatch\fP, \fBminor\fP, \fBmajor\fP,
+\fBprepatch\fP, \fBpreminor\fP, \fBpremajor\fP, \fBprerelease\fP)\. In the second case,
the existing version will be incremented by 1 in the specified field\.
.P
-If run in a git repo, it will also create a version commit and tag, and fail if
-the repo is not clean\. This behavior is controlled by \fBgit\-tag\-version\fR (see
-below), and can be disabled on the command line by running \fBnpm
-\-\-no\-git\-tag\-version version\fR
+If run in a git repo, it will also create a version commit and tag\.
+This behavior is controlled by \fBgit\-tag\-version\fP (see below), and can
+be disabled on the command line by running \fBnpm \-\-no\-git\-tag\-version version\fP\|\.
+It will fail if the working directory is not clean, unless the \fB\-\-force\fP
+flag is set\.
.P
-If supplied with \fB\-\-message\fR (shorthand: \fB\-m\fR) config option, npm will
+If supplied with \fB\-\-message\fP (shorthand: \fB\-m\fP) config option, npm will
use it as a commit message when creating a version commit\. If the
-\fBmessage\fR config contains \fB%s\fR then that will be replaced with the
+\fBmessage\fP config contains \fB%s\fP then that will be replaced with the
resulting version number\. For example:
.P
.RS 2
@@ -34,8 +35,8 @@ npm version patch \-m "Upgrade to %s for reasons"
.fi
.RE
.P
-If the \fBsign\-git\-tag\fR config is set, then the tag will be signed using
-the \fB\-s\fR flag to git\. Note that you must have a default GPG key set up
+If the \fBsign\-git\-tag\fP config is set, then the tag will be signed using
+the \fB\-s\fP flag to git\. Note that you must have a default GPG key set up
in your git config for this to work properly\. For example:
.P
.RS 2
@@ -51,17 +52,48 @@ Enter passphrase:
.fi
.RE
.P
-If "preversion", "version", "postversion" in the "scripts" property of
-the package\.json, it will execute by running \fBnpm version\fR\|\. preversion
-and version ware executed before bump the package version, postversion
-was executed after bump the package version\. For example to run \fBnpm version\fR
-after passed all test:
+If \fBpreversion\fP, \fBversion\fP, or \fBpostversion\fP are in the \fBscripts\fP property of
+the package\.json, they will be executed as part of running \fBnpm version\fP\|\.
+.P
+The exact order of execution is as follows:
+.RS 0
+.IP 1. 3
+Check to make sure the git working directory is clean before we get started\.
+Your scripts may add files to the commit in future steps\.
+This step is skipped if the \fB\-\-force\fP flag is set\.
+.IP 2. 3
+Run the \fBpreversion\fP script\. These scripts have access to the old \fBversion\fP in package\.json\.
+A typical use would be running your full test suite before deploying\.
+Any files you want added to the commit should be explicitly added using \fBgit add\fP\|\.
+.IP 3. 3
+Bump \fBversion\fP in \fBpackage\.json\fP as requested (\fBpatch\fP, \fBminor\fP, \fBmajor\fP, etc)\.
+.IP 4. 3
+Run the \fBversion\fP script\. These scripts have access to the new \fBversion\fP in package\.json
+(so they can incorporate it into file headers in generated files for example)\.
+Again, scripts should explicitly add generated files to the commit using \fBgit add\fP\|\.
+.IP 5. 3
+Commit and tag\.
+.IP 6. 3
+Run the \fBpostversion\fP script\. Use it to clean up the file system or automatically push
+the commit and/or tag\.
+
+.RE
+.P
+Take the following example:
.P
.RS 2
.nf
-"scripts": { "preversion": "npm test" }
+"scripts": {
+ "preversion": "npm test",
+ "version": "npm run build && git add \-A dist",
+ "postversion": "git push && git push \-\-tags && rm \-rf build/temp"
+}
.fi
.RE
+.P
+This runs all your tests, and proceeds only if they pass\. Then runs your \fBbuild\fP script, and
+adds everything in the \fBdist\fP directory to the commit\. After the commit, it pushes the new commit
+and tag up to the server, and deletes the \fBbuild/temp\fP directory\.
.SH CONFIGURATION
.SS git\-tag\-version
.RS 0
diff --git a/deps/npm/man/man1/npm-view.1 b/deps/npm/man/man1/npm-view.1
index 8960067d00dbda..ef5daf4b58d940 100644
--- a/deps/npm/man/man1/npm-view.1
+++ b/deps/npm/man/man1/npm-view.1
@@ -1,4 +1,4 @@
-.TH "NPM\-VIEW" "1" "June 2015" "" ""
+.TH "NPM\-VIEW" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-view\fR \- View registry info
.SH SYNOPSIS
@@ -12,9 +12,9 @@ npm v [@/][@] [[\.]\.\.\.]
.SH DESCRIPTION
.P
This command shows data about a package and prints it to the stream
-referenced by the \fBoutfd\fR config, which defaults to stdout\.
+referenced by the \fBoutfd\fP config, which defaults to stdout\.
.P
-To show the package registry entry for the \fBconnect\fR package, you can do
+To show the package registry entry for the \fBconnect\fP package, you can do
this:
.P
.RS 2
@@ -26,7 +26,7 @@ npm view connect
The default version is "latest" if unspecified\.
.P
Field names can be specified after the package descriptor\.
-For example, to show the dependencies of the \fBronn\fR package at version
+For example, to show the dependencies of the \fBronn\fP package at version
0\.3\.5, you could do the following:
.P
.RS 2
@@ -87,7 +87,7 @@ npm view express contributors\.name contributors\.email
.P
"Person" fields are shown as a string if they would be shown as an
object\. So, for example, this will show the list of npm contributors in
-the shortened string format\. (See npm help 5 \fBpackage\.json\fR for more on this\.)
+the shortened string format\. (See npm help 5 \fBpackage\.json\fP for more on this\.)
.P
.RS 2
.nf
diff --git a/deps/npm/man/man1/npm-whoami.1 b/deps/npm/man/man1/npm-whoami.1
index 812bbf87a7d04c..a8ab8dc749d86a 100644
--- a/deps/npm/man/man1/npm-whoami.1
+++ b/deps/npm/man/man1/npm-whoami.1
@@ -1,4 +1,4 @@
-.TH "NPM\-WHOAMI" "1" "June 2015" "" ""
+.TH "NPM\-WHOAMI" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm-whoami\fR \- Display npm username
.SH SYNOPSIS
@@ -10,7 +10,7 @@ npm whoami
.RE
.SH DESCRIPTION
.P
-Print the \fBusername\fR config to standard output\.
+Print the \fBusername\fP config to standard output\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man1/npm.1 b/deps/npm/man/man1/npm.1
index b38102a3f9bb0c..69f64f16f8b2c9 100644
--- a/deps/npm/man/man1/npm.1
+++ b/deps/npm/man/man1/npm.1
@@ -1,4 +1,4 @@
-.TH "NPM" "1" "June 2015" "" ""
+.TH "NPM" "1" "August 2015" "" ""
.SH "NAME"
\fBnpm\fR \- javascript package manager
.SH SYNOPSIS
@@ -10,7 +10,7 @@ npm [args]
.RE
.SH VERSION
.P
-2.11.3
+2.13.4
.SH DESCRIPTION
.P
npm is the package manager for the Node JavaScript platform\. It puts
@@ -21,16 +21,16 @@ It is extremely configurable to support a wide variety of use cases\.
Most commonly, it is used to publish, discover, install, and develop node
programs\.
.P
-Run \fBnpm help\fR to get a list of available commands\.
+Run \fBnpm help\fP to get a list of available commands\.
.SH INTRODUCTION
.P
You probably got npm because you want to install stuff\.
.P
-Use \fBnpm install blerg\fR to install the latest version of "blerg"\. Check out
-npm help \fBnpm\-install\fR for more info\. It can do a lot of stuff\.
+Use \fBnpm install blerg\fP to install the latest version of "blerg"\. Check out
+npm help \fBnpm\-install\fP for more info\. It can do a lot of stuff\.
.P
-Use the \fBnpm search\fR command to show everything that's available\.
-Use \fBnpm ls\fR to show everything you've installed\.
+Use the \fBnpm search\fP command to show everything that's available\.
+Use \fBnpm ls\fP to show everything you've installed\.
.SH DEPENDENCIES
.P
If a package references to another package with a git URL, npm depends
@@ -48,7 +48,7 @@ the node\-gyp repository \fIhttps://github\.com/TooTallNate/node\-gyp\fR and
the node\-gyp Wiki \fIhttps://github\.com/TooTallNate/node\-gyp/wiki\fR\|\.
.SH DIRECTORIES
.P
-See npm help 5 \fBnpm\-folders\fR to learn about where npm puts stuff\.
+See npm help 5 \fBnpm\-folders\fP to learn about where npm puts stuff\.
.P
In particular, npm has two modes of operation:
.RS 0
@@ -56,17 +56,17 @@ In particular, npm has two modes of operation:
global mode:
.br
npm installs packages into the install prefix at
-\fBprefix/lib/node_modules\fR and bins are installed in \fBprefix/bin\fR\|\.
+\fBprefix/lib/node_modules\fP and bins are installed in \fBprefix/bin\fP\|\.
.IP \(bu 2
local mode:
.br
npm installs packages into the current project directory, which
defaults to the current working directory\. Packages are installed to
-\fB\|\./node_modules\fR, and bins are installed to \fB\|\./node_modules/\.bin\fR\|\.
+\fB\|\./node_modules\fP, and bins are installed to \fB\|\./node_modules/\.bin\fP\|\.
.RE
.P
-Local mode is the default\. Use \fB\-\-global\fR or \fB\-g\fR on any command to
+Local mode is the default\. Use \fB\-\-global\fP or \fB\-g\fP on any command to
operate in global mode instead\.
.SH DEVELOPER USAGE
.P
@@ -75,24 +75,24 @@ following help topics:
.RS 0
.IP \(bu 2
json:
-Make a package\.json file\. See npm help 5 \fBpackage\.json\fR\|\.
+Make a package\.json file\. See npm help 5 \fBpackage\.json\fP\|\.
.IP \(bu 2
link:
For linking your current working code into Node's path, so that you
don't have to reinstall every time you make a change\. Use
-\fBnpm link\fR to do this\.
+\fBnpm link\fP to do this\.
.IP \(bu 2
install:
It's a good idea to install things if you don't need the symbolic link\.
Especially, installing other peoples code from the registry is done via
-\fBnpm install\fR
+\fBnpm install\fP
.IP \(bu 2
adduser:
Create an account or log in\. Credentials are stored in the
user config file\.
.IP \(bu 2
publish:
-Use the \fBnpm publish\fR command to upload your code to the registry\.
+Use the \fBnpm publish\fP command to upload your code to the registry\.
.RE
.SH CONFIGURATION
@@ -103,27 +103,27 @@ npm is extremely configurable\. It reads its configuration options from
.IP \(bu 2
Command line switches:
.br
-Set a config with \fB\-\-key val\fR\|\. All keys take a value, even if they
+Set a config with \fB\-\-key val\fP\|\. All keys take a value, even if they
are booleans (the config parser doesn't know what the options are at
the time of parsing\.) If no value is provided, then the option is set
-to boolean \fBtrue\fR\|\.
+to boolean \fBtrue\fP\|\.
.IP \(bu 2
Environment Variables:
.br
Set any config by prefixing the name in an environment variable with
-\fBnpm_config_\fR\|\. For example, \fBexport npm_config_key=val\fR\|\.
+\fBnpm_config_\fP\|\. For example, \fBexport npm_config_key=val\fP\|\.
.IP \(bu 2
User Configs:
.br
The file at $HOME/\.npmrc is an ini\-formatted list of configs\. If
-present, it is parsed\. If the \fBuserconfig\fR option is set in the cli
+present, it is parsed\. If the \fBuserconfig\fP option is set in the cli
or env, then that will be used instead\.
.IP \(bu 2
Global Configs:
.br
The file found at \.\./etc/npmrc (from the node executable, by default
this resolves to /usr/local/etc/npmrc) will be parsed if it is found\.
-If the \fBglobalconfig\fR option is set in the cli, env, or user config,
+If the \fBglobalconfig\fP option is set in the cli, env, or user config,
then that file is parsed instead\.
.IP \(bu 2
Defaults:
@@ -133,14 +133,14 @@ lib/utils/config\-defs\.js\. These must not be changed\.
.RE
.P
-See npm help 7 \fBnpm\-config\fR for much much more information\.
+See npm help 7 \fBnpm\-config\fP for much much more information\.
.SH CONTRIBUTIONS
.P
Patches welcome!
.RS 0
.IP \(bu 2
code:
-Read through npm help 7 \fBnpm\-coding\-style\fR if you plan to submit code\.
+Read through npm help 7 \fBnpm\-coding\-style\fP if you plan to submit code\.
You don't have to agree with it, but you do have to follow it\.
.IP \(bu 2
docs:
@@ -149,8 +149,8 @@ file in the "doc" folder\. (Don't worry about generating the man page\.)
.RE
.P
-Contributors are listed in npm's \fBpackage\.json\fR file\. You can view them
-easily by doing \fBnpm view npm contributors\fR\|\.
+Contributors are listed in npm's \fBpackage\.json\fP file\. You can view them
+easily by doing \fBnpm view npm contributors\fP\|\.
.P
If you would like to contribute, but don't know what to work on, check
the issues list or ask on the mailing list\.
@@ -175,7 +175,7 @@ npm\-@googlegroups\.com
.RE
.P
Be sure to include \fIall\fR of the output from the npm command that didn't work
-as expected\. The \fBnpm\-debug\.log\fR file is also helpful to provide\.
+as expected\. The \fBnpm\-debug\.log\fP file is also helpful to provide\.
.P
You can also look for isaacs in #node\.js on irc://irc\.freenode\.net\. He
will no doubt tell you to put the output in a gist or email\.
diff --git a/deps/npm/man/man3/npm-bin.3 b/deps/npm/man/man3/npm-bin.3
index 12f03b262ac59c..bfb93455d8a789 100644
--- a/deps/npm/man/man3/npm-bin.3
+++ b/deps/npm/man/man3/npm-bin.3
@@ -1,4 +1,4 @@
-.TH "NPM\-BIN" "3" "June 2015" "" ""
+.TH "NPM\-BIN" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-bin\fR \- Display npm bin folder
.SH SYNOPSIS
@@ -13,5 +13,5 @@ npm\.commands\.bin(args, cb)
Print the folder where npm will install executables\.
.P
This function should not be used programmatically\. Instead, just refer
-to the \fBnpm\.bin\fR property\.
+to the \fBnpm\.bin\fP property\.
diff --git a/deps/npm/man/man3/npm-bugs.3 b/deps/npm/man/man3/npm-bugs.3
index f04fdf2afa1724..2740034a58c71b 100644
--- a/deps/npm/man/man3/npm-bugs.3
+++ b/deps/npm/man/man3/npm-bugs.3
@@ -1,4 +1,4 @@
-.TH "NPM\-BUGS" "3" "June 2015" "" ""
+.TH "NPM\-BUGS" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-bugs\fR \- Bugs for a package in a web browser maybe
.SH SYNOPSIS
@@ -11,7 +11,7 @@ npm\.commands\.bugs(package, callback)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-bug tracker URL, and then tries to open it using the \fB\-\-browser\fR
+bug tracker URL, and then tries to open it using the \fB\-\-browser\fP
config param\.
.P
Like other commands, the first parameter is an array\. This command only
diff --git a/deps/npm/man/man3/npm-cache.3 b/deps/npm/man/man3/npm-cache.3
index bcfb6138b5b476..50a6b7a38c0e82 100644
--- a/deps/npm/man/man3/npm-cache.3
+++ b/deps/npm/man/man3/npm-cache.3
@@ -1,4 +1,4 @@
-.TH "NPM\-CACHE" "3" "June 2015" "" ""
+.TH "NPM\-CACHE" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-cache\fR \- manage the npm cache programmatically
.SH SYNOPSIS
@@ -21,8 +21,8 @@ functionality\.
The callback is called with the package\.json data of the thing that is
eventually added to or read from the cache\.
.P
-The top level \fBnpm\.commands\.cache(\.\.\.)\fR functionality is a public
-interface, and like all commands on the \fBnpm\.commands\fR object, it will
+The top level \fBnpm\.commands\.cache(\.\.\.)\fP functionality is a public
+interface, and like all commands on the \fBnpm\.commands\fP object, it will
match the command line behavior exactly\.
.P
However, the cache folder structure and the cache helper functions are
diff --git a/deps/npm/man/man3/npm-commands.3 b/deps/npm/man/man3/npm-commands.3
index 0dca71c8c781aa..03d0dc40bd190d 100644
--- a/deps/npm/man/man3/npm-commands.3
+++ b/deps/npm/man/man3/npm-commands.3
@@ -1,4 +1,4 @@
-.TH "NPM\-COMMANDS" "3" "June 2015" "" ""
+.TH "NPM\-COMMANDS" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-commands\fR \- npm commands
.SH SYNOPSIS
@@ -17,8 +17,8 @@ In general, all commands on the command object take an \fBarray\fR of positional
argument \fBstrings\fR\|\. The last argument to any function is a callback\. Some
commands are special and take other optional arguments\.
.P
-All commands have their own man page\. See \fBman npm\-\fR for command\-line
-usage, or \fBman 3 npm\-\fR for programmatic usage\.
+All commands have their own man page\. See \fBman npm\-\fP for command\-line
+usage, or \fBman 3 npm\-\fP for programmatic usage\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man3/npm-config.3 b/deps/npm/man/man3/npm-config.3
index 0c92c3a2819151..d2e57c26b57509 100644
--- a/deps/npm/man/man3/npm-config.3
+++ b/deps/npm/man/man3/npm-config.3
@@ -1,4 +1,4 @@
-.TH "NPM\-CONFIG" "3" "June 2015" "" ""
+.TH "NPM\-CONFIG" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-config\fR \- Manage the npm configuration files
.SH SYNOPSIS
@@ -16,29 +16,29 @@ This function acts much the same way as the command\-line version\. The first
element in the array tells config what to do\. Possible values are:
.RS 0
.IP \(bu 2
-\fBset\fR
- Sets a config parameter\. The second element in \fBargs\fR is interpreted as the
+\fBset\fP
+ Sets a config parameter\. The second element in \fBargs\fP is interpreted as the
key, and the third element is interpreted as the value\.
.IP \(bu 2
-\fBget\fR
- Gets the value of a config parameter\. The second element in \fBargs\fR is the
+\fBget\fP
+ Gets the value of a config parameter\. The second element in \fBargs\fP is the
key to get the value of\.
.IP \(bu 2
-\fBdelete\fR (\fBrm\fR or \fBdel\fR)
- Deletes a parameter from the config\. The second element in \fBargs\fR is the
+\fBdelete\fP (\fBrm\fP or \fBdel\fP)
+ Deletes a parameter from the config\. The second element in \fBargs\fP is the
key to delete\.
.IP \(bu 2
-\fBlist\fR (\fBls\fR)
+\fBlist\fP (\fBls\fP)
Show all configs that aren't secret\. No parameters necessary\.
.IP \(bu 2
-\fBedit\fR:
+\fBedit\fP:
Opens the config file in the default editor\. This command isn't very useful
programmatically, but it is made available\.
.RE
.P
To programmatically access npm configuration settings, or set them for
-the duration of a program, use the \fBnpm\.config\.set\fR and \fBnpm\.config\.get\fR
+the duration of a program, use the \fBnpm\.config\.set\fP and \fBnpm\.config\.get\fP
functions instead\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man3/npm-deprecate.3 b/deps/npm/man/man3/npm-deprecate.3
index 54237fce684c54..f0e35ab9d33fe2 100644
--- a/deps/npm/man/man3/npm-deprecate.3
+++ b/deps/npm/man/man3/npm-deprecate.3
@@ -1,4 +1,4 @@
-.TH "NPM\-DEPRECATE" "3" "June 2015" "" ""
+.TH "NPM\-DEPRECATE" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-deprecate\fR \- Deprecate a version of a package
.SH SYNOPSIS
@@ -16,20 +16,20 @@ a deprecation warning to all who attempt to install it\.
The 'args' parameter must have exactly two elements:
.RS 0
.IP \(bu 2
-\fBpackage[@version]\fR
- The \fBversion\fR portion is optional, and may be either a range, or a
+\fBpackage[@version]\fP
+ The \fBversion\fP portion is optional, and may be either a range, or a
specific version, or a tag\.
.IP \(bu 2
-\fBmessage\fR
+\fBmessage\fP
The warning message that will be printed whenever a user attempts to
install the package\.
.RE
.P
Note that you must be the package owner to deprecate something\. See the
-\fBowner\fR and \fBadduser\fR help topics\.
+\fBowner\fP and \fBadduser\fP help topics\.
.P
-To un\-deprecate a package, specify an empty string (\fB""\fR) for the \fBmessage\fR argument\.
+To un\-deprecate a package, specify an empty string (\fB""\fP) for the \fBmessage\fP argument\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man3/npm-docs.3 b/deps/npm/man/man3/npm-docs.3
index e23f1dcad33fa8..4305dae16399f2 100644
--- a/deps/npm/man/man3/npm-docs.3
+++ b/deps/npm/man/man3/npm-docs.3
@@ -1,4 +1,4 @@
-.TH "NPM\-DOCS" "3" "June 2015" "" ""
+.TH "NPM\-DOCS" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-docs\fR \- Docs for a package in a web browser maybe
.SH SYNOPSIS
@@ -11,7 +11,7 @@ npm\.commands\.docs(package, callback)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-documentation URL, and then tries to open it using the \fB\-\-browser\fR
+documentation URL, and then tries to open it using the \fB\-\-browser\fP
config param\.
.P
Like other commands, the first parameter is an array\. This command only
diff --git a/deps/npm/man/man3/npm-edit.3 b/deps/npm/man/man3/npm-edit.3
index ceb99ec01f674d..27ccd879fac3ef 100644
--- a/deps/npm/man/man3/npm-edit.3
+++ b/deps/npm/man/man3/npm-edit.3
@@ -1,4 +1,4 @@
-.TH "NPM\-EDIT" "3" "June 2015" "" ""
+.TH "NPM\-EDIT" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-edit\fR \- Edit an installed package
.SH SYNOPSIS
@@ -11,13 +11,13 @@ npm\.commands\.edit(package, callback)
.SH DESCRIPTION
.P
Opens the package folder in the default editor (or whatever you've
-configured as the npm \fBeditor\fR config \-\- see \fBnpm help config\fR\|\.)
+configured as the npm \fBeditor\fP config \-\- see \fBnpm help config\fP\|\.)
.P
After it has been edited, the package is rebuilt so as to pick up any
changes in compiled packages\.
.P
-For instance, you can do \fBnpm install connect\fR to install connect
-into your package, and then \fBnpm\.commands\.edit(["connect"], callback)\fR
+For instance, you can do \fBnpm install connect\fP to install connect
+into your package, and then \fBnpm\.commands\.edit(["connect"], callback)\fP
to make a few changes to your locally installed copy\.
.P
The first parameter is a string array with a single element, the package
diff --git a/deps/npm/man/man3/npm-explore.3 b/deps/npm/man/man3/npm-explore.3
index d9887378d2d354..9fb6e008aad2bc 100644
--- a/deps/npm/man/man3/npm-explore.3
+++ b/deps/npm/man/man3/npm-explore.3
@@ -1,4 +1,4 @@
-.TH "NPM\-EXPLORE" "3" "June 2015" "" ""
+.TH "NPM\-EXPLORE" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-explore\fR \- Browse an installed package
.SH SYNOPSIS
@@ -16,7 +16,7 @@ If a command is specified, then it is run in the subshell, which then
immediately terminates\.
.P
Note that the package is \fInot\fR automatically rebuilt afterwards, so be
-sure to use \fBnpm rebuild \fR if you make any changes\.
+sure to use \fBnpm rebuild \fP if you make any changes\.
.P
The first element in the 'args' parameter must be a package name\. After that is the optional command, which can be any number of strings\. All of the strings will be combined into one, space\-delimited command\.
diff --git a/deps/npm/man/man3/npm-help-search.3 b/deps/npm/man/man3/npm-help-search.3
index ae547a5295979c..243e5d2a28dcb7 100644
--- a/deps/npm/man/man3/npm-help-search.3
+++ b/deps/npm/man/man3/npm-help-search.3
@@ -1,4 +1,4 @@
-.TH "NPM\-HELP\-SEARCH" "3" "June 2015" "" ""
+.TH "NPM\-HELP\-SEARCH" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-help-search\fR \- Search the help pages
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-init.3 b/deps/npm/man/man3/npm-init.3
index 325e217281b9ef..947398d7a864d9 100644
--- a/deps/npm/man/man3/npm-init.3
+++ b/deps/npm/man/man3/npm-init.3
@@ -1,4 +1,4 @@
-.TH "NPM" "" "June 2015" "" ""
+.TH "NPM" "" "August 2015" "" ""
.SH "NAME"
\fBnpm\fR
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-install.3 b/deps/npm/man/man3/npm-install.3
index 1d9497e3949dd1..d2951dd0d45f74 100644
--- a/deps/npm/man/man3/npm-install.3
+++ b/deps/npm/man/man3/npm-install.3
@@ -1,4 +1,4 @@
-.TH "NPM\-INSTALL" "3" "June 2015" "" ""
+.TH "NPM\-INSTALL" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-install\fR \- install a package programmatically
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-link.3 b/deps/npm/man/man3/npm-link.3
index ab67f3933363ac..5877e03fbe8fb7 100644
--- a/deps/npm/man/man3/npm-link.3
+++ b/deps/npm/man/man3/npm-link.3
@@ -1,4 +1,4 @@
-.TH "NPM\-LINK" "3" "June 2015" "" ""
+.TH "NPM\-LINK" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-link\fR \- Symlink a package folder
.SH SYNOPSIS
@@ -14,12 +14,12 @@ npm\.commands\.link(packages, callback)
Package linking is a two\-step process\.
.P
Without parameters, link will create a globally\-installed
-symbolic link from \fBprefix/package\-name\fR to the current folder\.
+symbolic link from \fBprefix/package\-name\fP to the current folder\.
.P
-With a parameters, link will create a symlink from the local \fBnode_modules\fR
+With a parameters, link will create a symlink from the local \fBnode_modules\fP
folder to the global symlink\.
.P
-When creating tarballs for \fBnpm publish\fR, the linked packages are
+When creating tarballs for \fBnpm publish\fP, the linked packages are
"snapshotted" to their current state by resolving the symbolic links\.
.P
This is
diff --git a/deps/npm/man/man3/npm-load.3 b/deps/npm/man/man3/npm-load.3
index dd92ce6846af8a..ce409b6a5f66aa 100644
--- a/deps/npm/man/man3/npm-load.3
+++ b/deps/npm/man/man3/npm-load.3
@@ -1,4 +1,4 @@
-.TH "NPM\-LOAD" "3" "June 2015" "" ""
+.TH "NPM\-LOAD" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-load\fR \- Load config settings
.SH SYNOPSIS
@@ -30,5 +30,5 @@ For example, to emulate the \-\-dev flag, pass an object that looks like this:
.fi
.RE
.P
-For a list of all the available command\-line configs, see \fBnpm help config\fR
+For a list of all the available command\-line configs, see \fBnpm help config\fP
diff --git a/deps/npm/man/man3/npm-ls.3 b/deps/npm/man/man3/npm-ls.3
index 82d3dbd948c49a..4fc976f2ede0f3 100644
--- a/deps/npm/man/man3/npm-ls.3
+++ b/deps/npm/man/man3/npm-ls.3
@@ -1,4 +1,4 @@
-.TH "NPM\-LS" "3" "June 2015" "" ""
+.TH "NPM\-LS" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-ls\fR \- List installed packages
.SH SYNOPSIS
@@ -17,7 +17,7 @@ return that data using the callback\.
This command does not take any arguments, but args must be defined\.
Beyond that, if any arguments are passed in, npm will politely warn that it
does not take positional arguments, though you may set config flags
-like with any other command, such as \fBglobal\fR to list global packages\.
+like with any other command, such as \fBglobal\fP to list global packages\.
.P
It will print out extraneous, missing, and invalid packages\.
.P
diff --git a/deps/npm/man/man3/npm-outdated.3 b/deps/npm/man/man3/npm-outdated.3
index 01cdf0c6800cfb..f2fd1f73b70f41 100644
--- a/deps/npm/man/man3/npm-outdated.3
+++ b/deps/npm/man/man3/npm-outdated.3
@@ -1,4 +1,4 @@
-.TH "NPM\-OUTDATED" "3" "June 2015" "" ""
+.TH "NPM\-OUTDATED" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-outdated\fR \- Check for outdated packages
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-owner.3 b/deps/npm/man/man3/npm-owner.3
index 5a82efdae61e1c..16e2c54019676b 100644
--- a/deps/npm/man/man3/npm-owner.3
+++ b/deps/npm/man/man3/npm-owner.3
@@ -1,4 +1,4 @@
-.TH "NPM\-OWNER" "3" "June 2015" "" ""
+.TH "NPM\-OWNER" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-owner\fR \- Manage package owners
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-pack.3 b/deps/npm/man/man3/npm-pack.3
index f1d65b2d3c03a8..037ec3c3467b55 100644
--- a/deps/npm/man/man3/npm-pack.3
+++ b/deps/npm/man/man3/npm-pack.3
@@ -1,4 +1,4 @@
-.TH "NPM\-PACK" "3" "June 2015" "" ""
+.TH "NPM\-PACK" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-pack\fR \- Create a tarball from a package
.SH SYNOPSIS
@@ -13,7 +13,7 @@ npm\.commands\.pack([packages,] callback)
For anything that's installable (that is, a package folder, tarball,
tarball url, name@tag, name@version, or name), this command will fetch
it to the cache, and then copy the tarball to the current working
-directory as \fB\-\.tgz\fR, and then write the filenames out to
+directory as \fB\-\.tgz\fP, and then write the filenames out to
stdout\.
.P
If the same package is specified multiple times, then the file will be
diff --git a/deps/npm/man/man3/npm-ping.3 b/deps/npm/man/man3/npm-ping.3
new file mode 100644
index 00000000000000..607fc8423e8da3
--- /dev/null
+++ b/deps/npm/man/man3/npm-ping.3
@@ -0,0 +1,17 @@
+.TH "NPM\-PING" "3" "August 2015" "" ""
+.SH "NAME"
+\fBnpm-ping\fR \- Ping npm registry
+.SH SYNOPSIS
+.P
+.RS 2
+.nf
+npm\.registry\.ping(registry, options, function (er, pong))
+.fi
+.RE
+.SH DESCRIPTION
+.P
+Attempts to connect to the given registry, returning a \fBpong\fP
+object with various metadata if it succeeds\.
+.P
+This function is primarily useful for debugging connection issues
+to npm registries\.
diff --git a/deps/npm/man/man3/npm-prefix.3 b/deps/npm/man/man3/npm-prefix.3
index 9bf285db13bab9..5ca38b5ec214ff 100644
--- a/deps/npm/man/man3/npm-prefix.3
+++ b/deps/npm/man/man3/npm-prefix.3
@@ -1,4 +1,4 @@
-.TH "NPM\-PREFIX" "3" "June 2015" "" ""
+.TH "NPM\-PREFIX" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-prefix\fR \- Display prefix
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-prune.3 b/deps/npm/man/man3/npm-prune.3
index 4ea94640047e04..4bf3f28039ce39 100644
--- a/deps/npm/man/man3/npm-prune.3
+++ b/deps/npm/man/man3/npm-prune.3
@@ -1,4 +1,4 @@
-.TH "NPM\-PRUNE" "3" "June 2015" "" ""
+.TH "NPM\-PRUNE" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-prune\fR \- Remove extraneous packages
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-publish.3 b/deps/npm/man/man3/npm-publish.3
index fe3ce639c1d653..4a303370b0ed84 100644
--- a/deps/npm/man/man3/npm-publish.3
+++ b/deps/npm/man/man3/npm-publish.3
@@ -1,4 +1,4 @@
-.TH "NPM\-PUBLISH" "3" "June 2015" "" ""
+.TH "NPM\-PUBLISH" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-publish\fR \- Publish a package
.SH SYNOPSIS
@@ -14,10 +14,10 @@ Publishes a package to the registry so that it can be installed by name\.
Possible values in the 'packages' array are:
.RS 0
.IP \(bu 2
-\fB\fR:
+\fB\fP:
A folder containing a package\.json file
.IP \(bu 2
-\fB\fR:
+\fB\fP:
A url or file path to a gzipped tar archive containing a single folder
with a package\.json file inside\.
diff --git a/deps/npm/man/man3/npm-rebuild.3 b/deps/npm/man/man3/npm-rebuild.3
index 668e2c99ea0ede..b59df54005ac93 100644
--- a/deps/npm/man/man3/npm-rebuild.3
+++ b/deps/npm/man/man3/npm-rebuild.3
@@ -1,4 +1,4 @@
-.TH "NPM\-REBUILD" "3" "June 2015" "" ""
+.TH "NPM\-REBUILD" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-rebuild\fR \- Rebuild a package
.SH SYNOPSIS
@@ -10,10 +10,10 @@ npm\.commands\.rebuild([packages,] callback)
.RE
.SH DESCRIPTION
.P
-This command runs the \fBnpm build\fR command on each of the matched packages\. This is useful
+This command runs the \fBnpm build\fP command on each of the matched packages\. This is useful
when you install a new version of node, and must recompile all your C++ addons with
the new binary\. If no 'packages' parameter is specify, every package will be rebuilt\.
.SH CONFIGURATION
.P
-See \fBnpm help build\fR
+See \fBnpm help build\fP
diff --git a/deps/npm/man/man3/npm-repo.3 b/deps/npm/man/man3/npm-repo.3
index c88f5d22a478c9..53983bca9b9466 100644
--- a/deps/npm/man/man3/npm-repo.3
+++ b/deps/npm/man/man3/npm-repo.3
@@ -1,4 +1,4 @@
-.TH "NPM\-REPO" "3" "June 2015" "" ""
+.TH "NPM\-REPO" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-repo\fR \- Open package repository page in the browser
.SH SYNOPSIS
@@ -11,7 +11,7 @@ npm\.commands\.repo(package, callback)
.SH DESCRIPTION
.P
This command tries to guess at the likely location of a package's
-repository URL, and then tries to open it using the \fB\-\-browser\fR
+repository URL, and then tries to open it using the \fB\-\-browser\fP
config param\.
.P
Like other commands, the first parameter is an array\. This command only
diff --git a/deps/npm/man/man3/npm-restart.3 b/deps/npm/man/man3/npm-restart.3
index f792e50045751b..478c2f5f30dec4 100644
--- a/deps/npm/man/man3/npm-restart.3
+++ b/deps/npm/man/man3/npm-restart.3
@@ -1,4 +1,4 @@
-.TH "NPM\-RESTART" "3" "June 2015" "" ""
+.TH "NPM\-RESTART" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-restart\fR \- Restart a package
.SH SYNOPSIS
@@ -39,13 +39,13 @@ postrestart
If no version is specified, then it restarts the "active" version\.
.P
npm can restart multiple packages\. Just specify multiple packages in
-the \fBpackages\fR parameter\.
+the \fBpackages\fP parameter\.
.SH NOTE
.P
Note that the "restart" script is run \fBin addition to\fR the "stop"
and "start" scripts, not instead of them\.
.P
-This is the behavior as of \fBnpm\fR major version 2\. A change in this
+This is the behavior as of \fBnpm\fP major version 2\. A change in this
behavior will be accompanied by an increase in major version number
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man3/npm-root.3 b/deps/npm/man/man3/npm-root.3
index 1bcf8913c43ea3..8ade1a6826a613 100644
--- a/deps/npm/man/man3/npm-root.3
+++ b/deps/npm/man/man3/npm-root.3
@@ -1,4 +1,4 @@
-.TH "NPM\-ROOT" "3" "June 2015" "" ""
+.TH "NPM\-ROOT" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-root\fR \- Display npm root
.SH SYNOPSIS
@@ -10,7 +10,7 @@ npm\.commands\.root(args, callback)
.RE
.SH DESCRIPTION
.P
-Print the effective \fBnode_modules\fR folder to standard out\.
+Print the effective \fBnode_modules\fP folder to standard out\.
.P
\|'args' is never used and callback is never called with data\.
\|'args' must be present or things will break\.
diff --git a/deps/npm/man/man3/npm-run-script.3 b/deps/npm/man/man3/npm-run-script.3
index 2ec6ff50c29f68..416f1ff79203bb 100644
--- a/deps/npm/man/man3/npm-run-script.3
+++ b/deps/npm/man/man3/npm-run-script.3
@@ -1,4 +1,4 @@
-.TH "NPM\-RUN\-SCRIPT" "3" "June 2015" "" ""
+.TH "NPM\-RUN\-SCRIPT" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-run-script\fR \- Run arbitrary package scripts
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-search.3 b/deps/npm/man/man3/npm-search.3
index 7186d9d318abc2..823eff13b03c0f 100644
--- a/deps/npm/man/man3/npm-search.3
+++ b/deps/npm/man/man3/npm-search.3
@@ -1,4 +1,4 @@
-.TH "NPM\-SEARCH" "3" "June 2015" "" ""
+.TH "NPM\-SEARCH" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-search\fR \- Search for packages
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-shrinkwrap.3 b/deps/npm/man/man3/npm-shrinkwrap.3
index e4047cde351fa5..fa89d927ddbc4f 100644
--- a/deps/npm/man/man3/npm-shrinkwrap.3
+++ b/deps/npm/man/man3/npm-shrinkwrap.3
@@ -1,4 +1,4 @@
-.TH "NPM\-SHRINKWRAP" "3" "June 2015" "" ""
+.TH "NPM\-SHRINKWRAP" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-shrinkwrap\fR \- programmatically generate package shrinkwrap file
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-start.3 b/deps/npm/man/man3/npm-start.3
index ef2c760c3f7ebd..050c108e818b19 100644
--- a/deps/npm/man/man3/npm-start.3
+++ b/deps/npm/man/man3/npm-start.3
@@ -1,4 +1,4 @@
-.TH "NPM\-START" "3" "June 2015" "" ""
+.TH "NPM\-START" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-start\fR \- Start a package
.SH SYNOPSIS
@@ -13,5 +13,5 @@ npm\.commands\.start(packages, callback)
This runs a package's "start" script, if one was provided\.
.P
npm can start multiple packages\. Just specify multiple packages in the
-\fBpackages\fR parameter\.
+\fBpackages\fP parameter\.
diff --git a/deps/npm/man/man3/npm-stop.3 b/deps/npm/man/man3/npm-stop.3
index ed4b4c64cea012..9df3b4c69b85fd 100644
--- a/deps/npm/man/man3/npm-stop.3
+++ b/deps/npm/man/man3/npm-stop.3
@@ -1,4 +1,4 @@
-.TH "NPM\-STOP" "3" "June 2015" "" ""
+.TH "NPM\-STOP" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-stop\fR \- Stop a package
.SH SYNOPSIS
@@ -13,5 +13,5 @@ npm\.commands\.stop(packages, callback)
This runs a package's "stop" script, if one was provided\.
.P
npm can run stop on multiple packages\. Just specify multiple packages
-in the \fBpackages\fR parameter\.
+in the \fBpackages\fP parameter\.
diff --git a/deps/npm/man/man3/npm-submodule.3 b/deps/npm/man/man3/npm-submodule.3
deleted file mode 100644
index d2e23d7e8fc245..00000000000000
--- a/deps/npm/man/man3/npm-submodule.3
+++ /dev/null
@@ -1,41 +0,0 @@
-.\" Generated with Ronnjs 0.3.8
-.\" http://github.com/kapouer/ronnjs/
-.
-.TH "NPM\-SUBMODULE" "3" "September 2014" "" ""
-.
-.SH "NAME"
-\fBnpm-submodule\fR \-\- Add a package as a git submodule
-.
-.SH "SYNOPSIS"
-.
-.nf
-npm\.commands\.submodule(packages, callback)
-.
-.fi
-.
-.SH "DESCRIPTION"
-For each package specified, npm will check if it has a git repository url
-in its package\.json description then add it as a git submodule at \fBnode_modules/\fR\|\.
-.
-.P
-This is a convenience only\. From then on, it\'s up to you to manage
-updates by using the appropriate git commands\. npm will stubbornly
-refuse to update, modify, or remove anything with a \fB\|\.git\fR subfolder
-in it\.
-.
-.P
-This command also does not install missing dependencies, if the package
-does not include them in its git repository\. If \fBnpm ls\fR reports that
-things are missing, you can either install, link, or submodule them yourself,
-or you can do \fBnpm explore \-\- npm install\fR to install the
-dependencies into the submodule folder\.
-.
-.SH "SEE ALSO"
-.
-.IP "\(bu" 4
-npm help json
-.
-.IP "\(bu" 4
-git help submodule
-.
-.IP "" 0
diff --git a/deps/npm/man/man3/npm-tag.3 b/deps/npm/man/man3/npm-tag.3
index c60b49fc8ed1fb..5c3f3558309124 100644
--- a/deps/npm/man/man3/npm-tag.3
+++ b/deps/npm/man/man3/npm-tag.3
@@ -1,4 +1,4 @@
-.TH "NPM\-TAG" "3" "June 2015" "" ""
+.TH "NPM\-TAG" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-tag\fR \- Tag a published version
.SH SYNOPSIS
@@ -11,7 +11,7 @@ npm\.commands\.tag(package@version, tag, callback)
.SH DESCRIPTION
.P
Tags the specified version of the package with the specified tag, or the
-\fB\-\-tag\fR config if not specified\.
+\fB\-\-tag\fP config if not specified\.
.P
The 'package@version' is an array of strings, but only the first two elements are
currently used\.
@@ -23,5 +23,5 @@ specific version)\.
The second element is the name of the tag to tag this version with\. If this
parameter is missing or falsey (empty), the default from the config will be
used\. For more information about how to set this config, check
-\fBman 3 npm\-config\fR for programmatic usage or \fBman npm\-config\fR for cli usage\.
+\fBman 3 npm\-config\fP for programmatic usage or \fBman npm\-config\fP for cli usage\.
diff --git a/deps/npm/man/man3/npm-test.3 b/deps/npm/man/man3/npm-test.3
index 1cde98cb3a11b0..f0a67f1241c0d5 100644
--- a/deps/npm/man/man3/npm-test.3
+++ b/deps/npm/man/man3/npm-test.3
@@ -1,4 +1,4 @@
-.TH "NPM\-TEST" "3" "June 2015" "" ""
+.TH "NPM\-TEST" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-test\fR \- Test a package
.SH SYNOPSIS
@@ -12,9 +12,9 @@
.P
This runs a package's "test" script, if one was provided\.
.P
-To run tests as a condition of installation, set the \fBnpat\fR config to
+To run tests as a condition of installation, set the \fBnpat\fP config to
true\.
.P
npm can run tests on multiple packages\. Just specify multiple packages
-in the \fBpackages\fR parameter\.
+in the \fBpackages\fP parameter\.
diff --git a/deps/npm/man/man3/npm-uninstall.3 b/deps/npm/man/man3/npm-uninstall.3
index 0bd8ec3023c817..fe9ebaaf1729ca 100644
--- a/deps/npm/man/man3/npm-uninstall.3
+++ b/deps/npm/man/man3/npm-uninstall.3
@@ -1,4 +1,4 @@
-.TH "NPM\-UNINSTALL" "3" "June 2015" "" ""
+.TH "NPM\-UNINSTALL" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-uninstall\fR \- uninstall a package programmatically
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-unpublish.3 b/deps/npm/man/man3/npm-unpublish.3
index 5cbc92dc306df2..721bf206b55839 100644
--- a/deps/npm/man/man3/npm-unpublish.3
+++ b/deps/npm/man/man3/npm-unpublish.3
@@ -1,4 +1,4 @@
-.TH "NPM\-UNPUBLISH" "3" "June 2015" "" ""
+.TH "NPM\-UNPUBLISH" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-unpublish\fR \- Remove a package from the registry
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-update.3 b/deps/npm/man/man3/npm-update.3
index 4ac31fe1508315..da780d598e8131 100644
--- a/deps/npm/man/man3/npm-update.3
+++ b/deps/npm/man/man3/npm-update.3
@@ -1,4 +1,4 @@
-.TH "NPM\-UPDATE" "3" "June 2015" "" ""
+.TH "NPM\-UPDATE" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-update\fR \- Update a package
.SH SYNOPSIS
@@ -8,14 +8,14 @@
npm\.commands\.update(packages, callback)
.fi
.RE
-.TH "DESCRIPTION" "" "June 2015" "" ""
+.TH "DESCRIPTION" "" "August 2015" "" ""
.SH "NAME"
\fBDESCRIPTION\fR
.P
Updates a package, upgrading it to the latest version\. It also installs any
missing packages\.
.P
-The \fBpackages\fR argument is an array of packages to update\. The \fBcallback\fR
+The \fBpackages\fP argument is an array of packages to update\. The \fBcallback\fP
parameter will be called when done or when an error occurs\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man3/npm-version.3 b/deps/npm/man/man3/npm-version.3
index 61ed5d174a0bd2..7a13475c43363a 100644
--- a/deps/npm/man/man3/npm-version.3
+++ b/deps/npm/man/man3/npm-version.3
@@ -1,4 +1,4 @@
-.TH "NPM\-VERSION" "3" "June 2015" "" ""
+.TH "NPM\-VERSION" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-version\fR \- Bump a package version
.SH SYNOPSIS
diff --git a/deps/npm/man/man3/npm-view.3 b/deps/npm/man/man3/npm-view.3
index 2b8645ee80b451..6921675a45cd4f 100644
--- a/deps/npm/man/man3/npm-view.3
+++ b/deps/npm/man/man3/npm-view.3
@@ -1,4 +1,4 @@
-.TH "NPM\-VIEW" "3" "June 2015" "" ""
+.TH "NPM\-VIEW" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-view\fR \- View registry info
.SH SYNOPSIS
@@ -11,7 +11,7 @@ npm\.commands\.view(args, [silent,] callback)
.SH DESCRIPTION
.P
This command shows data about a package and prints it to the stream
-referenced by the \fBoutfd\fR config, which defaults to stdout\.
+referenced by the \fBoutfd\fP config, which defaults to stdout\.
.P
The "args" parameter is an ordered list that closely resembles the command\-line
usage\. The elements should be ordered such that the first element is
@@ -21,7 +21,7 @@ which can be used to get only the information desired from the registry\.
.P
The callback will be passed all of the data returned by the query\.
.P
-For example, to get the package registry entry for the \fBconnect\fR package,
+For example, to get the package registry entry for the \fBconnect\fP package,
you can do this:
.P
.RS 2
@@ -33,7 +33,7 @@ npm\.commands\.view(["connect"], callback)
If no version is specified, "latest" is assumed\.
.P
Field names can be specified after the package descriptor\.
-For example, to show the dependencies of the \fBronn\fR package at version
+For example, to show the dependencies of the \fBronn\fP package at version
0\.3\.5, you could do the following:
.P
.RS 2
@@ -84,7 +84,7 @@ npm\.commands\.view(["express", "contributors\.name", "contributors\.email"], ca
.P
"Person" fields are shown as a string if they would be shown as an
object\. So, for example, this will show the list of npm contributors in
-the shortened string format\. (See \fBnpm help json\fR for more on this\.)
+the shortened string format\. (See \fBnpm help json\fP for more on this\.)
.P
.RS 2
.nf
diff --git a/deps/npm/man/man3/npm-whoami.3 b/deps/npm/man/man3/npm-whoami.3
index 6f0fc323fd6152..0c29cf74846061 100644
--- a/deps/npm/man/man3/npm-whoami.3
+++ b/deps/npm/man/man3/npm-whoami.3
@@ -1,4 +1,4 @@
-.TH "NPM\-WHOAMI" "3" "June 2015" "" ""
+.TH "NPM\-WHOAMI" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm-whoami\fR \- Display npm username
.SH SYNOPSIS
@@ -10,7 +10,7 @@ npm\.commands\.whoami(args, callback)
.RE
.SH DESCRIPTION
.P
-Print the \fBusername\fR config to standard output\.
+Print the \fBusername\fP config to standard output\.
.P
\|'args' is never used and callback is never called with data\.
\|'args' must be present or things will break\.
diff --git a/deps/npm/man/man3/npm.3 b/deps/npm/man/man3/npm.3
index a27078deb1cacc..790675dd7aac45 100644
--- a/deps/npm/man/man3/npm.3
+++ b/deps/npm/man/man3/npm.3
@@ -1,4 +1,4 @@
-.TH "NPM" "3" "June 2015" "" ""
+.TH "NPM" "3" "August 2015" "" ""
.SH "NAME"
\fBnpm\fR \- javascript package manager
.SH SYNOPSIS
@@ -20,22 +20,22 @@ npm\.load([configObject, ]function (er, npm) {
.RE
.SH VERSION
.P
-2.11.3
+2.13.4
.SH DESCRIPTION
.P
This is the API documentation for npm\.
To find documentation of the command line
-client, see npm help \fBnpm\fR\|\.
+client, see npm help \fBnpm\fP\|\.
.P
-Prior to using npm's commands, \fBnpm\.load()\fR must be called\. If you provide
-\fBconfigObject\fR as an object map of top\-level configs, they override the values
+Prior to using npm's commands, \fBnpm\.load()\fP must be called\. If you provide
+\fBconfigObject\fP as an object map of top\-level configs, they override the values
stored in the various config locations\. In the npm command line client, this
set of configs is parsed from the command line options\. Additional
configuration params are loaded from two configuration files\. See
-npm help \fBnpm\-config\fR, npm help 7 \fBnpm\-config\fR, and npm help 5 \fBnpmrc\fR for more information\.
+npm help \fBnpm\-config\fP, npm help 7 \fBnpm\-config\fP, and npm help 5 \fBnpmrc\fP for more information\.
.P
After that, each of the functions are accessible in the
-commands object: \fBnpm\.commands\.\fR\|\. See npm help 7 \fBnpm\-index\fR for a list of
+commands object: \fBnpm\.commands\.\fP\|\. See npm help 7 \fBnpm\-index\fP for a list of
all possible commands\.
.P
All commands on the command object take an \fBarray\fR of positional argument
@@ -45,50 +45,50 @@ commands take other optional arguments\.
Configs cannot currently be set on a per function basis, as each call to
npm\.config\.set will change the value for \fIall\fR npm commands in that process\.
.P
-To find API documentation for a specific command, run the \fBnpm apihelp\fR
+To find API documentation for a specific command, run the \fBnpm apihelp\fP
command\.
.SH METHODS AND PROPERTIES
.RS 0
.IP \(bu 2
-\fBnpm\.load(configs, cb)\fR
- Load the configuration params, and call the \fBcb\fR function once the
+\fBnpm\.load(configs, cb)\fP
+ Load the configuration params, and call the \fBcb\fP function once the
globalconfig and userconfig files have been loaded as well, or on
nextTick if they've already been loaded\.
.IP \(bu 2
-\fBnpm\.config\fR
+\fBnpm\.config\fP
An object for accessing npm configuration parameters\.
.RS 0
.IP \(bu 2
-\fBnpm\.config\.get(key)\fR
+\fBnpm\.config\.get(key)\fP
.IP \(bu 2
-\fBnpm\.config\.set(key, val)\fR
+\fBnpm\.config\.set(key, val)\fP
.IP \(bu 2
-\fBnpm\.config\.del(key)\fR
+\fBnpm\.config\.del(key)\fP
.RE
.IP \(bu 2
-\fBnpm\.dir\fR or \fBnpm\.root\fR
- The \fBnode_modules\fR directory where npm will operate\.
+\fBnpm\.dir\fP or \fBnpm\.root\fP
+ The \fBnode_modules\fP directory where npm will operate\.
.IP \(bu 2
-\fBnpm\.prefix\fR
+\fBnpm\.prefix\fP
The prefix where npm is operating\. (Most often the current working
directory\.)
.IP \(bu 2
-\fBnpm\.cache\fR
+\fBnpm\.cache\fP
The place where npm keeps JSON and tarballs it fetches from the
registry (or uploads to the registry)\.
.IP \(bu 2
-\fBnpm\.tmp\fR
+\fBnpm\.tmp\fP
npm's temporary working directory\.
.IP \(bu 2
-\fBnpm\.deref\fR
+\fBnpm\.deref\fP
Get the "real" name for a command that has either an alias or
abbreviation\.
.RE
.SH MAGIC
.P
-For each of the methods in the \fBnpm\.commands\fR object, a method is added to the
+For each of the methods in the \fBnpm\.commands\fP object, a method is added to the
npm object, which takes a set of positional string arguments rather than an
array and a callback\.
.P
@@ -106,13 +106,13 @@ For example, this would work in a node repl:
.fi
.RE
.P
-Note that that \fIwon't\fR work in a node program, since the \fBinstall\fR
+Note that that \fIwon't\fR work in a node program, since the \fBinstall\fP
method will get called before the configuration load is completed\.
.SH ABBREVS
.P
-In order to support \fBnpm ins foo\fR instead of \fBnpm install foo\fR, the
-\fBnpm\.commands\fR object has a set of abbreviations as well as the full
-method names\. Use the \fBnpm\.deref\fR method to find the real name\.
+In order to support \fBnpm ins foo\fP instead of \fBnpm install foo\fP, the
+\fBnpm\.commands\fP object has a set of abbreviations as well as the full
+method names\. Use the \fBnpm\.deref\fP method to find the real name\.
.P
For example:
.P
diff --git a/deps/npm/man/man5/npm-folders.5 b/deps/npm/man/man5/npm-folders.5
index 71816580cffd0b..71a3c157410856 100644
--- a/deps/npm/man/man5/npm-folders.5
+++ b/deps/npm/man/man5/npm-folders.5
@@ -1,4 +1,4 @@
-.TH "NPM\-FOLDERS" "5" "June 2015" "" ""
+.TH "NPM\-FOLDERS" "5" "August 2015" "" ""
.SH "NAME"
\fBnpm-folders\fR \- Folder Structures Used by npm
.SH DESCRIPTION
@@ -9,89 +9,89 @@ This document will tell you what it puts where\.
.SS tl;dr
.RS 0
.IP \(bu 2
-Local install (default): puts stuff in \fB\|\./node_modules\fR of the current
+Local install (default): puts stuff in \fB\|\./node_modules\fP of the current
package root\.
.IP \(bu 2
-Global install (with \fB\-g\fR): puts stuff in /usr/local or wherever node
+Global install (with \fB\-g\fP): puts stuff in /usr/local or wherever node
is installed\.
.IP \(bu 2
-Install it \fBlocally\fR if you're going to \fBrequire()\fR it\.
+Install it \fBlocally\fR if you're going to \fBrequire()\fP it\.
.IP \(bu 2
Install it \fBglobally\fR if you're going to run it on the command line\.
.IP \(bu 2
-If you need both, then install it in both places, or use \fBnpm link\fR\|\.
+If you need both, then install it in both places, or use \fBnpm link\fP\|\.
.RE
.SS prefix Configuration
.P
-The \fBprefix\fR config defaults to the location where node is installed\.
-On most systems, this is \fB/usr/local\fR, and most of the time is the same
-as node's \fBprocess\.installPrefix\fR\|\.
+The \fBprefix\fP config defaults to the location where node is installed\.
+On most systems, this is \fB/usr/local\fP, and most of the time is the same
+as node's \fBprocess\.installPrefix\fP\|\.
.P
On windows, this is the exact location of the node\.exe binary\. On Unix
systems, it's one level up, since node is typically installed at
-\fB{prefix}/bin/node\fR rather than \fB{prefix}/node\.exe\fR\|\.
+\fB{prefix}/bin/node\fP rather than \fB{prefix}/node\.exe\fP\|\.
.P
-When the \fBglobal\fR flag is set, npm installs things into this prefix\.
+When the \fBglobal\fP flag is set, npm installs things into this prefix\.
When it is not set, it uses the root of the current package, or the
current working directory if not in a package already\.
.SS Node Modules
.P
-Packages are dropped into the \fBnode_modules\fR folder under the \fBprefix\fR\|\.
+Packages are dropped into the \fBnode_modules\fP folder under the \fBprefix\fP\|\.
When installing locally, this means that you can
-\fBrequire("packagename")\fR to load its main module, or
-\fBrequire("packagename/lib/path/to/sub/module")\fR to load other modules\.
+\fBrequire("packagename")\fP to load its main module, or
+\fBrequire("packagename/lib/path/to/sub/module")\fP to load other modules\.
.P
-Global installs on Unix systems go to \fB{prefix}/lib/node_modules\fR\|\.
-Global installs on Windows go to \fB{prefix}/node_modules\fR (that is, no
-\fBlib\fR folder\.)
+Global installs on Unix systems go to \fB{prefix}/lib/node_modules\fP\|\.
+Global installs on Windows go to \fB{prefix}/node_modules\fP (that is, no
+\fBlib\fP folder\.)
.P
Scoped packages are installed the same way, except they are grouped together
-in a sub\-folder of the relevant \fBnode_modules\fR folder with the name of that
-scope prefix by the @ symbol, e\.g\. \fBnpm install @myorg/package\fR would place
-the package in \fB{prefix}/node_modules/@myorg/package\fR\|\. See npm help 7 \fBscopes\fR for
+in a sub\-folder of the relevant \fBnode_modules\fP folder with the name of that
+scope prefix by the @ symbol, e\.g\. \fBnpm install @myorg/package\fP would place
+the package in \fB{prefix}/node_modules/@myorg/package\fP\|\. See npm help 7 \fBscopes\fP for
more details\.
.P
-If you wish to \fBrequire()\fR a package, then install it locally\.
+If you wish to \fBrequire()\fP a package, then install it locally\.
.SS Executables
.P
-When in global mode, executables are linked into \fB{prefix}/bin\fR on Unix,
-or directly into \fB{prefix}\fR on Windows\.
+When in global mode, executables are linked into \fB{prefix}/bin\fP on Unix,
+or directly into \fB{prefix}\fP on Windows\.
.P
When in local mode, executables are linked into
-\fB\|\./node_modules/\.bin\fR so that they can be made available to scripts run
+\fB\|\./node_modules/\.bin\fP so that they can be made available to scripts run
through npm\. (For example, so that a test runner will be in the path
-when you run \fBnpm test\fR\|\.)
+when you run \fBnpm test\fP\|\.)
.SS Man Pages
.P
-When in global mode, man pages are linked into \fB{prefix}/share/man\fR\|\.
+When in global mode, man pages are linked into \fB{prefix}/share/man\fP\|\.
.P
When in local mode, man pages are not installed\.
.P
Man pages are not installed on Windows systems\.
.SS Cache
.P
-See npm help \fBnpm\-cache\fR\|\. Cache files are stored in \fB~/\.npm\fR on Posix, or
-\fB~/npm\-cache\fR on Windows\.
+See npm help \fBnpm\-cache\fP\|\. Cache files are stored in \fB~/\.npm\fP on Posix, or
+\fB~/npm\-cache\fP on Windows\.
.P
-This is controlled by the \fBcache\fR configuration param\.
+This is controlled by the \fBcache\fP configuration param\.
.SS Temp Files
.P
Temporary files are stored by default in the folder specified by the
-\fBtmp\fR config, which defaults to the TMPDIR, TMP, or TEMP environment
-variables, or \fB/tmp\fR on Unix and \fBc:\\windows\\temp\fR on Windows\.
+\fBtmp\fP config, which defaults to the TMPDIR, TMP, or TEMP environment
+variables, or \fB/tmp\fP on Unix and \fBc:\\windows\\temp\fP on Windows\.
.P
Temp files are given a unique folder under this root for each run of the
program, and are deleted upon successful exit\.
.SH More Information
.P
When installing locally, npm first tries to find an appropriate
-\fBprefix\fR folder\. This is so that \fBnpm install foo@1\.2\.3\fR will install
-to the sensible root of your package, even if you happen to have \fBcd\fRed
+\fBprefix\fP folder\. This is so that \fBnpm install foo@1\.2\.3\fP will install
+to the sensible root of your package, even if you happen to have \fBcd\fPed
into some other folder\.
.P
Starting at the $PWD, npm will walk up the folder tree checking for a
-folder that contains either a \fBpackage\.json\fR file, or a \fBnode_modules\fR
+folder that contains either a \fBpackage\.json\fP file, or a \fBnode_modules\fP
folder\. If such a thing is found, then that is treated as the effective
"current directory" for the purpose of running npm commands\. (This
behavior is inspired by and similar to git's \.git\-folder seeking
@@ -99,16 +99,16 @@ logic when running git commands in a working dir\.)
.P
If no package root is found, then the current folder is used\.
.P
-When you run \fBnpm install foo@1\.2\.3\fR, then the package is loaded into
-the cache, and then unpacked into \fB\|\./node_modules/foo\fR\|\. Then, any of
+When you run \fBnpm install foo@1\.2\.3\fP, then the package is loaded into
+the cache, and then unpacked into \fB\|\./node_modules/foo\fP\|\. Then, any of
foo's dependencies are similarly unpacked into
-\fB\|\./node_modules/foo/node_modules/\.\.\.\fR\|\.
+\fB\|\./node_modules/foo/node_modules/\.\.\.\fP\|\.
.P
-Any bin files are symlinked to \fB\|\./node_modules/\.bin/\fR, so that they may
+Any bin files are symlinked to \fB\|\./node_modules/\.bin/\fP, so that they may
be found by npm scripts when necessary\.
.SS Global Installation
.P
-If the \fBglobal\fR configuration is set to true, then npm will
+If the \fBglobal\fP configuration is set to true, then npm will
install packages "globally"\.
.P
For global installation, packages are installed roughly the same way,
@@ -116,21 +116,21 @@ but using the folders described above\.
.SS Cycles, Conflicts, and Folder Parsimony
.P
Cycles are handled using the property of node's module system that it
-walks up the directories looking for \fBnode_modules\fR folders\. So, at every
-stage, if a package is already installed in an ancestor \fBnode_modules\fR
+walks up the directories looking for \fBnode_modules\fP folders\. So, at every
+stage, if a package is already installed in an ancestor \fBnode_modules\fP
folder, then it is not installed at the current location\.
.P
-Consider the case above, where \fBfoo \-> bar \-> baz\fR\|\. Imagine if, in
+Consider the case above, where \fBfoo \-> bar \-> baz\fP\|\. Imagine if, in
addition to that, baz depended on bar, so you'd have:
-\fBfoo \-> bar \-> baz \-> bar \-> baz \.\.\.\fR\|\. However, since the folder
-structure is: \fBfoo/node_modules/bar/node_modules/baz\fR, there's no need to
-put another copy of bar into \fB\|\.\.\./baz/node_modules\fR, since when it calls
+\fBfoo \-> bar \-> baz \-> bar \-> baz \.\.\.\fP\|\. However, since the folder
+structure is: \fBfoo/node_modules/bar/node_modules/baz\fP, there's no need to
+put another copy of bar into \fB\|\.\.\./baz/node_modules\fP, since when it calls
require("bar"), it will get the copy that is installed in
-\fBfoo/node_modules/bar\fR\|\.
+\fBfoo/node_modules/bar\fP\|\.
.P
This shortcut is only used if the exact same
-version would be installed in multiple nested \fBnode_modules\fR folders\. It
-is still possible to have \fBa/node_modules/b/node_modules/a\fR if the two
+version would be installed in multiple nested \fBnode_modules\fP folders\. It
+is still possible to have \fBa/node_modules/b/node_modules/a\fP if the two
"a" packages are different versions\. However, without repeating the
exact same package multiple times, an infinite regress will always be
prevented\.
@@ -176,36 +176,36 @@ foo
.fi
.RE
.P
-Since foo depends directly on \fBbar@1\.2\.3\fR and \fBbaz@1\.2\.3\fR, those are
-installed in foo's \fBnode_modules\fR folder\.
+Since foo depends directly on \fBbar@1\.2\.3\fP and \fBbaz@1\.2\.3\fP, those are
+installed in foo's \fBnode_modules\fP folder\.
.P
Even though the latest copy of blerg is 1\.3\.7, foo has a specific
dependency on version 1\.2\.5\. So, that gets installed at [A]\. Since the
-parent installation of blerg satisfies bar's dependency on \fBblerg@1\.x\fR,
+parent installation of blerg satisfies bar's dependency on \fBblerg@1\.x\fP,
it does not install another copy under [B]\.
.P
Bar [B] also has dependencies on baz and asdf, so those are installed in
-bar's \fBnode_modules\fR folder\. Because it depends on \fBbaz@2\.x\fR, it cannot
-re\-use the \fBbaz@1\.2\.3\fR installed in the parent \fBnode_modules\fR folder [D],
+bar's \fBnode_modules\fP folder\. Because it depends on \fBbaz@2\.x\fP, it cannot
+re\-use the \fBbaz@1\.2\.3\fP installed in the parent \fBnode_modules\fP folder [D],
and must install its own copy [C]\.
.P
-Underneath bar, the \fBbaz \-> quux \-> bar\fR dependency creates a cycle\.
+Underneath bar, the \fBbaz \-> quux \-> bar\fP dependency creates a cycle\.
However, because bar is already in quux's ancestry [B], it does not
unpack another copy of bar into that folder\.
.P
-Underneath \fBfoo \-> baz\fR [D], quux's [E] folder tree is empty, because its
+Underneath \fBfoo \-> baz\fP [D], quux's [E] folder tree is empty, because its
dependency on bar is satisfied by the parent folder copy installed at [B]\.
.P
-For a graphical breakdown of what is installed where, use \fBnpm ls\fR\|\.
+For a graphical breakdown of what is installed where, use \fBnpm ls\fP\|\.
.SS Publishing
.P
-Upon publishing, npm will look in the \fBnode_modules\fR folder\. If any of
-the items there are not in the \fBbundledDependencies\fR array, then they will
+Upon publishing, npm will look in the \fBnode_modules\fP folder\. If any of
+the items there are not in the \fBbundledDependencies\fP array, then they will
not be included in the package tarball\.
.P
This allows a package maintainer to install all of their dependencies
(and dev dependencies) locally, but only re\-publish those items that
-cannot be found elsewhere\. See npm help 5 \fBpackage\.json\fR for more information\.
+cannot be found elsewhere\. See npm help 5 \fBpackage\.json\fP for more information\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man5/npm-global.5 b/deps/npm/man/man5/npm-global.5
index 71816580cffd0b..71a3c157410856 100644
--- a/deps/npm/man/man5/npm-global.5
+++ b/deps/npm/man/man5/npm-global.5
@@ -1,4 +1,4 @@
-.TH "NPM\-FOLDERS" "5" "June 2015" "" ""
+.TH "NPM\-FOLDERS" "5" "August 2015" "" ""
.SH "NAME"
\fBnpm-folders\fR \- Folder Structures Used by npm
.SH DESCRIPTION
@@ -9,89 +9,89 @@ This document will tell you what it puts where\.
.SS tl;dr
.RS 0
.IP \(bu 2
-Local install (default): puts stuff in \fB\|\./node_modules\fR of the current
+Local install (default): puts stuff in \fB\|\./node_modules\fP of the current
package root\.
.IP \(bu 2
-Global install (with \fB\-g\fR): puts stuff in /usr/local or wherever node
+Global install (with \fB\-g\fP): puts stuff in /usr/local or wherever node
is installed\.
.IP \(bu 2
-Install it \fBlocally\fR if you're going to \fBrequire()\fR it\.
+Install it \fBlocally\fR if you're going to \fBrequire()\fP it\.
.IP \(bu 2
Install it \fBglobally\fR if you're going to run it on the command line\.
.IP \(bu 2
-If you need both, then install it in both places, or use \fBnpm link\fR\|\.
+If you need both, then install it in both places, or use \fBnpm link\fP\|\.
.RE
.SS prefix Configuration
.P
-The \fBprefix\fR config defaults to the location where node is installed\.
-On most systems, this is \fB/usr/local\fR, and most of the time is the same
-as node's \fBprocess\.installPrefix\fR\|\.
+The \fBprefix\fP config defaults to the location where node is installed\.
+On most systems, this is \fB/usr/local\fP, and most of the time is the same
+as node's \fBprocess\.installPrefix\fP\|\.
.P
On windows, this is the exact location of the node\.exe binary\. On Unix
systems, it's one level up, since node is typically installed at
-\fB{prefix}/bin/node\fR rather than \fB{prefix}/node\.exe\fR\|\.
+\fB{prefix}/bin/node\fP rather than \fB{prefix}/node\.exe\fP\|\.
.P
-When the \fBglobal\fR flag is set, npm installs things into this prefix\.
+When the \fBglobal\fP flag is set, npm installs things into this prefix\.
When it is not set, it uses the root of the current package, or the
current working directory if not in a package already\.
.SS Node Modules
.P
-Packages are dropped into the \fBnode_modules\fR folder under the \fBprefix\fR\|\.
+Packages are dropped into the \fBnode_modules\fP folder under the \fBprefix\fP\|\.
When installing locally, this means that you can
-\fBrequire("packagename")\fR to load its main module, or
-\fBrequire("packagename/lib/path/to/sub/module")\fR to load other modules\.
+\fBrequire("packagename")\fP to load its main module, or
+\fBrequire("packagename/lib/path/to/sub/module")\fP to load other modules\.
.P
-Global installs on Unix systems go to \fB{prefix}/lib/node_modules\fR\|\.
-Global installs on Windows go to \fB{prefix}/node_modules\fR (that is, no
-\fBlib\fR folder\.)
+Global installs on Unix systems go to \fB{prefix}/lib/node_modules\fP\|\.
+Global installs on Windows go to \fB{prefix}/node_modules\fP (that is, no
+\fBlib\fP folder\.)
.P
Scoped packages are installed the same way, except they are grouped together
-in a sub\-folder of the relevant \fBnode_modules\fR folder with the name of that
-scope prefix by the @ symbol, e\.g\. \fBnpm install @myorg/package\fR would place
-the package in \fB{prefix}/node_modules/@myorg/package\fR\|\. See npm help 7 \fBscopes\fR for
+in a sub\-folder of the relevant \fBnode_modules\fP folder with the name of that
+scope prefix by the @ symbol, e\.g\. \fBnpm install @myorg/package\fP would place
+the package in \fB{prefix}/node_modules/@myorg/package\fP\|\. See npm help 7 \fBscopes\fP for
more details\.
.P
-If you wish to \fBrequire()\fR a package, then install it locally\.
+If you wish to \fBrequire()\fP a package, then install it locally\.
.SS Executables
.P
-When in global mode, executables are linked into \fB{prefix}/bin\fR on Unix,
-or directly into \fB{prefix}\fR on Windows\.
+When in global mode, executables are linked into \fB{prefix}/bin\fP on Unix,
+or directly into \fB{prefix}\fP on Windows\.
.P
When in local mode, executables are linked into
-\fB\|\./node_modules/\.bin\fR so that they can be made available to scripts run
+\fB\|\./node_modules/\.bin\fP so that they can be made available to scripts run
through npm\. (For example, so that a test runner will be in the path
-when you run \fBnpm test\fR\|\.)
+when you run \fBnpm test\fP\|\.)
.SS Man Pages
.P
-When in global mode, man pages are linked into \fB{prefix}/share/man\fR\|\.
+When in global mode, man pages are linked into \fB{prefix}/share/man\fP\|\.
.P
When in local mode, man pages are not installed\.
.P
Man pages are not installed on Windows systems\.
.SS Cache
.P
-See npm help \fBnpm\-cache\fR\|\. Cache files are stored in \fB~/\.npm\fR on Posix, or
-\fB~/npm\-cache\fR on Windows\.
+See npm help \fBnpm\-cache\fP\|\. Cache files are stored in \fB~/\.npm\fP on Posix, or
+\fB~/npm\-cache\fP on Windows\.
.P
-This is controlled by the \fBcache\fR configuration param\.
+This is controlled by the \fBcache\fP configuration param\.
.SS Temp Files
.P
Temporary files are stored by default in the folder specified by the
-\fBtmp\fR config, which defaults to the TMPDIR, TMP, or TEMP environment
-variables, or \fB/tmp\fR on Unix and \fBc:\\windows\\temp\fR on Windows\.
+\fBtmp\fP config, which defaults to the TMPDIR, TMP, or TEMP environment
+variables, or \fB/tmp\fP on Unix and \fBc:\\windows\\temp\fP on Windows\.
.P
Temp files are given a unique folder under this root for each run of the
program, and are deleted upon successful exit\.
.SH More Information
.P
When installing locally, npm first tries to find an appropriate
-\fBprefix\fR folder\. This is so that \fBnpm install foo@1\.2\.3\fR will install
-to the sensible root of your package, even if you happen to have \fBcd\fRed
+\fBprefix\fP folder\. This is so that \fBnpm install foo@1\.2\.3\fP will install
+to the sensible root of your package, even if you happen to have \fBcd\fPed
into some other folder\.
.P
Starting at the $PWD, npm will walk up the folder tree checking for a
-folder that contains either a \fBpackage\.json\fR file, or a \fBnode_modules\fR
+folder that contains either a \fBpackage\.json\fP file, or a \fBnode_modules\fP
folder\. If such a thing is found, then that is treated as the effective
"current directory" for the purpose of running npm commands\. (This
behavior is inspired by and similar to git's \.git\-folder seeking
@@ -99,16 +99,16 @@ logic when running git commands in a working dir\.)
.P
If no package root is found, then the current folder is used\.
.P
-When you run \fBnpm install foo@1\.2\.3\fR, then the package is loaded into
-the cache, and then unpacked into \fB\|\./node_modules/foo\fR\|\. Then, any of
+When you run \fBnpm install foo@1\.2\.3\fP, then the package is loaded into
+the cache, and then unpacked into \fB\|\./node_modules/foo\fP\|\. Then, any of
foo's dependencies are similarly unpacked into
-\fB\|\./node_modules/foo/node_modules/\.\.\.\fR\|\.
+\fB\|\./node_modules/foo/node_modules/\.\.\.\fP\|\.
.P
-Any bin files are symlinked to \fB\|\./node_modules/\.bin/\fR, so that they may
+Any bin files are symlinked to \fB\|\./node_modules/\.bin/\fP, so that they may
be found by npm scripts when necessary\.
.SS Global Installation
.P
-If the \fBglobal\fR configuration is set to true, then npm will
+If the \fBglobal\fP configuration is set to true, then npm will
install packages "globally"\.
.P
For global installation, packages are installed roughly the same way,
@@ -116,21 +116,21 @@ but using the folders described above\.
.SS Cycles, Conflicts, and Folder Parsimony
.P
Cycles are handled using the property of node's module system that it
-walks up the directories looking for \fBnode_modules\fR folders\. So, at every
-stage, if a package is already installed in an ancestor \fBnode_modules\fR
+walks up the directories looking for \fBnode_modules\fP folders\. So, at every
+stage, if a package is already installed in an ancestor \fBnode_modules\fP
folder, then it is not installed at the current location\.
.P
-Consider the case above, where \fBfoo \-> bar \-> baz\fR\|\. Imagine if, in
+Consider the case above, where \fBfoo \-> bar \-> baz\fP\|\. Imagine if, in
addition to that, baz depended on bar, so you'd have:
-\fBfoo \-> bar \-> baz \-> bar \-> baz \.\.\.\fR\|\. However, since the folder
-structure is: \fBfoo/node_modules/bar/node_modules/baz\fR, there's no need to
-put another copy of bar into \fB\|\.\.\./baz/node_modules\fR, since when it calls
+\fBfoo \-> bar \-> baz \-> bar \-> baz \.\.\.\fP\|\. However, since the folder
+structure is: \fBfoo/node_modules/bar/node_modules/baz\fP, there's no need to
+put another copy of bar into \fB\|\.\.\./baz/node_modules\fP, since when it calls
require("bar"), it will get the copy that is installed in
-\fBfoo/node_modules/bar\fR\|\.
+\fBfoo/node_modules/bar\fP\|\.
.P
This shortcut is only used if the exact same
-version would be installed in multiple nested \fBnode_modules\fR folders\. It
-is still possible to have \fBa/node_modules/b/node_modules/a\fR if the two
+version would be installed in multiple nested \fBnode_modules\fP folders\. It
+is still possible to have \fBa/node_modules/b/node_modules/a\fP if the two
"a" packages are different versions\. However, without repeating the
exact same package multiple times, an infinite regress will always be
prevented\.
@@ -176,36 +176,36 @@ foo
.fi
.RE
.P
-Since foo depends directly on \fBbar@1\.2\.3\fR and \fBbaz@1\.2\.3\fR, those are
-installed in foo's \fBnode_modules\fR folder\.
+Since foo depends directly on \fBbar@1\.2\.3\fP and \fBbaz@1\.2\.3\fP, those are
+installed in foo's \fBnode_modules\fP folder\.
.P
Even though the latest copy of blerg is 1\.3\.7, foo has a specific
dependency on version 1\.2\.5\. So, that gets installed at [A]\. Since the
-parent installation of blerg satisfies bar's dependency on \fBblerg@1\.x\fR,
+parent installation of blerg satisfies bar's dependency on \fBblerg@1\.x\fP,
it does not install another copy under [B]\.
.P
Bar [B] also has dependencies on baz and asdf, so those are installed in
-bar's \fBnode_modules\fR folder\. Because it depends on \fBbaz@2\.x\fR, it cannot
-re\-use the \fBbaz@1\.2\.3\fR installed in the parent \fBnode_modules\fR folder [D],
+bar's \fBnode_modules\fP folder\. Because it depends on \fBbaz@2\.x\fP, it cannot
+re\-use the \fBbaz@1\.2\.3\fP installed in the parent \fBnode_modules\fP folder [D],
and must install its own copy [C]\.
.P
-Underneath bar, the \fBbaz \-> quux \-> bar\fR dependency creates a cycle\.
+Underneath bar, the \fBbaz \-> quux \-> bar\fP dependency creates a cycle\.
However, because bar is already in quux's ancestry [B], it does not
unpack another copy of bar into that folder\.
.P
-Underneath \fBfoo \-> baz\fR [D], quux's [E] folder tree is empty, because its
+Underneath \fBfoo \-> baz\fP [D], quux's [E] folder tree is empty, because its
dependency on bar is satisfied by the parent folder copy installed at [B]\.
.P
-For a graphical breakdown of what is installed where, use \fBnpm ls\fR\|\.
+For a graphical breakdown of what is installed where, use \fBnpm ls\fP\|\.
.SS Publishing
.P
-Upon publishing, npm will look in the \fBnode_modules\fR folder\. If any of
-the items there are not in the \fBbundledDependencies\fR array, then they will
+Upon publishing, npm will look in the \fBnode_modules\fP folder\. If any of
+the items there are not in the \fBbundledDependencies\fP array, then they will
not be included in the package tarball\.
.P
This allows a package maintainer to install all of their dependencies
(and dev dependencies) locally, but only re\-publish those items that
-cannot be found elsewhere\. See npm help 5 \fBpackage\.json\fR for more information\.
+cannot be found elsewhere\. See npm help 5 \fBpackage\.json\fP for more information\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man5/npm-json.5 b/deps/npm/man/man5/npm-json.5
index ed3ee7c241a72b..f309144b511fa6 100644
--- a/deps/npm/man/man5/npm-json.5
+++ b/deps/npm/man/man5/npm-json.5
@@ -1,4 +1,4 @@
-.TH "PACKAGE\.JSON" "5" "June 2015" "" ""
+.TH "PACKAGE\.JSON" "5" "August 2015" "" ""
.SH "NAME"
\fBpackage.json\fR \- Specifics of npm's package\.json handling
.SH DESCRIPTION
@@ -7,7 +7,7 @@ This document is all you need to know about what's required in your package\.jso
file\. It must be actual JSON, not just a JavaScript object literal\.
.P
A lot of the behavior described in this document is affected by the config
-settings described in npm help 7 \fBnpm\-config\fR\|\.
+settings described in npm help 7 \fBnpm\-config\fP\|\.
.SH name
.P
The \fImost\fR important things in your package\.json are the name and version fields\.
@@ -50,8 +50,8 @@ already, before you get too attached to it\. https://www\.npmjs\.com/
.RE
.P
-A name can be optionally prefixed by a scope, e\.g\. \fB@myorg/mypackage\fR\|\. See
-npm help 7 \fBnpm\-scope\fR for more detail\.
+A name can be optionally prefixed by a scope, e\.g\. \fB@myorg/mypackage\fP\|\. See
+npm help 7 \fBnpm\-scope\fP for more detail\.
.SH version
.P
The \fImost\fR important things in your package\.json are the name and version fields\.
@@ -62,17 +62,17 @@ changes to the version\.
.P
Version must be parseable by
node\-semver \fIhttps://github\.com/isaacs/node\-semver\fR, which is bundled
-with npm as a dependency\. (\fBnpm install semver\fR to use it yourself\.)
+with npm as a dependency\. (\fBnpm install semver\fP to use it yourself\.)
.P
More on version numbers and ranges at npm help 7 semver\.
.SH description
.P
Put a description in it\. It's a string\. This helps people discover your
-package, as it's listed in \fBnpm search\fR\|\.
+package, as it's listed in \fBnpm search\fP\|\.
.SH keywords
.P
Put keywords in it\. It's an array of strings\. This helps people
-discover your package as it's listed in \fBnpm search\fR\|\.
+discover your package as it's listed in \fBnpm search\fP\|\.
.SH homepage
.P
The url to the project homepage\.
@@ -101,7 +101,7 @@ It should look like this:
You can specify either one or both values\. If you want to provide only a url,
you can specify the value for "bugs" as a simple string instead of an object\.
.P
-If a url is provided, it will be used by the \fBnpm bugs\fR command\.
+If a url is provided, it will be used by the \fBnpm bugs\fP command\.
.SH license
.P
You should specify a license for your package so that people know how they are
@@ -134,11 +134,11 @@ you are using a custom license, use the following valid SPDX expression:
.P
.RS 2
.nf
-{ "license" : "LicenseRef\-LICENSE" }
+{ "license" : "SEE LICENSE IN " }
.fi
.RE
.P
-Then include a LICENSE file at the top level of the package\.
+Then include a file named \fB\fP at the top level of the package\.
.P
Some old packages used license objects or a "licenses" property containing an
array of license objects:
@@ -175,6 +175,17 @@ Those styles are now deprecated\. Instead, use SPDX expressions, like this:
{ "license": "(MIT OR Apache\-2\.0)" }
.fi
.RE
+.P
+Finally, if you do not wish to grant others the right to use a private or
+unpublished package under any terms:
+.P
+.RS 2
+.nf
+{ "license": "UNLICENSED"}
+.fi
+.RE
+.P
+Consider also setting \fB"private": true\fP to prevent accidental publication\.
.SH people fields: author, contributors
.P
The "author" is one person\. "contributors" is an array of people\. A "person"
@@ -210,11 +221,49 @@ You can also provide a "\.npmignore" file in the root of your package,
which will keep files from being included, even if they would be picked
up by the files array\. The "\.npmignore" file works just like a
"\.gitignore"\.
+.P
+Certain files are always included, regardless of settings:
+.RS 0
+.IP \(bu 2
+\fBpackage\.json\fP
+.IP \(bu 2
+\fBREADME\fP (and its variants)
+.IP \(bu 2
+\fBCHANGELOG\fP (and its variants)
+.IP \(bu 2
+\fBLICENSE\fP / \fBLICENCE\fP
+
+.RE
+.P
+Conversely, some files are always ignored:
+.RS 0
+.IP \(bu 2
+\fB\|\.git\fP
+.IP \(bu 2
+\fBCVS\fP
+.IP \(bu 2
+\fB\|\.svn\fP
+.IP \(bu 2
+\fB\|\.hg\fP
+.IP \(bu 2
+\fB\|\.lock\-wscript\fP
+.IP \(bu 2
+\fB\|\.wafpickle\-N\fP
+.IP \(bu 2
+\fB*\.swp\fP
+.IP \(bu 2
+\fB\|\.DS_Store\fP
+.IP \(bu 2
+\fB\|\._*\fP
+.IP \(bu 2
+\fBnpm\-debug\.log\fP
+
+.RE
.SH main
.P
The main field is a module ID that is the primary entry point to your program\.
-That is, if your package is named \fBfoo\fR, and a user installs it, and then does
-\fBrequire("foo")\fR, then your main module's exports object will be returned\.
+That is, if your package is named \fBfoo\fP, and a user installs it, and then does
+\fBrequire("foo")\fP, then your main module's exports object will be returned\.
.P
This should be a module ID relative to the root of your package folder\.
.P
@@ -226,9 +275,9 @@ A lot of packages have one or more executable files that they'd like to
install into the PATH\. npm makes this pretty easy (in fact, it uses this
feature to install the "npm" executable\.)
.P
-To use this, supply a \fBbin\fR field in your package\.json which is a map of
+To use this, supply a \fBbin\fP field in your package\.json which is a map of
command name to local file name\. On install, npm will symlink that file into
-\fBprefix/bin\fR for global installs, or \fB\|\./node_modules/\.bin/\fR for local
+\fBprefix/bin\fP for global installs, or \fB\|\./node_modules/\.bin/\fP for local
installs\.
.P
For example, myapp could have this:
@@ -239,8 +288,8 @@ For example, myapp could have this:
.fi
.RE
.P
-So, when you install myapp, it'll create a symlink from the \fBcli\.js\fR script to
-\fB/usr/local/bin/myapp\fR\|\.
+So, when you install myapp, it'll create a symlink from the \fBcli\.js\fP script to
+\fB/usr/local/bin/myapp\fP\|\.
.P
If you have a single executable, and its name should be the name
of the package, then you can just supply it as a string\. For example:
@@ -265,10 +314,10 @@ would be the same as this:
.SH man
.P
Specify either a single file or an array of filenames to put in place for the
-\fBman\fR program to find\.
+\fBman\fP program to find\.
.P
If only a single file is provided, then it's installed such that it is the
-result from \fBman \fR, regardless of its actual filename\. For example:
+result from \fBman \fP, regardless of its actual filename\. For example:
.P
.RS 2
.nf
@@ -281,7 +330,7 @@ result from \fBman \fR, regardless of its actual filename\. For exampl
.fi
.RE
.P
-would link the \fB\|\./man/doc\.1\fR file in such that it is the target for \fBman foo\fR
+would link the \fB\|\./man/doc\.1\fP file in such that it is the target for \fBman foo\fP
.P
If the filename doesn't start with the package name, then it's prefixed\.
So, this:
@@ -297,9 +346,9 @@ So, this:
.fi
.RE
.P
-will create files to do \fBman foo\fR and \fBman foo\-bar\fR\|\.
+will create files to do \fBman foo\fP and \fBman foo\-bar\fP\|\.
.P
-Man files must end with a number, and optionally a \fB\|\.gz\fR suffix if they are
+Man files must end with a number, and optionally a \fB\|\.gz\fP suffix if they are
compressed\. The number dictates which man section the file is installed into\.
.P
.RS 2
@@ -313,11 +362,11 @@ compressed\. The number dictates which man section the file is installed into\.
.fi
.RE
.P
-will create entries for \fBman foo\fR and \fBman 2 foo\fR
+will create entries for \fBman foo\fP and \fBman 2 foo\fP
.SH directories
.P
The CommonJS Packages \fIhttp://wiki\.commonjs\.org/wiki/Packages/1\.0\fR spec details a
-few ways that you can indicate the structure of your package using a \fBdirectories\fR
+few ways that you can indicate the structure of your package using a \fBdirectories\fP
object\. If you look at npm's package\.json \fIhttps://registry\.npmjs\.org/npm/latest\fR,
you'll see that it has directories for doc, lib, and man\.
.P
@@ -328,10 +377,13 @@ Tell people where the bulk of your library is\. Nothing special is done
with the lib folder in any way, but it's useful meta info\.
.SS directories\.bin
.P
-If you specify a \fBbin\fR directory, then all the files in that folder will
-be added as children of the \fBbin\fR path\.
+If you specify a \fBbin\fP directory in \fBdirectories\.bin\fP, all the files in
+that folder will be added\.
.P
-If you have a \fBbin\fR path already, then this has no effect\.
+Because of the way the \fBbin\fP directive works, specifying both a
+\fBbin\fP path and setting \fBdirectories\.bin\fP is an error\. If you want to
+specify individual files, use \fBbin\fP, and for all the files in an
+existing \fBbin\fP directory, use \fBdirectories\.bin\fP\|\.
.SS directories\.man
.P
A folder that is full of man pages\. Sugar to generate a "man" array by
@@ -346,7 +398,7 @@ Put example scripts in here\. Someday, it might be exposed in some clever way\.
.SH repository
.P
Specify the place where your code lives\. This is helpful for people who
-want to contribute\. If the git repo is on GitHub, then the \fBnpm docs\fR
+want to contribute\. If the git repo is on GitHub, then the \fBnpm docs\fP
command will be able to find you\.
.P
Do it like this:
@@ -370,7 +422,7 @@ directly to a VCS program without any modification\. It should not be a url to
html project page that you put in your browser\. It's for computers\.
.P
For GitHub, GitHub gist, Bitbucket, or GitLab repositories you can use the same
-shortcut syntax you use for \fBnpm install\fR:
+shortcut syntax you use for \fBnpm install\fP:
.P
.RS 2
.nf
@@ -389,7 +441,7 @@ The "scripts" property is a dictionary containing script commands that are run
at various times in the lifecycle of your package\. The key is the lifecycle
event, and the value is the command to run at that point\.
.P
-See npm help 7 \fBnpm\-scripts\fR to find out more about writing package scripts\.
+See npm help 7 \fBnpm\-scripts\fP to find out more about writing package scripts\.
.SH config
.P
A "config" object can be used to set configuration parameters used in package
@@ -404,10 +456,10 @@ following:
.RE
.P
and then had a "start" command that then referenced the
-\fBnpm_package_config_port\fR environment variable, then the user could
-override that by doing \fBnpm config set foo:port 8001\fR\|\.
+\fBnpm_package_config_port\fP environment variable, then the user could
+override that by doing \fBnpm config set foo:port 8001\fP\|\.
.P
-See npm help 7 \fBnpm\-config\fR and npm help 7 \fBnpm\-scripts\fR for more on package
+See npm help 7 \fBnpm\-config\fP and npm help 7 \fBnpm\-scripts\fP for more on package
configs\.
.SH dependencies
.P
@@ -417,44 +469,44 @@ space\-separated descriptors\. Dependencies can also be identified with a
tarball or git URL\.
.P
\fBPlease do not put test harnesses or transpilers in your
-\fBdependencies\fR object\.\fR See \fBdevDependencies\fR, below\.
+\fBdependencies\fP object\.\fR See \fBdevDependencies\fP, below\.
.P
See npm help 7 semver for more details about specifying version ranges\.
.RS 0
.IP \(bu 2
-\fBversion\fR Must match \fBversion\fR exactly
+\fBversion\fP Must match \fBversion\fP exactly
.IP \(bu 2
-\fB>version\fR Must be greater than \fBversion\fR
+\fB>version\fP Must be greater than \fBversion\fP
.IP \(bu 2
-\fB>=version\fR etc
+\fB>=version\fP etc
.IP \(bu 2
-\fB=version1 <=version2\fR\|\.
+\fBversion1 \- version2\fP Same as \fB>=version1 <=version2\fP\|\.
.IP \(bu 2
-\fBrange1 || range2\fR Passes if either range1 or range2 are satisfied\.
+\fBrange1 || range2\fP Passes if either range1 or range2 are satisfied\.
.IP \(bu 2
-\fBgit\.\.\.\fR See 'Git URLs as Dependencies' below
+\fBgit\.\.\.\fP See 'Git URLs as Dependencies' below
.IP \(bu 2
-\fBuser/repo\fR See 'GitHub URLs' below
+\fBuser/repo\fP See 'GitHub URLs' below
.IP \(bu 2
-\fBtag\fR A specific version tagged and published as \fBtag\fR See npm help \fBnpm\-tag\fR
+\fBtag\fP A specific version tagged and published as \fBtag\fP See npm help \fBnpm\-tag\fP
.IP \(bu 2
-\fBpath/path/path\fR See Local Paths below
+\fBpath/path/path\fP See Local Paths below
.RE
.P
@@ -499,12 +551,12 @@ git+https://user@hostname/project/blah\.git#commit\-ish
.fi
.RE
.P
-The \fBcommit\-ish\fR can be any tag, sha, or branch which can be supplied as
-an argument to \fBgit checkout\fR\|\. The default is \fBmaster\fR\|\.
+The \fBcommit\-ish\fP can be any tag, sha, or branch which can be supplied as
+an argument to \fBgit checkout\fP\|\. The default is \fBmaster\fP\|\.
.SH GitHub URLs
.P
As of version 1\.1\.65, you can refer to GitHub urls as just "foo":
-"user/foo\-project"\. Just as with git URLs, a \fBcommit\-ish\fR suffix can be
+"user/foo\-project"\. Just as with git URLs, a \fBcommit\-ish\fP suffix can be
included\. For example:
.P
.RS 2
@@ -522,7 +574,7 @@ included\. For example:
.SH Local Paths
.P
As of version 2\.0\.0 you can provide a path to a local directory that contains a
-package\. Local paths can be saved using \fBnpm install \-\-save\fR, using any of
+package\. Local paths can be saved using \fBnpm install \-\-save\fP, using any of
these forms:
.P
.RS 2
@@ -535,7 +587,7 @@ these forms:
.RE
.P
in which case they will be normalized to a relative path and added to your
-\fBpackage\.json\fR\|\. For example:
+\fBpackage\.json\fP\|\. For example:
.P
.RS 2
.nf
@@ -558,15 +610,15 @@ If someone is planning on downloading and using your module in their
program, then they probably don't want or need to download and build
the external test or documentation framework that you use\.
.P
-In this case, it's best to map these additional items in a \fBdevDependencies\fR
+In this case, it's best to map these additional items in a \fBdevDependencies\fP
object\.
.P
-These things will be installed when doing \fBnpm link\fR or \fBnpm install\fR
+These things will be installed when doing \fBnpm link\fP or \fBnpm install\fP
from the root of a package, and can be managed like any other npm
-configuration param\. See npm help 7 \fBnpm\-config\fR for more on the topic\.
+configuration param\. See npm help 7 \fBnpm\-config\fP for more on the topic\.
.P
For build steps that are not platform\-specific, such as compiling
-CoffeeScript or other languages to JavaScript, use the \fBprepublish\fR
+CoffeeScript or other languages to JavaScript, use the \fBprepublish\fP
script to do this, and make the required package a devDependency\.
.P
For example:
@@ -587,14 +639,14 @@ For example:
.fi
.RE
.P
-The \fBprepublish\fR script will be run before publishing, so that users
+The \fBprepublish\fP script will be run before publishing, so that users
can consume the functionality without requiring them to compile it
-themselves\. In dev mode (ie, locally running \fBnpm install\fR), it'll
+themselves\. In dev mode (ie, locally running \fBnpm install\fP), it'll
run this script as well, so that you can test it easily\.
.SH peerDependencies
.P
In some cases, you want to express the compatibility of your package with a
-host tool or library, while not necessarily doing a \fBrequire\fR of this host\.
+host tool or library, while not necessarily doing a \fBrequire\fP of this host\.
This is usually referred to as a \fIplugin\fR\|\. Notably, your module may be exposing
a specific interface, expected and specified by the host documentation\.
.P
@@ -612,8 +664,8 @@ For example:
.fi
.RE
.P
-This ensures your package \fBtea\-latte\fR can be installed \fIalong\fR with the second
-major version of the host package \fBtea\fR only\. \fBnpm install tea\-latte\fR could
+This ensures your package \fBtea\-latte\fP can be installed \fIalong\fR with the second
+major version of the host package \fBtea\fP only\. \fBnpm install tea\-latte\fP could
possibly yield the following dependency graph:
.P
.RS 2
@@ -623,7 +675,7 @@ possibly yield the following dependency graph:
.fi
.RE
.P
-\fBNOTE: npm versions 1 and 2 will automatically install \fBpeerDependencies\fR if
+\fBNOTE: npm versions 1 and 2 will automatically install \fBpeerDependencies\fP if
they are not explicitly depended upon higher in the dependency tree\. In the
next major version of npm (npm@3), this will no longer be the case\. You will
receive a warning that the peerDependency is not installed instead\.\fR The
@@ -636,19 +688,19 @@ possible, and not to lock it down to specific patch versions\.
.P
Assuming the host complies with semver \fIhttp://semver\.org/\fR, only changes in
the host package's major version will break your plugin\. Thus, if you've worked
-with every 1\.x version of the host package, use \fB"^1\.0"\fR or \fB"1\.x"\fR to express
-this\. If you depend on features introduced in 1\.5\.2, use \fB">= 1\.5\.2 < 2"\fR\|\.
+with every 1\.x version of the host package, use \fB"^1\.0"\fP or \fB"1\.x"\fP to express
+this\. If you depend on features introduced in 1\.5\.2, use \fB">= 1\.5\.2 < 2"\fP\|\.
.SH bundledDependencies
.P
Array of package names that will be bundled when publishing the package\.
.P
-If this is spelled \fB"bundleDependencies"\fR, then that is also honorable\.
+If this is spelled \fB"bundleDependencies"\fP, then that is also honorable\.
.SH optionalDependencies
.P
If a dependency can be used, but you would like npm to proceed if it cannot be
-found or fails to install, then you may put it in the \fBoptionalDependencies\fR
+found or fails to install, then you may put it in the \fBoptionalDependencies\fP
object\. This is a map of package name to version or url, just like the
-\fBdependencies\fR object\. The difference is that build failures do not cause
+\fBdependencies\fP object\. The difference is that build failures do not cause
installation to fail\.
.P
It is still your program's responsibility to handle the lack of the
@@ -674,8 +726,8 @@ if (foo) {
.fi
.RE
.P
-Entries in \fBoptionalDependencies\fR will override entries of the same name in
-\fBdependencies\fR, so it's usually best to only put in one place\.
+Entries in \fBoptionalDependencies\fP will override entries of the same name in
+\fBdependencies\fP, so it's usually best to only put in one place\.
.SH engines
.P
You can specify the version of node that your stuff works on:
@@ -702,16 +754,16 @@ are capable of properly installing your program\. For example:
.fi
.RE
.P
-Note that, unless the user has set the \fBengine\-strict\fR config flag, this
+Note that, unless the user has set the \fBengine\-strict\fP config flag, this
field is advisory only\.
.SH engineStrict
.P
\fBNOTE: This feature is deprecated and will be removed in npm 3\.0\.0\.\fR
.P
If you are sure that your module will \fIdefinitely not\fR run properly on
-versions of Node/npm other than those specified in the \fBengines\fR object,
-then you can set \fB"engineStrict": true\fR in your package\.json file\.
-This will override the user's \fBengine\-strict\fR config setting\.
+versions of Node/npm other than those specified in the \fBengines\fP object,
+then you can set \fB"engineStrict": true\fP in your package\.json file\.
+This will override the user's \fBengine\-strict\fP config setting\.
.P
Please do not do this unless you are really very very sure\. If your
engines object is something overly restrictive, you can quite easily and
@@ -737,7 +789,7 @@ just prepend the blacklisted os with a '!':
.fi
.RE
.P
-The host operating system is determined by \fBprocess\.platform\fR
+The host operating system is determined by \fBprocess\.platform\fP
.P
It is allowed to both blacklist, and whitelist, although there isn't any
good reason to do this\.
@@ -752,7 +804,7 @@ you can specify which ones\.
.fi
.RE
.P
-Like the \fBos\fR option, you can also blacklist architectures:
+Like the \fBos\fP option, you can also blacklist architectures:
.P
.RS 2
.nf
@@ -760,54 +812,54 @@ Like the \fBos\fR option, you can also blacklist architectures:
.fi
.RE
.P
-The host architecture is determined by \fBprocess\.arch\fR
+The host architecture is determined by \fBprocess\.arch\fP
.SH preferGlobal
.P
If your package is primarily a command\-line application that should be
-installed globally, then set this value to \fBtrue\fR to provide a warning
+installed globally, then set this value to \fBtrue\fP to provide a warning
if it is installed locally\.
.P
It doesn't actually prevent users from installing it locally, but it
does help prevent some confusion if it doesn't work as expected\.
.SH private
.P
-If you set \fB"private": true\fR in your package\.json, then npm will refuse
+If you set \fB"private": true\fP in your package\.json, then npm will refuse
to publish it\.
.P
This is a way to prevent accidental publication of private repositories\. If
you would like to ensure that a given package is only ever published to a
specific registry (for example, an internal registry), then use the
-\fBpublishConfig\fR dictionary described below to override the \fBregistry\fR config
+\fBpublishConfig\fP dictionary described below to override the \fBregistry\fP config
param at publish\-time\.
.SH publishConfig
.P
-This is a set of config values that will be used at publish\-time\. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default\.
+This is a set of config values that will be used at publish\-time\. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default\.
.P
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing\.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing\.
.P
-See npm help 7 \fBnpm\-config\fR to see the list of config options that can be
+See npm help 7 \fBnpm\-config\fP to see the list of config options that can be
overridden\.
.SH DEFAULT VALUES
.P
npm will default some values based on package contents\.
.RS 0
.IP \(bu 2
-\fB"scripts": {"start": "node server\.js"}\fR
-If there is a \fBserver\.js\fR file in the root of your package, then npm
-will default the \fBstart\fR command to \fBnode server\.js\fR\|\.
+\fB"scripts": {"start": "node server\.js"}\fP
+If there is a \fBserver\.js\fP file in the root of your package, then npm
+will default the \fBstart\fP command to \fBnode server\.js\fP\|\.
.IP \(bu 2
-\fB"scripts":{"preinstall": "node\-gyp rebuild"}\fR
-If there is a \fBbinding\.gyp\fR file in the root of your package, npm will
-default the \fBpreinstall\fR command to compile using node\-gyp\.
+\fB"scripts":{"preinstall": "node\-gyp rebuild"}\fP
+If there is a \fBbinding\.gyp\fP file in the root of your package, npm will
+default the \fBpreinstall\fP command to compile using node\-gyp\.
.IP \(bu 2
-\fB"contributors": [\.\.\.]\fR
-If there is an \fBAUTHORS\fR file in the root of your package, npm will
-treat each line as a \fBName (url)\fR format, where email and url
-are optional\. Lines which start with a \fB#\fR or are blank, will be
+\fB"contributors": [\.\.\.]\fP
+If there is an \fBAUTHORS\fP file in the root of your package, npm will
+treat each line as a \fBName (url)\fP format, where email and url
+are optional\. Lines which start with a \fB#\fP or are blank, will be
ignored\.
.RE
diff --git a/deps/npm/man/man5/npmrc.5 b/deps/npm/man/man5/npmrc.5
index 172b909b8249cd..5088566d8e27a7 100644
--- a/deps/npm/man/man5/npmrc.5
+++ b/deps/npm/man/man5/npmrc.5
@@ -1,12 +1,12 @@
-.TH "NPMRC" "5" "June 2015" "" ""
+.TH "NPMRC" "5" "August 2015" "" ""
.SH "NAME"
\fBnpmrc\fR \- The npm config files
.SH DESCRIPTION
.P
npm gets its config settings from the command line, environment
-variables, and \fBnpmrc\fR files\.
+variables, and \fBnpmrc\fP files\.
.P
-The \fBnpm config\fR command can be used to update and edit the contents
+The \fBnpm config\fP command can be used to update and edit the contents
of the user and global npmrc files\.
.P
For a list of available configuration options, see npm help 7 config\.
@@ -25,9 +25,9 @@ npm builtin config file (/path/to/npm/npmrc)
.RE
.P
-All npm config files are an ini\-formatted list of \fBkey = value\fR
+All npm config files are an ini\-formatted list of \fBkey = value\fP
parameters\. Environment variables can be replaced using
-\fB${VARIABLE_NAME}\fR\|\. For example:
+\fB${VARIABLE_NAME}\fP\|\. For example:
.P
.RS 2
.nf
@@ -49,35 +49,38 @@ key[] = "second value"
.fi
.RE
.P
-\fBNOTE:\fR Because local (per\-project or per\-user) \fB\|\.npmrc\fR files can contain
+\fBNOTE:\fR Because local (per\-project or per\-user) \fB\|\.npmrc\fP files can contain
sensitive credentials, they must be readable and writable \fIonly\fR by your user
-account (i\.e\. must have a mode of \fB0600\fR), otherwise they \fIwill be ignored by
+account (i\.e\. must have a mode of \fB0600\fP), otherwise they \fIwill be ignored by
npm!\fR
.SS Per\-project config file
.P
-When working locally in a project, a \fB\|\.npmrc\fR file in the root of the
-project (ie, a sibling of \fBnode_modules\fR and \fBpackage\.json\fR) will set
+When working locally in a project, a \fB\|\.npmrc\fP file in the root of the
+project (ie, a sibling of \fBnode_modules\fP and \fBpackage\.json\fP) will set
config values specific to this project\.
.P
Note that this only applies to the root of the project that you're
running npm in\. It has no effect when your module is published\. For
example, you can't publish a module that forces itself to install
globally, or in a different location\.
+.P
+Additionally, this file is not read in global mode, such as when running
+\fBnpm install \-g\fP\|\.
.SS Per\-user config file
.P
-\fB$HOME/\.npmrc\fR (or the \fBuserconfig\fR param, if set in the environment
+\fB$HOME/\.npmrc\fP (or the \fBuserconfig\fP param, if set in the environment
or on the command line)
.SS Global config file
.P
-\fB$PREFIX/etc/npmrc\fR (or the \fBglobalconfig\fR param, if set above):
-This file is an ini\-file formatted list of \fBkey = value\fR parameters\.
+\fB$PREFIX/etc/npmrc\fP (or the \fBglobalconfig\fP param, if set above):
+This file is an ini\-file formatted list of \fBkey = value\fP parameters\.
Environment variables can be replaced as above\.
.SS Built\-in config file
.P
-\fBpath/to/npm/itself/npmrc\fR
+\fBpath/to/npm/itself/npmrc\fP
.P
This is an unchangeable "builtin" configuration file that npm keeps
-consistent across updates\. Set fields in here using the \fB\|\./configure\fR
+consistent across updates\. Set fields in here using the \fB\|\./configure\fP
script that comes with npm\. This is primarily for distribution
maintainers to override default configs in a standard and consistent
manner\.
diff --git a/deps/npm/man/man5/package.json.5 b/deps/npm/man/man5/package.json.5
index ed3ee7c241a72b..f309144b511fa6 100644
--- a/deps/npm/man/man5/package.json.5
+++ b/deps/npm/man/man5/package.json.5
@@ -1,4 +1,4 @@
-.TH "PACKAGE\.JSON" "5" "June 2015" "" ""
+.TH "PACKAGE\.JSON" "5" "August 2015" "" ""
.SH "NAME"
\fBpackage.json\fR \- Specifics of npm's package\.json handling
.SH DESCRIPTION
@@ -7,7 +7,7 @@ This document is all you need to know about what's required in your package\.jso
file\. It must be actual JSON, not just a JavaScript object literal\.
.P
A lot of the behavior described in this document is affected by the config
-settings described in npm help 7 \fBnpm\-config\fR\|\.
+settings described in npm help 7 \fBnpm\-config\fP\|\.
.SH name
.P
The \fImost\fR important things in your package\.json are the name and version fields\.
@@ -50,8 +50,8 @@ already, before you get too attached to it\. https://www\.npmjs\.com/
.RE
.P
-A name can be optionally prefixed by a scope, e\.g\. \fB@myorg/mypackage\fR\|\. See
-npm help 7 \fBnpm\-scope\fR for more detail\.
+A name can be optionally prefixed by a scope, e\.g\. \fB@myorg/mypackage\fP\|\. See
+npm help 7 \fBnpm\-scope\fP for more detail\.
.SH version
.P
The \fImost\fR important things in your package\.json are the name and version fields\.
@@ -62,17 +62,17 @@ changes to the version\.
.P
Version must be parseable by
node\-semver \fIhttps://github\.com/isaacs/node\-semver\fR, which is bundled
-with npm as a dependency\. (\fBnpm install semver\fR to use it yourself\.)
+with npm as a dependency\. (\fBnpm install semver\fP to use it yourself\.)
.P
More on version numbers and ranges at npm help 7 semver\.
.SH description
.P
Put a description in it\. It's a string\. This helps people discover your
-package, as it's listed in \fBnpm search\fR\|\.
+package, as it's listed in \fBnpm search\fP\|\.
.SH keywords
.P
Put keywords in it\. It's an array of strings\. This helps people
-discover your package as it's listed in \fBnpm search\fR\|\.
+discover your package as it's listed in \fBnpm search\fP\|\.
.SH homepage
.P
The url to the project homepage\.
@@ -101,7 +101,7 @@ It should look like this:
You can specify either one or both values\. If you want to provide only a url,
you can specify the value for "bugs" as a simple string instead of an object\.
.P
-If a url is provided, it will be used by the \fBnpm bugs\fR command\.
+If a url is provided, it will be used by the \fBnpm bugs\fP command\.
.SH license
.P
You should specify a license for your package so that people know how they are
@@ -134,11 +134,11 @@ you are using a custom license, use the following valid SPDX expression:
.P
.RS 2
.nf
-{ "license" : "LicenseRef\-LICENSE" }
+{ "license" : "SEE LICENSE IN " }
.fi
.RE
.P
-Then include a LICENSE file at the top level of the package\.
+Then include a file named \fB\fP at the top level of the package\.
.P
Some old packages used license objects or a "licenses" property containing an
array of license objects:
@@ -175,6 +175,17 @@ Those styles are now deprecated\. Instead, use SPDX expressions, like this:
{ "license": "(MIT OR Apache\-2\.0)" }
.fi
.RE
+.P
+Finally, if you do not wish to grant others the right to use a private or
+unpublished package under any terms:
+.P
+.RS 2
+.nf
+{ "license": "UNLICENSED"}
+.fi
+.RE
+.P
+Consider also setting \fB"private": true\fP to prevent accidental publication\.
.SH people fields: author, contributors
.P
The "author" is one person\. "contributors" is an array of people\. A "person"
@@ -210,11 +221,49 @@ You can also provide a "\.npmignore" file in the root of your package,
which will keep files from being included, even if they would be picked
up by the files array\. The "\.npmignore" file works just like a
"\.gitignore"\.
+.P
+Certain files are always included, regardless of settings:
+.RS 0
+.IP \(bu 2
+\fBpackage\.json\fP
+.IP \(bu 2
+\fBREADME\fP (and its variants)
+.IP \(bu 2
+\fBCHANGELOG\fP (and its variants)
+.IP \(bu 2
+\fBLICENSE\fP / \fBLICENCE\fP
+
+.RE
+.P
+Conversely, some files are always ignored:
+.RS 0
+.IP \(bu 2
+\fB\|\.git\fP
+.IP \(bu 2
+\fBCVS\fP
+.IP \(bu 2
+\fB\|\.svn\fP
+.IP \(bu 2
+\fB\|\.hg\fP
+.IP \(bu 2
+\fB\|\.lock\-wscript\fP
+.IP \(bu 2
+\fB\|\.wafpickle\-N\fP
+.IP \(bu 2
+\fB*\.swp\fP
+.IP \(bu 2
+\fB\|\.DS_Store\fP
+.IP \(bu 2
+\fB\|\._*\fP
+.IP \(bu 2
+\fBnpm\-debug\.log\fP
+
+.RE
.SH main
.P
The main field is a module ID that is the primary entry point to your program\.
-That is, if your package is named \fBfoo\fR, and a user installs it, and then does
-\fBrequire("foo")\fR, then your main module's exports object will be returned\.
+That is, if your package is named \fBfoo\fP, and a user installs it, and then does
+\fBrequire("foo")\fP, then your main module's exports object will be returned\.
.P
This should be a module ID relative to the root of your package folder\.
.P
@@ -226,9 +275,9 @@ A lot of packages have one or more executable files that they'd like to
install into the PATH\. npm makes this pretty easy (in fact, it uses this
feature to install the "npm" executable\.)
.P
-To use this, supply a \fBbin\fR field in your package\.json which is a map of
+To use this, supply a \fBbin\fP field in your package\.json which is a map of
command name to local file name\. On install, npm will symlink that file into
-\fBprefix/bin\fR for global installs, or \fB\|\./node_modules/\.bin/\fR for local
+\fBprefix/bin\fP for global installs, or \fB\|\./node_modules/\.bin/\fP for local
installs\.
.P
For example, myapp could have this:
@@ -239,8 +288,8 @@ For example, myapp could have this:
.fi
.RE
.P
-So, when you install myapp, it'll create a symlink from the \fBcli\.js\fR script to
-\fB/usr/local/bin/myapp\fR\|\.
+So, when you install myapp, it'll create a symlink from the \fBcli\.js\fP script to
+\fB/usr/local/bin/myapp\fP\|\.
.P
If you have a single executable, and its name should be the name
of the package, then you can just supply it as a string\. For example:
@@ -265,10 +314,10 @@ would be the same as this:
.SH man
.P
Specify either a single file or an array of filenames to put in place for the
-\fBman\fR program to find\.
+\fBman\fP program to find\.
.P
If only a single file is provided, then it's installed such that it is the
-result from \fBman \fR, regardless of its actual filename\. For example:
+result from \fBman \fP, regardless of its actual filename\. For example:
.P
.RS 2
.nf
@@ -281,7 +330,7 @@ result from \fBman \fR, regardless of its actual filename\. For exampl
.fi
.RE
.P
-would link the \fB\|\./man/doc\.1\fR file in such that it is the target for \fBman foo\fR
+would link the \fB\|\./man/doc\.1\fP file in such that it is the target for \fBman foo\fP
.P
If the filename doesn't start with the package name, then it's prefixed\.
So, this:
@@ -297,9 +346,9 @@ So, this:
.fi
.RE
.P
-will create files to do \fBman foo\fR and \fBman foo\-bar\fR\|\.
+will create files to do \fBman foo\fP and \fBman foo\-bar\fP\|\.
.P
-Man files must end with a number, and optionally a \fB\|\.gz\fR suffix if they are
+Man files must end with a number, and optionally a \fB\|\.gz\fP suffix if they are
compressed\. The number dictates which man section the file is installed into\.
.P
.RS 2
@@ -313,11 +362,11 @@ compressed\. The number dictates which man section the file is installed into\.
.fi
.RE
.P
-will create entries for \fBman foo\fR and \fBman 2 foo\fR
+will create entries for \fBman foo\fP and \fBman 2 foo\fP
.SH directories
.P
The CommonJS Packages \fIhttp://wiki\.commonjs\.org/wiki/Packages/1\.0\fR spec details a
-few ways that you can indicate the structure of your package using a \fBdirectories\fR
+few ways that you can indicate the structure of your package using a \fBdirectories\fP
object\. If you look at npm's package\.json \fIhttps://registry\.npmjs\.org/npm/latest\fR,
you'll see that it has directories for doc, lib, and man\.
.P
@@ -328,10 +377,13 @@ Tell people where the bulk of your library is\. Nothing special is done
with the lib folder in any way, but it's useful meta info\.
.SS directories\.bin
.P
-If you specify a \fBbin\fR directory, then all the files in that folder will
-be added as children of the \fBbin\fR path\.
+If you specify a \fBbin\fP directory in \fBdirectories\.bin\fP, all the files in
+that folder will be added\.
.P
-If you have a \fBbin\fR path already, then this has no effect\.
+Because of the way the \fBbin\fP directive works, specifying both a
+\fBbin\fP path and setting \fBdirectories\.bin\fP is an error\. If you want to
+specify individual files, use \fBbin\fP, and for all the files in an
+existing \fBbin\fP directory, use \fBdirectories\.bin\fP\|\.
.SS directories\.man
.P
A folder that is full of man pages\. Sugar to generate a "man" array by
@@ -346,7 +398,7 @@ Put example scripts in here\. Someday, it might be exposed in some clever way\.
.SH repository
.P
Specify the place where your code lives\. This is helpful for people who
-want to contribute\. If the git repo is on GitHub, then the \fBnpm docs\fR
+want to contribute\. If the git repo is on GitHub, then the \fBnpm docs\fP
command will be able to find you\.
.P
Do it like this:
@@ -370,7 +422,7 @@ directly to a VCS program without any modification\. It should not be a url to
html project page that you put in your browser\. It's for computers\.
.P
For GitHub, GitHub gist, Bitbucket, or GitLab repositories you can use the same
-shortcut syntax you use for \fBnpm install\fR:
+shortcut syntax you use for \fBnpm install\fP:
.P
.RS 2
.nf
@@ -389,7 +441,7 @@ The "scripts" property is a dictionary containing script commands that are run
at various times in the lifecycle of your package\. The key is the lifecycle
event, and the value is the command to run at that point\.
.P
-See npm help 7 \fBnpm\-scripts\fR to find out more about writing package scripts\.
+See npm help 7 \fBnpm\-scripts\fP to find out more about writing package scripts\.
.SH config
.P
A "config" object can be used to set configuration parameters used in package
@@ -404,10 +456,10 @@ following:
.RE
.P
and then had a "start" command that then referenced the
-\fBnpm_package_config_port\fR environment variable, then the user could
-override that by doing \fBnpm config set foo:port 8001\fR\|\.
+\fBnpm_package_config_port\fP environment variable, then the user could
+override that by doing \fBnpm config set foo:port 8001\fP\|\.
.P
-See npm help 7 \fBnpm\-config\fR and npm help 7 \fBnpm\-scripts\fR for more on package
+See npm help 7 \fBnpm\-config\fP and npm help 7 \fBnpm\-scripts\fP for more on package
configs\.
.SH dependencies
.P
@@ -417,44 +469,44 @@ space\-separated descriptors\. Dependencies can also be identified with a
tarball or git URL\.
.P
\fBPlease do not put test harnesses or transpilers in your
-\fBdependencies\fR object\.\fR See \fBdevDependencies\fR, below\.
+\fBdependencies\fP object\.\fR See \fBdevDependencies\fP, below\.
.P
See npm help 7 semver for more details about specifying version ranges\.
.RS 0
.IP \(bu 2
-\fBversion\fR Must match \fBversion\fR exactly
+\fBversion\fP Must match \fBversion\fP exactly
.IP \(bu 2
-\fB>version\fR Must be greater than \fBversion\fR
+\fB>version\fP Must be greater than \fBversion\fP
.IP \(bu 2
-\fB>=version\fR etc
+\fB>=version\fP etc
.IP \(bu 2
-\fB=version1 <=version2\fR\|\.
+\fBversion1 \- version2\fP Same as \fB>=version1 <=version2\fP\|\.
.IP \(bu 2
-\fBrange1 || range2\fR Passes if either range1 or range2 are satisfied\.
+\fBrange1 || range2\fP Passes if either range1 or range2 are satisfied\.
.IP \(bu 2
-\fBgit\.\.\.\fR See 'Git URLs as Dependencies' below
+\fBgit\.\.\.\fP See 'Git URLs as Dependencies' below
.IP \(bu 2
-\fBuser/repo\fR See 'GitHub URLs' below
+\fBuser/repo\fP See 'GitHub URLs' below
.IP \(bu 2
-\fBtag\fR A specific version tagged and published as \fBtag\fR See npm help \fBnpm\-tag\fR
+\fBtag\fP A specific version tagged and published as \fBtag\fP See npm help \fBnpm\-tag\fP
.IP \(bu 2
-\fBpath/path/path\fR See Local Paths below
+\fBpath/path/path\fP See Local Paths below
.RE
.P
@@ -499,12 +551,12 @@ git+https://user@hostname/project/blah\.git#commit\-ish
.fi
.RE
.P
-The \fBcommit\-ish\fR can be any tag, sha, or branch which can be supplied as
-an argument to \fBgit checkout\fR\|\. The default is \fBmaster\fR\|\.
+The \fBcommit\-ish\fP can be any tag, sha, or branch which can be supplied as
+an argument to \fBgit checkout\fP\|\. The default is \fBmaster\fP\|\.
.SH GitHub URLs
.P
As of version 1\.1\.65, you can refer to GitHub urls as just "foo":
-"user/foo\-project"\. Just as with git URLs, a \fBcommit\-ish\fR suffix can be
+"user/foo\-project"\. Just as with git URLs, a \fBcommit\-ish\fP suffix can be
included\. For example:
.P
.RS 2
@@ -522,7 +574,7 @@ included\. For example:
.SH Local Paths
.P
As of version 2\.0\.0 you can provide a path to a local directory that contains a
-package\. Local paths can be saved using \fBnpm install \-\-save\fR, using any of
+package\. Local paths can be saved using \fBnpm install \-\-save\fP, using any of
these forms:
.P
.RS 2
@@ -535,7 +587,7 @@ these forms:
.RE
.P
in which case they will be normalized to a relative path and added to your
-\fBpackage\.json\fR\|\. For example:
+\fBpackage\.json\fP\|\. For example:
.P
.RS 2
.nf
@@ -558,15 +610,15 @@ If someone is planning on downloading and using your module in their
program, then they probably don't want or need to download and build
the external test or documentation framework that you use\.
.P
-In this case, it's best to map these additional items in a \fBdevDependencies\fR
+In this case, it's best to map these additional items in a \fBdevDependencies\fP
object\.
.P
-These things will be installed when doing \fBnpm link\fR or \fBnpm install\fR
+These things will be installed when doing \fBnpm link\fP or \fBnpm install\fP
from the root of a package, and can be managed like any other npm
-configuration param\. See npm help 7 \fBnpm\-config\fR for more on the topic\.
+configuration param\. See npm help 7 \fBnpm\-config\fP for more on the topic\.
.P
For build steps that are not platform\-specific, such as compiling
-CoffeeScript or other languages to JavaScript, use the \fBprepublish\fR
+CoffeeScript or other languages to JavaScript, use the \fBprepublish\fP
script to do this, and make the required package a devDependency\.
.P
For example:
@@ -587,14 +639,14 @@ For example:
.fi
.RE
.P
-The \fBprepublish\fR script will be run before publishing, so that users
+The \fBprepublish\fP script will be run before publishing, so that users
can consume the functionality without requiring them to compile it
-themselves\. In dev mode (ie, locally running \fBnpm install\fR), it'll
+themselves\. In dev mode (ie, locally running \fBnpm install\fP), it'll
run this script as well, so that you can test it easily\.
.SH peerDependencies
.P
In some cases, you want to express the compatibility of your package with a
-host tool or library, while not necessarily doing a \fBrequire\fR of this host\.
+host tool or library, while not necessarily doing a \fBrequire\fP of this host\.
This is usually referred to as a \fIplugin\fR\|\. Notably, your module may be exposing
a specific interface, expected and specified by the host documentation\.
.P
@@ -612,8 +664,8 @@ For example:
.fi
.RE
.P
-This ensures your package \fBtea\-latte\fR can be installed \fIalong\fR with the second
-major version of the host package \fBtea\fR only\. \fBnpm install tea\-latte\fR could
+This ensures your package \fBtea\-latte\fP can be installed \fIalong\fR with the second
+major version of the host package \fBtea\fP only\. \fBnpm install tea\-latte\fP could
possibly yield the following dependency graph:
.P
.RS 2
@@ -623,7 +675,7 @@ possibly yield the following dependency graph:
.fi
.RE
.P
-\fBNOTE: npm versions 1 and 2 will automatically install \fBpeerDependencies\fR if
+\fBNOTE: npm versions 1 and 2 will automatically install \fBpeerDependencies\fP if
they are not explicitly depended upon higher in the dependency tree\. In the
next major version of npm (npm@3), this will no longer be the case\. You will
receive a warning that the peerDependency is not installed instead\.\fR The
@@ -636,19 +688,19 @@ possible, and not to lock it down to specific patch versions\.
.P
Assuming the host complies with semver \fIhttp://semver\.org/\fR, only changes in
the host package's major version will break your plugin\. Thus, if you've worked
-with every 1\.x version of the host package, use \fB"^1\.0"\fR or \fB"1\.x"\fR to express
-this\. If you depend on features introduced in 1\.5\.2, use \fB">= 1\.5\.2 < 2"\fR\|\.
+with every 1\.x version of the host package, use \fB"^1\.0"\fP or \fB"1\.x"\fP to express
+this\. If you depend on features introduced in 1\.5\.2, use \fB">= 1\.5\.2 < 2"\fP\|\.
.SH bundledDependencies
.P
Array of package names that will be bundled when publishing the package\.
.P
-If this is spelled \fB"bundleDependencies"\fR, then that is also honorable\.
+If this is spelled \fB"bundleDependencies"\fP, then that is also honorable\.
.SH optionalDependencies
.P
If a dependency can be used, but you would like npm to proceed if it cannot be
-found or fails to install, then you may put it in the \fBoptionalDependencies\fR
+found or fails to install, then you may put it in the \fBoptionalDependencies\fP
object\. This is a map of package name to version or url, just like the
-\fBdependencies\fR object\. The difference is that build failures do not cause
+\fBdependencies\fP object\. The difference is that build failures do not cause
installation to fail\.
.P
It is still your program's responsibility to handle the lack of the
@@ -674,8 +726,8 @@ if (foo) {
.fi
.RE
.P
-Entries in \fBoptionalDependencies\fR will override entries of the same name in
-\fBdependencies\fR, so it's usually best to only put in one place\.
+Entries in \fBoptionalDependencies\fP will override entries of the same name in
+\fBdependencies\fP, so it's usually best to only put in one place\.
.SH engines
.P
You can specify the version of node that your stuff works on:
@@ -702,16 +754,16 @@ are capable of properly installing your program\. For example:
.fi
.RE
.P
-Note that, unless the user has set the \fBengine\-strict\fR config flag, this
+Note that, unless the user has set the \fBengine\-strict\fP config flag, this
field is advisory only\.
.SH engineStrict
.P
\fBNOTE: This feature is deprecated and will be removed in npm 3\.0\.0\.\fR
.P
If you are sure that your module will \fIdefinitely not\fR run properly on
-versions of Node/npm other than those specified in the \fBengines\fR object,
-then you can set \fB"engineStrict": true\fR in your package\.json file\.
-This will override the user's \fBengine\-strict\fR config setting\.
+versions of Node/npm other than those specified in the \fBengines\fP object,
+then you can set \fB"engineStrict": true\fP in your package\.json file\.
+This will override the user's \fBengine\-strict\fP config setting\.
.P
Please do not do this unless you are really very very sure\. If your
engines object is something overly restrictive, you can quite easily and
@@ -737,7 +789,7 @@ just prepend the blacklisted os with a '!':
.fi
.RE
.P
-The host operating system is determined by \fBprocess\.platform\fR
+The host operating system is determined by \fBprocess\.platform\fP
.P
It is allowed to both blacklist, and whitelist, although there isn't any
good reason to do this\.
@@ -752,7 +804,7 @@ you can specify which ones\.
.fi
.RE
.P
-Like the \fBos\fR option, you can also blacklist architectures:
+Like the \fBos\fP option, you can also blacklist architectures:
.P
.RS 2
.nf
@@ -760,54 +812,54 @@ Like the \fBos\fR option, you can also blacklist architectures:
.fi
.RE
.P
-The host architecture is determined by \fBprocess\.arch\fR
+The host architecture is determined by \fBprocess\.arch\fP
.SH preferGlobal
.P
If your package is primarily a command\-line application that should be
-installed globally, then set this value to \fBtrue\fR to provide a warning
+installed globally, then set this value to \fBtrue\fP to provide a warning
if it is installed locally\.
.P
It doesn't actually prevent users from installing it locally, but it
does help prevent some confusion if it doesn't work as expected\.
.SH private
.P
-If you set \fB"private": true\fR in your package\.json, then npm will refuse
+If you set \fB"private": true\fP in your package\.json, then npm will refuse
to publish it\.
.P
This is a way to prevent accidental publication of private repositories\. If
you would like to ensure that a given package is only ever published to a
specific registry (for example, an internal registry), then use the
-\fBpublishConfig\fR dictionary described below to override the \fBregistry\fR config
+\fBpublishConfig\fP dictionary described below to override the \fBregistry\fP config
param at publish\-time\.
.SH publishConfig
.P
-This is a set of config values that will be used at publish\-time\. It's
-especially handy if you want to set the tag or registry, so that you can
-ensure that a given package is not tagged with "latest" or published to
-the global public registry by default\.
+This is a set of config values that will be used at publish\-time\. It's
+especially handy if you want to set the tag, registry or access, so that
+you can ensure that a given package is not tagged with "latest", published
+to the global public registry or that a scoped module is private by default\.
.P
-Any config values can be overridden, but of course only "tag" and
-"registry" probably matter for the purposes of publishing\.
+Any config values can be overridden, but of course only "tag", "registry" and
+"access" probably matter for the purposes of publishing\.
.P
-See npm help 7 \fBnpm\-config\fR to see the list of config options that can be
+See npm help 7 \fBnpm\-config\fP to see the list of config options that can be
overridden\.
.SH DEFAULT VALUES
.P
npm will default some values based on package contents\.
.RS 0
.IP \(bu 2
-\fB"scripts": {"start": "node server\.js"}\fR
-If there is a \fBserver\.js\fR file in the root of your package, then npm
-will default the \fBstart\fR command to \fBnode server\.js\fR\|\.
+\fB"scripts": {"start": "node server\.js"}\fP
+If there is a \fBserver\.js\fP file in the root of your package, then npm
+will default the \fBstart\fP command to \fBnode server\.js\fP\|\.
.IP \(bu 2
-\fB"scripts":{"preinstall": "node\-gyp rebuild"}\fR
-If there is a \fBbinding\.gyp\fR file in the root of your package, npm will
-default the \fBpreinstall\fR command to compile using node\-gyp\.
+\fB"scripts":{"preinstall": "node\-gyp rebuild"}\fP
+If there is a \fBbinding\.gyp\fP file in the root of your package, npm will
+default the \fBpreinstall\fP command to compile using node\-gyp\.
.IP \(bu 2
-\fB"contributors": [\.\.\.]\fR
-If there is an \fBAUTHORS\fR file in the root of your package, npm will
-treat each line as a \fBName (url)\fR format, where email and url
-are optional\. Lines which start with a \fB#\fR or are blank, will be
+\fB"contributors": [\.\.\.]\fP
+If there is an \fBAUTHORS\fP file in the root of your package, npm will
+treat each line as a \fBName (url)\fP format, where email and url
+are optional\. Lines which start with a \fB#\fP or are blank, will be
ignored\.
.RE
diff --git a/deps/npm/man/man7/npm-coding-style.7 b/deps/npm/man/man7/npm-coding-style.7
index ce9923214e0195..e8487a91f0e9e5 100644
--- a/deps/npm/man/man7/npm-coding-style.7
+++ b/deps/npm/man/man7/npm-coding-style.7
@@ -1,4 +1,4 @@
-.TH "NPM\-CODING\-STYLE" "7" "June 2015" "" ""
+.TH "NPM\-CODING\-STYLE" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-coding-style\fR \- npm's "funny" coding style
.SH DESCRIPTION
@@ -71,14 +71,14 @@ while (foo) {
Don't use them except in four situations:
.RS 0
.IP \(bu 2
-\fBfor (;;)\fR loops\. They're actually required\.
+\fBfor (;;)\fP loops\. They're actually required\.
.IP \(bu 2
-null loops like: \fBwhile (something) ;\fR (But you'd better have a good
+null loops like: \fBwhile (something) ;\fP (But you'd better have a good
reason for doing that\.)
.IP \(bu 2
-\fBcase "foo": doSomething(); break\fR
+\fBcase "foo": doSomething(); break\fP
.IP \(bu 2
-In front of a leading \fB(\fR or \fB[\fR at the start of the line\.
+In front of a leading \fB(\fP or \fB[\fP at the start of the line\.
This prevents the expression from being interpreted
as a function call or property access, respectively\.
@@ -101,7 +101,7 @@ for (var i = 0; i < 10; i ++) {
.fi
.RE
.P
-Note that starting lines with \fB\-\fR and \fB+\fR also should be prefixed
+Note that starting lines with \fB\-\fP and \fB+\fP also should be prefixed
with a semicolon, but this is much less common\.
.SH Comma First
.P
@@ -161,20 +161,20 @@ logging the same object over and over again is not helpful\. Logs should
report what's happening so that it's easier to track down where a fault
occurs\.
.P
-Use appropriate log levels\. See npm help 7 \fBnpm\-config\fR and search for
+Use appropriate log levels\. See npm help 7 \fBnpm\-config\fP and search for
"loglevel"\.
.SH Case, naming, etc\.
.P
-Use \fBlowerCamelCase\fR for multiword identifiers when they refer to objects,
+Use \fBlowerCamelCase\fP for multiword identifiers when they refer to objects,
functions, methods, properties, or anything not specified in this section\.
.P
-Use \fBUpperCamelCase\fR for class names (things that you'd pass to "new")\.
+Use \fBUpperCamelCase\fP for class names (things that you'd pass to "new")\.
.P
-Use \fBall\-lower\-hyphen\-css\-case\fR for multiword filenames and config keys\.
+Use \fBall\-lower\-hyphen\-css\-case\fP for multiword filenames and config keys\.
.P
Use named functions\. They make stack traces easier to follow\.
.P
-Use \fBCAPS_SNAKE_CASE\fR for constants, things that should never change
+Use \fBCAPS_SNAKE_CASE\fP for constants, things that should never change
and are rarely used\.
.P
Use a single uppercase letter for function names where the function
@@ -182,12 +182,12 @@ would normally be anonymous, but needs to call itself recursively\. It
makes it clear that it's a "throwaway" function\.
.SH null, undefined, false, 0
.P
-Boolean variables and functions should always be either \fBtrue\fR or
-\fBfalse\fR\|\. Don't set it to 0 unless it's supposed to be a number\.
+Boolean variables and functions should always be either \fBtrue\fP or
+\fBfalse\fP\|\. Don't set it to 0 unless it's supposed to be a number\.
.P
-When something is intentionally missing or removed, set it to \fBnull\fR\|\.
+When something is intentionally missing or removed, set it to \fBnull\fP\|\.
.P
-Don't set things to \fBundefined\fR\|\. Reserve that value to mean "not yet
+Don't set things to \fBundefined\fP\|\. Reserve that value to mean "not yet
set to anything\."
.P
Boolean objects are verboten\.
diff --git a/deps/npm/man/man7/npm-config.7 b/deps/npm/man/man7/npm-config.7
index 5e4a9a2af7a527..b99b699c53c581 100644
--- a/deps/npm/man/man7/npm-config.7
+++ b/deps/npm/man/man7/npm-config.7
@@ -1,4 +1,4 @@
-.TH "NPM\-CONFIG" "7" "June 2015" "" ""
+.TH "NPM\-CONFIG" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-config\fR \- More than you probably want to know about npm configuration
.SH DESCRIPTION
@@ -6,18 +6,18 @@
npm gets its configuration values from the following sources, sorted by priority:
.SS Command Line Flags
.P
-Putting \fB\-\-foo bar\fR on the command line sets the \fBfoo\fR configuration
-parameter to \fB"bar"\fR\|\. A \fB\-\-\fR argument tells the cli parser to stop
-reading flags\. A \fB\-\-flag\fR parameter that is at the \fIend\fR of the
-command will be given the value of \fBtrue\fR\|\.
+Putting \fB\-\-foo bar\fP on the command line sets the \fBfoo\fP configuration
+parameter to \fB"bar"\fP\|\. A \fB\-\-\fP argument tells the cli parser to stop
+reading flags\. A \fB\-\-flag\fP parameter that is at the \fIend\fR of the
+command will be given the value of \fBtrue\fP\|\.
.SS Environment Variables
.P
-Any environment variables that start with \fBnpm_config_\fR will be
+Any environment variables that start with \fBnpm_config_\fP will be
interpreted as a configuration parameter\. For example, putting
-\fBnpm_config_foo=bar\fR in your environment will set the \fBfoo\fR
-configuration parameter to \fBbar\fR\|\. Any environment configurations that
-are not given a value will be given the value of \fBtrue\fR\|\. Config
-values are case\-insensitive, so \fBNPM_CONFIG_FOO=bar\fR will work the
+\fBnpm_config_foo=bar\fP in your environment will set the \fBfoo\fP
+configuration parameter to \fBbar\fP\|\. Any environment configurations that
+are not given a value will be given the value of \fBtrue\fP\|\. Config
+values are case\-insensitive, so \fBNPM_CONFIG_FOO=bar\fP will work the
same\.
.SS npmrc Files
.P
@@ -44,51 +44,51 @@ defaults if nothing else is specified\.
The following shorthands are parsed on the command\-line:
.RS 0
.IP \(bu 2
-\fB\-v\fR: \fB\-\-version\fR
+\fB\-v\fP: \fB\-\-version\fP
.IP \(bu 2
-\fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR, \fB\-H\fR: \fB\-\-usage\fR
+\fB\-h\fP, \fB\-?\fP, \fB\-\-help\fP, \fB\-H\fP: \fB\-\-usage\fP
.IP \(bu 2
-\fB\-s\fR, \fB\-\-silent\fR: \fB\-\-loglevel silent\fR
+\fB\-s\fP, \fB\-\-silent\fP: \fB\-\-loglevel silent\fP
.IP \(bu 2
-\fB\-q\fR, \fB\-\-quiet\fR: \fB\-\-loglevel warn\fR
+\fB\-q\fP, \fB\-\-quiet\fP: \fB\-\-loglevel warn\fP
.IP \(bu 2
-\fB\-d\fR: \fB\-\-loglevel info\fR
+\fB\-d\fP: \fB\-\-loglevel info\fP
.IP \(bu 2
-\fB\-dd\fR, \fB\-\-verbose\fR: \fB\-\-loglevel verbose\fR
+\fB\-dd\fP, \fB\-\-verbose\fP: \fB\-\-loglevel verbose\fP
.IP \(bu 2
-\fB\-ddd\fR: \fB\-\-loglevel silly\fR
+\fB\-ddd\fP: \fB\-\-loglevel silly\fP
.IP \(bu 2
-\fB\-g\fR: \fB\-\-global\fR
+\fB\-g\fP: \fB\-\-global\fP
.IP \(bu 2
-\fB\-C\fR: \fB\-\-prefix\fR
+\fB\-C\fP: \fB\-\-prefix\fP
.IP \(bu 2
-\fB\-l\fR: \fB\-\-long\fR
+\fB\-l\fP: \fB\-\-long\fP
.IP \(bu 2
-\fB\-m\fR: \fB\-\-message\fR
+\fB\-m\fP: \fB\-\-message\fP
.IP \(bu 2
-\fB\-p\fR, \fB\-\-porcelain\fR: \fB\-\-parseable\fR
+\fB\-p\fP, \fB\-\-porcelain\fP: \fB\-\-parseable\fP
.IP \(bu 2
-\fB\-reg\fR: \fB\-\-registry\fR
+\fB\-reg\fP: \fB\-\-registry\fP
.IP \(bu 2
-\fB\-f\fR: \fB\-\-force\fR
+\fB\-f\fP: \fB\-\-force\fP
.IP \(bu 2
-\fB\-desc\fR: \fB\-\-description\fR
+\fB\-desc\fP: \fB\-\-description\fP
.IP \(bu 2
-\fB\-S\fR: \fB\-\-save\fR
+\fB\-S\fP: \fB\-\-save\fP
.IP \(bu 2
-\fB\-D\fR: \fB\-\-save\-dev\fR
+\fB\-D\fP: \fB\-\-save\-dev\fP
.IP \(bu 2
-\fB\-O\fR: \fB\-\-save\-optional\fR
+\fB\-O\fP: \fB\-\-save\-optional\fP
.IP \(bu 2
-\fB\-B\fR: \fB\-\-save\-bundle\fR
+\fB\-B\fP: \fB\-\-save\-bundle\fP
.IP \(bu 2
-\fB\-E\fR: \fB\-\-save\-exact\fR
+\fB\-E\fP: \fB\-\-save\-exact\fP
.IP \(bu 2
-\fB\-y\fR: \fB\-\-yes\fR
+\fB\-y\fP: \fB\-\-yes\fP
.IP \(bu 2
-\fB\-n\fR: \fB\-\-yes false\fR
+\fB\-n\fP: \fB\-\-yes false\fP
.IP \(bu 2
-\fBll\fR and \fBla\fR commands: \fBls \-\-long\fR
+\fBll\fP and \fBla\fP commands: \fBls \-\-long\fP
.RE
.P
@@ -118,9 +118,9 @@ npm ls \-\-global \-\-parseable \-\-long \-\-loglevel info
.RE
.SH Per\-Package Config Settings
.P
-When running scripts (see npm help 7 \fBnpm\-scripts\fR) the package\.json "config"
+When running scripts (see npm help 7 \fBnpm\-scripts\fP) the package\.json "config"
keys are overwritten in the environment if there is a config param of
-\fB[@]:\fR\|\. For example, if the package\.json has
+\fB[@]:\fP\|\. For example, if the package\.json has
this:
.P
.RS 2
@@ -152,16 +152,16 @@ See npm help 5 package\.json for more information\.
.SS access
.RS 0
.IP \(bu 2
-Default: \fBrestricted\fR
+Default: \fBrestricted\fP
.IP \(bu 2
Type: Access
.RE
.P
-When publishing scoped packages, the access level defaults to \fBrestricted\fR\|\. If
+When publishing scoped packages, the access level defaults to \fBrestricted\fP\|\. If
you want your scoped package to be publicly viewable (and installable) set
-\fB\-\-access=public\fR\|\. The only valid values for \fBaccess\fR are \fBpublic\fR and
-\fBrestricted\fR\|\. Unscoped packages \fIalways\fR have an access level of \fBpublic\fR\|\.
+\fB\-\-access=public\fP\|\. The only valid values for \fBaccess\fP are \fBpublic\fP and
+\fBrestricted\fP\|\. Unscoped packages \fIalways\fR have an access level of \fBpublic\fP\|\.
.SS always\-auth
.RS 0
.IP \(bu 2
@@ -172,17 +172,17 @@ Type: Boolean
.RE
.P
Force npm to always require authentication when accessing the registry,
-even for \fBGET\fR requests\.
+even for \fBGET\fP requests\.
.SS bin\-links
.RS 0
.IP \(bu 2
-Default: \fBtrue\fR
+Default: \fBtrue\fP
.IP \(bu 2
Type: Boolean
.RE
.P
-Tells npm to create symlinks (or \fB\|\.cmd\fR shims on Windows) for package
+Tells npm to create symlinks (or \fB\|\.cmd\fP shims on Windows) for package
executables\.
.P
Set to false to have it not do this\. This can be used to work around
@@ -191,13 +191,13 @@ ostensibly Unix systems\.
.SS browser
.RS 0
.IP \(bu 2
-Default: OS X: \fB"open"\fR, Windows: \fB"start"\fR, Others: \fB"xdg\-open"\fR
+Default: OS X: \fB"open"\fP, Windows: \fB"start"\fP, Others: \fB"xdg\-open"\fP
.IP \(bu 2
Type: String
.RE
.P
-The browser that is called by the \fBnpm docs\fR command to open websites\.
+The browser that is called by the \fBnpm docs\fP command to open websites\.
.SS ca
.RS 0
.IP \(bu 2
@@ -217,7 +217,7 @@ ca="\-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-\\nXXXX\\nXXXX\\n\-\-\-\-\-END CERTIFIC
.fi
.RE
.P
-Set to \fBnull\fR to only allow "known" registrars, or to a specific CA cert
+Set to \fBnull\fP to only allow "known" registrars, or to a specific CA cert
to trust only that specific signing authority\.
.P
Multiple CAs can be trusted by specifying an array of certificates:
@@ -229,29 +229,29 @@ ca[]="\.\.\."
.fi
.RE
.P
-See also the \fBstrict\-ssl\fR config\.
+See also the \fBstrict\-ssl\fP config\.
.SS cafile
.RS 0
.IP \(bu 2
-Default: \fBnull\fR
+Default: \fBnull\fP
.IP \(bu 2
Type: path
.RE
.P
A path to a file containing one or multiple Certificate Authority signing
-certificates\. Similar to the \fBca\fR setting, but allows for multiple CA's, as
+certificates\. Similar to the \fBca\fP setting, but allows for multiple CA's, as
well as for the CA information to be stored in a file on disk\.
.SS cache
.RS 0
.IP \(bu 2
-Default: Windows: \fB%AppData%\\npm\-cache\fR, Posix: \fB~/\.npm\fR
+Default: Windows: \fB%AppData%\\npm\-cache\fP, Posix: \fB~/\.npm\fP
.IP \(bu 2
Type: path
.RE
.P
-The location of npm's cache directory\. See npm help \fBnpm\-cache\fR
+The location of npm's cache directory\. See npm help \fBnpm\-cache\fP
.SS cache\-lock\-stale
.RS 0
.IP \(bu 2
@@ -294,7 +294,7 @@ Type: Number
The maximum time (in seconds) to keep items in the registry cache before
re\-checking against the registry\.
.P
-Note that no purging is done unless the \fBnpm cache clean\fR command is
+Note that no purging is done unless the \fBnpm cache clean\fP command is
explicitly used, and that only GET requests use the cache\.
.SS cache\-min
.RS 0
@@ -308,12 +308,12 @@ Type: Number
The minimum time (in seconds) to keep items in the registry cache before
re\-checking against the registry\.
.P
-Note that no purging is done unless the \fBnpm cache clean\fR command is
+Note that no purging is done unless the \fBnpm cache clean\fP command is
explicitly used, and that only GET requests use the cache\.
.SS cert
.RS 0
.IP \(bu 2
-Default: \fBnull\fR
+Default: \fBnull\fP
.IP \(bu 2
Type: String
@@ -325,11 +325,11 @@ A client certificate to pass when accessing the registry\.
.IP \(bu 2
Default: true on Posix, false on Windows
.IP \(bu 2
-Type: Boolean or \fB"always"\fR
+Type: Boolean or \fB"always"\fP
.RE
.P
-If false, never shows colors\. If \fB"always"\fR then always shows colors\.
+If false, never shows colors\. If \fB"always"\fP then always shows colors\.
If true, then only prints color codes for tty file descriptors\.
.SS depth
.RS 0
@@ -340,13 +340,13 @@ Type: Number
.RE
.P
-The depth to go when recursing directories for \fBnpm ls\fR,
-\fBnpm cache ls\fR, and \fBnpm outdated\fR\|\.
+The depth to go when recursing directories for \fBnpm ls\fP,
+\fBnpm cache ls\fP, and \fBnpm outdated\fP\|\.
.P
-For \fBnpm outdated\fR, a setting of \fBInfinity\fR will be treated as \fB0\fR
+For \fBnpm outdated\fP, a setting of \fBInfinity\fP will be treated as \fB0\fP
since that gives more useful information\. To show the outdated status
of all packages and dependents, use a large integer value,
-e\.g\., \fBnpm outdated \-\-depth 9999\fR
+e\.g\., \fBnpm outdated \-\-depth 9999\fP
.SS description
.RS 0
.IP \(bu 2
@@ -356,7 +356,7 @@ Type: Boolean
.RE
.P
-Show the description in \fBnpm search\fR
+Show the description in \fBnpm search\fP
.SS dev
.RS 0
.IP \(bu 2
@@ -366,21 +366,21 @@ Type: Boolean
.RE
.P
-Install \fBdev\-dependencies\fR along with packages\.
+Install \fBdev\-dependencies\fP along with packages\.
.P
-Note that \fBdev\-dependencies\fR are also installed if the \fBnpat\fR flag is
+Note that \fBdev\-dependencies\fP are also installed if the \fBnpat\fP flag is
set\.
.SS editor
.RS 0
.IP \(bu 2
-Default: \fBEDITOR\fR environment variable if set, or \fB"vi"\fR on Posix,
-or \fB"notepad"\fR on Windows\.
+Default: \fBEDITOR\fP environment variable if set, or \fB"vi"\fP on Posix,
+or \fB"notepad"\fP on Windows\.
.IP \(bu 2
Type: path
.RE
.P
-The command to run for \fBnpm edit\fR or \fBnpm config edit\fR\|\.
+The command to run for \fBnpm edit\fP or \fBnpm config edit\fP\|\.
.SS engine\-strict
.RS 0
.IP \(bu 2
@@ -423,7 +423,7 @@ Type: Number
.RE
.P
-The "retries" config for the \fBretry\fR module to use when fetching
+The "retries" config for the \fBretry\fP module to use when fetching
packages from the registry\.
.SS fetch\-retry\-factor
.RS 0
@@ -434,7 +434,7 @@ Type: Number
.RE
.P
-The "factor" config for the \fBretry\fR module to use when fetching
+The "factor" config for the \fBretry\fP module to use when fetching
packages\.
.SS fetch\-retry\-mintimeout
.RS 0
@@ -445,7 +445,7 @@ Type: Number
.RE
.P
-The "minTimeout" config for the \fBretry\fR module to use when fetching
+The "minTimeout" config for the \fBretry\fP module to use when fetching
packages\.
.SS fetch\-retry\-maxtimeout
.RS 0
@@ -456,30 +456,30 @@ Type: Number
.RE
.P
-The "maxTimeout" config for the \fBretry\fR module to use when fetching
+The "maxTimeout" config for the \fBretry\fP module to use when fetching
packages\.
.SS git
.RS 0
.IP \(bu 2
-Default: \fB"git"\fR
+Default: \fB"git"\fP
.IP \(bu 2
Type: String
.RE
.P
The command to use for git commands\. If git is installed on the
-computer, but is not in the \fBPATH\fR, then set this to the full path to
+computer, but is not in the \fBPATH\fP, then set this to the full path to
the git binary\.
.SS git\-tag\-version
.RS 0
.IP \(bu 2
-Default: \fBtrue\fR
+Default: \fBtrue\fP
.IP \(bu 2
Type: Boolean
.RE
.P
-Tag the commit when using the \fBnpm version\fR command\.
+Tag the commit when using the \fBnpm version\fP command\.
.SS global
.RS 0
.IP \(bu 2
@@ -490,16 +490,16 @@ Type: Boolean
.RE
.P
Operates in "global" mode, so that packages are installed into the
-\fBprefix\fR folder instead of the current working directory\. See
-npm help 5 \fBnpm\-folders\fR for more on the differences in behavior\.
+\fBprefix\fP folder instead of the current working directory\. See
+npm help 5 \fBnpm\-folders\fP for more on the differences in behavior\.
.RS 0
.IP \(bu 2
-packages are installed into the \fB{prefix}/lib/node_modules\fR folder, instead of the
+packages are installed into the \fB{prefix}/lib/node_modules\fP folder, instead of the
current working directory\.
.IP \(bu 2
-bin files are linked to \fB{prefix}/bin\fR
+bin files are linked to \fB{prefix}/bin\fP
.IP \(bu 2
-man pages are linked to \fB{prefix}/share/man\fR
+man pages are linked to \fB{prefix}/share/man\fP
.RE
.SS globalconfig
@@ -526,7 +526,7 @@ user\.
.SS heading
.RS 0
.IP \(bu 2
-Default: \fB"npm"\fR
+Default: \fB"npm"\fP
.IP \(bu 2
Type: String
@@ -542,9 +542,9 @@ Type: url
.RE
.P
-A proxy to use for outgoing https requests\. If the \fBHTTPS_PROXY\fR or
-\fBhttps_proxy\fR or \fBHTTP_PROXY\fR or \fBhttp_proxy\fR environment variables are set,
-proxy settings will be honored by the underlying \fBrequest\fR library\.
+A proxy to use for outgoing https requests\. If the \fBHTTPS_PROXY\fP or
+\fBhttps_proxy\fP or \fBHTTP_PROXY\fP or \fBhttp_proxy\fP environment variables are set,
+proxy settings will be honored by the underlying \fBrequest\fP library\.
.SS if\-present
.RS 0
.IP \(bu 2
@@ -554,8 +554,8 @@ Type: Boolean
.RE
.P
-If true, npm will not exit with an error code when \fBrun\-script\fR is invoked for
-a script that isn't defined in the \fBscripts\fR section of \fBpackage\.json\fR\|\. This
+If true, npm will not exit with an error code when \fBrun\-script\fP is invoked for
+a script that isn't defined in the \fBscripts\fP section of \fBpackage\.json\fP\|\. This
option can be used when it's desirable to optionally run a script when it's
present and fail if the script fails\. This is useful, for example, when running
scripts that may only apply for some builds in an otherwise generic CI setup\.
@@ -578,7 +578,7 @@ Type: path
.RE
.P
-A module that will be loaded by the \fBnpm init\fR command\. See the
+A module that will be loaded by the \fBnpm init\fP command\. See the
documentation for the
init\-package\-json \fIhttps://github\.com/isaacs/init\-package\-json\fR module
for more information, or npm help init\.
@@ -591,7 +591,7 @@ Type: String
.RE
.P
-The value \fBnpm init\fR should use by default for the package author's name\.
+The value \fBnpm init\fP should use by default for the package author's name\.
.SS init\-author\-email
.RS 0
.IP \(bu 2
@@ -601,7 +601,7 @@ Type: String
.RE
.P
-The value \fBnpm init\fR should use by default for the package author's email\.
+The value \fBnpm init\fP should use by default for the package author's email\.
.SS init\-author\-url
.RS 0
.IP \(bu 2
@@ -611,7 +611,7 @@ Type: String
.RE
.P
-The value \fBnpm init\fR should use by default for the package author's homepage\.
+The value \fBnpm init\fP should use by default for the package author's homepage\.
.SS init\-license
.RS 0
.IP \(bu 2
@@ -621,7 +621,7 @@ Type: String
.RE
.P
-The value \fBnpm init\fR should use by default for the package license\.
+The value \fBnpm init\fP should use by default for the package license\.
.SS init\-version
.RS 0
.IP \(bu 2
@@ -631,7 +631,7 @@ Type: semver
.RE
.P
-The value that \fBnpm init\fR should use by default for the package
+The value that \fBnpm init\fP should use by default for the package
version number, if not already set in package\.json\.
.SS json
.RS 0
@@ -646,11 +646,11 @@ Whether or not to output JSON data, rather than the normal output\.
.P
This feature is currently experimental, and the output data structures
for many commands is either not implemented in JSON yet, or subject to
-change\. Only the output from \fBnpm ls \-\-json\fR is currently valid\.
+change\. Only the output from \fBnpm ls \-\-json\fP is currently valid\.
.SS key
.RS 0
.IP \(bu 2
-Default: \fBnull\fR
+Default: \fBnull\fP
.IP \(bu 2
Type: String
@@ -703,7 +703,7 @@ Values: "silent", "error", "warn", "http", "info", "verbose", "silly"
.RE
.P
What level of logs to report\. On failure, \fIall\fR logs are written to
-\fBnpm\-debug\.log\fR in the current working directory\.
+\fBnpm\-debug\.log\fP in the current working directory\.
.P
Any logs of a higher level than the setting are shown\.
The default is "warn", which shows warn and error output\.
@@ -723,7 +723,7 @@ It cannot be set from the command line, but if you are using npm
programmatically, you may wish to send logs to somewhere other than
stderr\.
.P
-If the \fBcolor\fR config is set to true, then this stream will receive
+If the \fBcolor\fP config is set to true, then this stream will receive
colored output if it is a TTY\.
.SS long
.RS 0
@@ -734,7 +734,7 @@ Type: Boolean
.RE
.P
-Show extended information in \fBnpm ls\fR and \fBnpm search\fR\|\.
+Show extended information in \fBnpm ls\fP and \fBnpm search\fP\|\.
.SS message
.RS 0
.IP \(bu 2
@@ -744,7 +744,7 @@ Type: String
.RE
.P
-Commit message which is used by \fBnpm version\fR when creating version commit\.
+Commit message which is used by \fBnpm version\fP when creating version commit\.
.P
Any "%s" in the message will be replaced with the version number\.
.SS node\-version
@@ -756,7 +756,7 @@ Type: semver or false
.RE
.P
-The node version to use when checking a package's \fBengines\fR map\.
+The node version to use when checking a package's \fBengines\fP map\.
.SS npat
.RS 0
.IP \(bu 2
@@ -776,7 +776,7 @@ Type: path
.RE
.P
-A node module to \fBrequire()\fR when npm loads\. Useful for programmatic
+A node module to \fBrequire()\fP when npm loads\. Useful for programmatic
usage\.
.SS optional
.RS 0
@@ -787,7 +787,7 @@ Type: Boolean
.RE
.P
-Attempt to install packages in the \fBoptionalDependencies\fR object\. Note
+Attempt to install packages in the \fBoptionalDependencies\fP object\. Note
that if these packages fail to install, the overall installation
process is not aborted\.
.SS parseable
@@ -825,7 +825,7 @@ Set to true to run in "production" mode\.
.RS 0
.IP 1. 3
devDependencies are not installed at the topmost level when running
-local \fBnpm install\fR without any arguments\.
+local \fBnpm install\fP without any arguments\.
.IP 2. 3
Set the NODE_ENV="production" for lifecycle scripts\.
@@ -854,9 +854,9 @@ Type: url
.RE
.P
-A proxy to use for outgoing http requests\. If the \fBHTTP_PROXY\fR or
-\fBhttp_proxy\fR environment variables are set, proxy settings will be
-honored by the underlying \fBrequest\fR library\.
+A proxy to use for outgoing http requests\. If the \fBHTTP_PROXY\fP or
+\fBhttp_proxy\fP environment variables are set, proxy settings will be
+honored by the underlying \fBrequest\fP library\.
.SS rebuild\-bundle
.RS 0
.IP \(bu 2
@@ -898,7 +898,7 @@ Type: Boolean
.P
Save installed packages to a package\.json file as dependencies\.
.P
-When used with the \fBnpm rm\fR command, it removes it from the \fBdependencies\fR
+When used with the \fBnpm rm\fP command, it removes it from the \fBdependencies\fP
object\.
.P
Only works if there is already a package\.json file present\.
@@ -911,11 +911,11 @@ Type: Boolean
.RE
.P
-If a package would be saved at install time by the use of \fB\-\-save\fR,
-\fB\-\-save\-dev\fR, or \fB\-\-save\-optional\fR, then also put it in the
-\fBbundleDependencies\fR list\.
+If a package would be saved at install time by the use of \fB\-\-save\fP,
+\fB\-\-save\-dev\fP, or \fB\-\-save\-optional\fP, then also put it in the
+\fBbundleDependencies\fP list\.
.P
-When used with the \fBnpm rm\fR command, it removes it from the
+When used with the \fBnpm rm\fP command, it removes it from the
bundledDependencies list\.
.SS save\-dev
.RS 0
@@ -926,10 +926,10 @@ Type: Boolean
.RE
.P
-Save installed packages to a package\.json file as \fBdevDependencies\fR\|\.
+Save installed packages to a package\.json file as \fBdevDependencies\fP\|\.
.P
-When used with the \fBnpm rm\fR command, it removes it from the
-\fBdevDependencies\fR object\.
+When used with the \fBnpm rm\fP command, it removes it from the
+\fBdevDependencies\fP object\.
.P
Only works if there is already a package\.json file present\.
.SS save\-exact
@@ -941,8 +941,8 @@ Type: Boolean
.RE
.P
-Dependencies saved to package\.json using \fB\-\-save\fR, \fB\-\-save\-dev\fR or
-\fB\-\-save\-optional\fR will be configured with an exact version rather than
+Dependencies saved to package\.json using \fB\-\-save\fP, \fB\-\-save\-dev\fP or
+\fB\-\-save\-optional\fP will be configured with an exact version rather than
using npm's default semver range operator\.
.SS save\-optional
.RS 0
@@ -956,8 +956,8 @@ Type: Boolean
Save installed packages to a package\.json file as
optionalDependencies\.
.P
-When used with the \fBnpm rm\fR command, it removes it from the
-\fBdevDependencies\fR object\.
+When used with the \fBnpm rm\fP command, it removes it from the
+\fBdevDependencies\fP object\.
.P
Only works if there is already a package\.json file present\.
.SS save\-prefix
@@ -970,11 +970,11 @@ Type: String
.RE
.P
Configure how versions of packages installed to a package\.json file via
-\fB\-\-save\fR or \fB\-\-save\-dev\fR get prefixed\.
+\fB\-\-save\fP or \fB\-\-save\-dev\fP get prefixed\.
.P
-For example if a package has version \fB1\.2\.3\fR, by default its version is
-set to \fB^1\.2\.3\fR which allows minor upgrades for that package, but after
-\fBnpm config set save\-prefix='~'\fR it would be set to \fB~1\.2\.3\fR which only allows
+For example if a package has version \fB1\.2\.3\fP, by default its version is
+set to \fB^1\.2\.3\fP which allows minor upgrades for that package, but after
+\fBnpm config set save\-prefix='~'\fP it would be set to \fB~1\.2\.3\fP which only allows
patch upgrades\.
.SS scope
.RS 0
@@ -987,9 +987,9 @@ Type: String
.P
Associate an operation with a scope for a scoped registry\. Useful when logging
in to a private registry for the first time:
-\fBnpm login \-\-scope=@organization \-\-registry=registry\.organization\.com\fR, which
-will cause \fB@organization\fR to be mapped to the registry for future installation
-of packages specified according to the pattern \fB@organization/package\fR\|\.
+\fBnpm login \-\-scope=@organization \-\-registry=registry\.organization\.com\fP, which
+will cause \fB@organization\fP to be mapped to the registry for future installation
+of packages specified according to the pattern \fB@organization/package\fP\|\.
.SS searchopts
.RS 0
.IP \(bu 2
@@ -1022,7 +1022,7 @@ Values: "name", "\-name", "date", "\-date", "description",
.RE
.P
-Indication of which field to sort search results by\. Prefix with a \fB\-\fR
+Indication of which field to sort search results by\. Prefix with a \fB\-\fP
character to indicate reverse sort\.
.SS shell
.RS 0
@@ -1034,7 +1034,7 @@ Type: path
.RE
.P
-The shell to run for the \fBnpm explore\fR command\.
+The shell to run for the \fBnpm explore\fP command\.
.SS shrinkwrap
.RS 0
.IP \(bu 2
@@ -1044,7 +1044,7 @@ Type: Boolean
.RE
.P
-If set to false, then ignore \fBnpm\-shrinkwrap\.json\fR files when
+If set to false, then ignore \fBnpm\-shrinkwrap\.json\fP files when
installing\.
.SS sign\-git\-tag
.RS 0
@@ -1055,8 +1055,8 @@ Type: Boolean
.RE
.P
-If set to true, then the \fBnpm version\fR command will tag the version
-using \fB\-s\fR to add a signature\.
+If set to true, then the \fBnpm version\fP command will tag the version
+using \fB\-s\fP to add a signature\.
.P
Note that git requires you to have set up GPG keys in your git configs
for this to work properly\.
@@ -1065,14 +1065,14 @@ for this to work properly\.
.IP \(bu 2
Default: true
.IP \(bu 2
-Type: Boolean or \fB"always"\fR
+Type: Boolean or \fB"always"\fP
.RE
.P
-When set to \fBtrue\fR, npm will display an ascii spinner while it is doing
-things, if \fBprocess\.stderr\fR is a TTY\.
+When set to \fBtrue\fP, npm will display an ascii spinner while it is doing
+things, if \fBprocess\.stderr\fP is a TTY\.
.P
-Set to \fBfalse\fR to suppress the spinner, or set to \fBalways\fR to output
+Set to \fBfalse\fP to suppress the spinner, or set to \fBalways\fP to output
the spinner even for non\-TTY outputs\.
.SS strict\-ssl
.RS 0
@@ -1086,7 +1086,7 @@ Type: Boolean
Whether or not to do SSL key validation when making requests to the
registry via https\.
.P
-See also the \fBca\fR config\.
+See also the \fBca\fP config\.
.SS tag
.RS 0
.IP \(bu 2
@@ -1100,22 +1100,22 @@ If you ask npm to install a package and don't tell it a specific version, then
it will install the specified tag\.
.P
Also the tag that is added to the package@version specified by the \fBnpm
-tag\fR command, if no explicit tag is given\.
+tag\fP command, if no explicit tag is given\.
.SS tag\-version\-prefix
.RS 0
.IP \(bu 2
-Default: \fB"v"\fR
+Default: \fB"v"\fP
.IP \(bu 2
Type: String
.RE
.P
If set, alters the prefix used when tagging a new version when performing a
-version increment using \fBnpm\-version\fR\|\. To remove the prefix altogether, set it
-to the empty string: \fB""\fR\|\.
+version increment using \fBnpm\-version\fP\|\. To remove the prefix altogether, set it
+to the empty string: \fB""\fP\|\.
.P
Because other tools may rely on the convention that npm version tags look like
-\fBv1\.0\.0\fR, \fIonly use this property if it is absolutely necessary\fR\|\. In
+\fBv1\.0\.0\fP, \fIonly use this property if it is absolutely necessary\fR\|\. In
particular, use care when overriding this setting for public packages\.
.SS tmp
.RS 0
@@ -1161,7 +1161,7 @@ Type: Boolean
.RE
.P
Set to show short usage output (like the \-H output)
-instead of complete help when doing npm help \fBnpm\-help\fR\|\.
+instead of complete help when doing npm help \fBnpm\-help\fP\|\.
.SS user
.RS 0
.IP \(bu 2
@@ -1194,9 +1194,9 @@ Type: Octal numeric string in range 0000\.\.0777 (0\.\.511)
The "umask" value to use when setting the file creation mode on files
and folders\.
.P
-Folders and executables are given a mode which is \fB0777\fR masked against
-this value\. Other files are given a mode which is \fB0666\fR masked against
-this value\. Thus, the defaults are \fB0755\fR and \fB0644\fR respectively\.
+Folders and executables are given a mode which is \fB0777\fP masked against
+this value\. Other files are given a mode which is \fB0666\fP masked against
+this value\. Thus, the defaults are \fB0755\fP and \fB0644\fP respectively\.
.SS user\-agent
.RS 0
.IP \(bu 2
@@ -1228,7 +1228,7 @@ Type: boolean
.RE
.P
-If true, output the npm version as well as node's \fBprocess\.versions\fR map, and
+If true, output the npm version as well as node's \fBprocess\.versions\fP map, and
exit successfully\.
.P
Only relevant when specified explicitly on the command line\.
@@ -1243,7 +1243,7 @@ Type: path
.P
The program to use to view help content\.
.P
-Set to \fB"browser"\fR to view html help content in the default web browser\.
+Set to \fB"browser"\fP to view html help content in the default web browser\.
.SH SEE ALSO
.RS 0
.IP \(bu 2
diff --git a/deps/npm/man/man7/npm-developers.7 b/deps/npm/man/man7/npm-developers.7
index 3709946de31448..eb31fc10efd790 100644
--- a/deps/npm/man/man7/npm-developers.7
+++ b/deps/npm/man/man7/npm-developers.7
@@ -1,4 +1,4 @@
-.TH "NPM\-DEVELOPERS" "7" "June 2015" "" ""
+.TH "NPM\-DEVELOPERS" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-developers\fR \- Developer Guide
.SH DESCRIPTION
@@ -13,9 +13,9 @@ that your users will do to install your program\.
.SH About These Documents
.P
These are man pages\. If you install npm, you should be able to
-then do \fBman npm\-thing\fR to get the documentation on a particular
-topic, or \fBnpm help thing\fR to see the same information\.
-.SH What is a \fBpackage\fR
+then do \fBman npm\-thing\fP to get the documentation on a particular
+topic, or \fBnpm help thing\fP to see the same information\.
+.SH What is a \fBpackage\fP
.P
A package is:
.RS 0
@@ -26,13 +26,13 @@ b) a gzipped tarball containing (a)
.IP \(bu 2
c) a url that resolves to (b)
.IP \(bu 2
-d) a \fB@\fR that is published on the registry with (c)
+d) a \fB@\fP that is published on the registry with (c)
.IP \(bu 2
-e) a \fB@\fR that points to (d)
+e) a \fB@\fP that points to (d)
.IP \(bu 2
-f) a \fB\fR that has a "latest" tag satisfying (e)
+f) a \fB\fP that has a "latest" tag satisfying (e)
.IP \(bu 2
-g) a \fBgit\fR url that, when cloned, results in (a)\.
+g) a \fBgit\fP url that, when cloned, results in (a)\.
.RE
.P
@@ -52,14 +52,14 @@ git+https://user@hostname/project/blah\.git#commit\-ish
.fi
.RE
.P
-The \fBcommit\-ish\fR can be any tag, sha, or branch which can be supplied as
-an argument to \fBgit checkout\fR\|\. The default is \fBmaster\fR\|\.
+The \fBcommit\-ish\fP can be any tag, sha, or branch which can be supplied as
+an argument to \fBgit checkout\fP\|\. The default is \fBmaster\fP\|\.
.SH The package\.json File
.P
-You need to have a \fBpackage\.json\fR file in the root of your project to do
+You need to have a \fBpackage\.json\fP file in the root of your project to do
much of anything with npm\. That is basically the whole interface\.
.P
-See npm help 5 \fBpackage\.json\fR for details about what goes in that file\. At the very
+See npm help 5 \fBpackage\.json\fP for details about what goes in that file\. At the very
least, you need:
.RS 0
.IP \(bu 2
@@ -70,7 +70,7 @@ You can use the "engines" field to explicitly state the versions of
node (or whatever else) that your program requires, and it's pretty
well assumed that it's javascript\.
It does not necessarily need to match your github repository name\.
-So, \fBnode\-foo\fR and \fBbar\-js\fR are bad names\. \fBfoo\fR or \fBbar\fR are better\.
+So, \fBnode\-foo\fP and \fBbar\-js\fP are bad names\. \fBfoo\fP or \fBbar\fP are better\.
.IP \(bu 2
version:
A semver\-compatible version\.
@@ -85,7 +85,7 @@ Take some credit\.
.IP \(bu 2
scripts:
If you have a special compilation or installation script, then you
-should put it in the \fBscripts\fR object\. You should definitely have at
+should put it in the \fBscripts\fP object\. You should definitely have at
least a basic smoke\-test command as the "scripts\.test" field\.
See npm help 7 scripts\.
.IP \(bu 2
@@ -101,78 +101,78 @@ they'll get installed just like these ones\.
.RE
.P
-You can use \fBnpm init\fR in the root of your package in order to get you
-started with a pretty basic package\.json file\. See npm help \fBnpm\-init\fR for
+You can use \fBnpm init\fP in the root of your package in order to get you
+started with a pretty basic package\.json file\. See npm help \fBnpm\-init\fP for
more info\.
.SH Keeping files \fIout\fR of your package
.P
-Use a \fB\|\.npmignore\fR file to keep stuff out of your package\. If there's
-no \fB\|\.npmignore\fR file, but there \fIis\fR a \fB\|\.gitignore\fR file, then npm will
-ignore the stuff matched by the \fB\|\.gitignore\fR file\. If you \fIwant\fR to
-include something that is excluded by your \fB\|\.gitignore\fR file, you can
-create an empty \fB\|\.npmignore\fR file to override it\.
+Use a \fB\|\.npmignore\fP file to keep stuff out of your package\. If there's
+no \fB\|\.npmignore\fP file, but there \fIis\fR a \fB\|\.gitignore\fP file, then npm will
+ignore the stuff matched by the \fB\|\.gitignore\fP file\. If you \fIwant\fR to
+include something that is excluded by your \fB\|\.gitignore\fP file, you can
+create an empty \fB\|\.npmignore\fP file to override it\.
.P
-\fB\|\.npmignore\fR files follow the same pattern rules \fIhttp://git\-scm\.com/book/en/v2/Git\-Basics\-Recording\-Changes\-to\-the\-Repository#Ignoring\-Files\fR
-as \fB\|\.gitignore\fR files:
+\fB\|\.npmignore\fP files follow the same pattern rules \fIhttp://git\-scm\.com/book/en/v2/Git\-Basics\-Recording\-Changes\-to\-the\-Repository#Ignoring\-Files\fR
+as \fB\|\.gitignore\fP files:
.RS 0
.IP \(bu 2
-Blank lines or lines starting with \fB#\fR are ignored\.
+Blank lines or lines starting with \fB#\fP are ignored\.
.IP \(bu 2
Standard glob patterns work\.
.IP \(bu 2
-You can end patterns with a forward slash \fB/\fR to specify a directory\.
+You can end patterns with a forward slash \fB/\fP to specify a directory\.
.IP \(bu 2
-You can negate a pattern by starting it with an exclamation point \fB!\fR\|\.
+You can negate a pattern by starting it with an exclamation point \fB!\fP\|\.
.RE
.P
By default, the following paths and files are ignored, so there's no
-need to add them to \fB\|\.npmignore\fR explicitly:
+need to add them to \fB\|\.npmignore\fP explicitly:
.RS 0
.IP \(bu 2
-\fB\|\.*\.swp\fR
+\fB\|\.*\.swp\fP
.IP \(bu 2
-\fB\|\._*\fR
+\fB\|\._*\fP
.IP \(bu 2
-\fB\|\.DS_Store\fR
+\fB\|\.DS_Store\fP
.IP \(bu 2
-\fB\|\.git\fR
+\fB\|\.git\fP
.IP \(bu 2
-\fB\|\.hg\fR
+\fB\|\.hg\fP
.IP \(bu 2
-\fB\|\.lock\-wscript\fR
+\fB\|\.lock\-wscript\fP
.IP \(bu 2
-\fB\|\.svn\fR
+\fB\|\.svn\fP
.IP \(bu 2
-\fB\|\.wafpickle\-*\fR
+\fB\|\.wafpickle\-*\fP
.IP \(bu 2
-\fBCVS\fR
+\fBCVS\fP
.IP \(bu 2
-\fBnpm\-debug\.log\fR
+\fBnpm\-debug\.log\fP
.RE
.P
-Additionally, everything in \fBnode_modules\fR is ignored, except for
+Additionally, everything in \fBnode_modules\fP is ignored, except for
bundled dependencies\. npm automatically handles this for you, so don't
-bother adding \fBnode_modules\fR to \fB\|\.npmignore\fR\|\.
+bother adding \fBnode_modules\fP to \fB\|\.npmignore\fP\|\.
.P
The following paths and files are never ignored, so adding them to
-\fB\|\.npmignore\fR is pointless:
+\fB\|\.npmignore\fP is pointless:
.RS 0
.IP \(bu 2
-\fBpackage\.json\fR
+\fBpackage\.json\fP
.IP \(bu 2
-\fBREADME\.*\fR
+\fBREADME\.*\fP
.RE
.SH Link Packages
.P
-\fBnpm link\fR is designed to install a development package and see the
+\fBnpm link\fP is designed to install a development package and see the
changes in real time without having to keep re\-installing it\. (You do
-need to either re\-link or \fBnpm rebuild \-g\fR to update compiled packages,
+need to either re\-link or \fBnpm rebuild \-g\fP to update compiled packages,
of course\.)
.P
-More info at npm help \fBnpm\-link\fR\|\.
+More info at npm help \fBnpm\-link\fP\|\.
.SH Before Publishing: Make Sure Your Package Installs and Works
.P
\fBThis is important\.\fR
@@ -199,7 +199,7 @@ npm link
.fi
.RE
.P
-Use \fBnpm ls \-g\fR to see if it's there\.
+Use \fBnpm ls \-g\fP to see if it's there\.
.P
To test a local install, go into some other folder, and then do:
.P
@@ -242,7 +242,7 @@ or a path to a folder\.
.P
Note that pretty much \fBeverything in that folder will be exposed\fR
by default\. So, if you have secret stuff in there, use a
-\fB\|\.npmignore\fR file to list out the globs to ignore, or publish
+\fB\|\.npmignore\fP file to list out the globs to ignore, or publish
from a fresh checkout\.
.SH Brag about it
.P
diff --git a/deps/npm/man/man7/npm-disputes.7 b/deps/npm/man/man7/npm-disputes.7
index a740f66d5744a3..77350cdc54ff80 100644
--- a/deps/npm/man/man7/npm-disputes.7
+++ b/deps/npm/man/man7/npm-disputes.7
@@ -1,10 +1,10 @@
-.TH "NPM\-DISPUTES" "7" "June 2015" "" ""
+.TH "NPM\-DISPUTES" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-disputes\fR \- Handling Module Name Disputes
.SH SYNOPSIS
.RS 0
.IP 1. 3
-Get the author email with \fBnpm owner ls \fR
+Get the author email with \fBnpm owner ls \fP
.IP 2. 3
Email the author, CC support@npmjs\.com
.IP 3. 3
@@ -20,30 +20,30 @@ later, some other user wants to use that name\. Here are some common
ways that happens (each of these is based on actual events\.)
.RS 0
.IP 1. 3
-Joe writes a JavaScript module \fBfoo\fR, which is not node\-specific\.
-Joe doesn't use node at all\. Bob wants to use \fBfoo\fR in node, so he
+Joe writes a JavaScript module \fBfoo\fP, which is not node\-specific\.
+Joe doesn't use node at all\. Bob wants to use \fBfoo\fP in node, so he
wraps it in an npm module\. Some time later, Joe starts using node,
and wants to take over management of his program\.
.IP 2. 3
-Bob writes an npm module \fBfoo\fR, and publishes it\. Perhaps much
-later, Joe finds a bug in \fBfoo\fR, and fixes it\. He sends a pull
+Bob writes an npm module \fBfoo\fP, and publishes it\. Perhaps much
+later, Joe finds a bug in \fBfoo\fP, and fixes it\. He sends a pull
request to Bob, but Bob doesn't have the time to deal with it,
because he has a new job and a new baby and is focused on his new
erlang project, and kind of not involved with node any more\. Joe
-would like to publish a new \fBfoo\fR, but can't, because the name is
+would like to publish a new \fBfoo\fP, but can't, because the name is
taken\.
.IP 3. 3
-Bob writes a 10\-line flow\-control library, and calls it \fBfoo\fR, and
+Bob writes a 10\-line flow\-control library, and calls it \fBfoo\fP, and
publishes it to the npm registry\. Being a simple little thing, it
never really has to be updated\. Joe works for Foo Inc, the makers
-of the critically acclaimed and widely\-marketed \fBfoo\fR JavaScript
-toolkit framework\. They publish it to npm as \fBfoojs\fR, but people are
-routinely confused when \fBnpm install foo\fR is some different thing\.
+of the critically acclaimed and widely\-marketed \fBfoo\fP JavaScript
+toolkit framework\. They publish it to npm as \fBfoojs\fP, but people are
+routinely confused when \fBnpm install foo\fP is some different thing\.
.IP 4. 3
-Bob writes a parser for the widely\-known \fBfoo\fR file format, because
+Bob writes a parser for the widely\-known \fBfoo\fP file format, because
he needs it for work\. Then, he gets a new job, and never updates the
-prototype\. Later on, Joe writes a much more complete \fBfoo\fR parser,
-but can't publish, because Bob's \fBfoo\fR is in the way\.
+prototype\. Later on, Joe writes a much more complete \fBfoo\fP parser,
+but can't publish, because Bob's \fBfoo\fP is in the way\.
.RE
.P
@@ -51,14 +51,14 @@ The validity of Joe's claim in each situation can be debated\. However,
Joe's appropriate course of action in each case is the same\.
.RS 0
.IP 1. 3
-\fBnpm owner ls foo\fR\|\. This will tell Joe the email address of the
+\fBnpm owner ls foo\fP\|\. This will tell Joe the email address of the
owner (Bob)\.
.IP 2. 3
Joe emails Bob, explaining the situation \fBas respectfully as
possible\fR, and what he would like to do with the module name\. He
adds the npm support staff support@npmjs\.com to the CC list of
the email\. Mention in the email that Bob can run \fBnpm owner add
-joe foo\fR to add Joe as an owner of the \fBfoo\fR package\.
+joe foo\fP to add Joe as an owner of the \fBfoo\fP package\.
.IP 3. 3
After a reasonable amount of time, if Bob has not responded, or if
Bob and Joe can't come to any sort of resolution, email support
diff --git a/deps/npm/man/man7/npm-faq.7 b/deps/npm/man/man7/npm-faq.7
index 1ee30f516341f5..651597a2b9a13f 100644
--- a/deps/npm/man/man7/npm-faq.7
+++ b/deps/npm/man/man7/npm-faq.7
@@ -1,4 +1,4 @@
-.TH "NPM\-FAQ" "7" "June 2015" "" ""
+.TH "NPM\-FAQ" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-faq\fR \- Frequently Asked Questions
.SH Where can I find these docs in HTML?
@@ -11,7 +11,7 @@ npm config set viewer browser
.fi
.RE
.P
-to open these documents in your default web browser rather than \fBman\fR\|\.
+to open these documents in your default web browser rather than \fBman\fP\|\.
.SH It didn't work\.
.P
That's not really a question\.
@@ -23,32 +23,32 @@ Read the error output, and if you can't figure out what it means,
do what it says and post a bug with all the information it asks for\.
.SH Where does npm put stuff?
.P
-See npm help 5 \fBnpm\-folders\fR
+See npm help 5 \fBnpm\-folders\fP
.P
tl;dr:
.RS 0
.IP \(bu 2
-Use the \fBnpm root\fR command to see where modules go, and the \fBnpm bin\fR
+Use the \fBnpm root\fP command to see where modules go, and the \fBnpm bin\fP
command to see where executables go
.IP \(bu 2
Global installs are different from local installs\. If you install
-something with the \fB\-g\fR flag, then its executables go in \fBnpm bin \-g\fR
-and its modules go in \fBnpm root \-g\fR\|\.
+something with the \fB\-g\fP flag, then its executables go in \fBnpm bin \-g\fP
+and its modules go in \fBnpm root \-g\fP\|\.
.RE
.SH How do I install something on my computer in a central location?
.P
-Install it globally by tacking \fB\-g\fR or \fB\-\-global\fR to the command\. (This
+Install it globally by tacking \fB\-g\fP or \fB\-\-global\fP to the command\. (This
is especially important for command line utilities that need to add
-their bins to the global system \fBPATH\fR\|\.)
-.SH I installed something globally, but I can't \fBrequire()\fR it
+their bins to the global system \fBPATH\fP\|\.)
+.SH I installed something globally, but I can't \fBrequire()\fP it
.P
Install it locally\.
.P
The global install location is a place for command\-line utilities
-to put their bins in the system \fBPATH\fR\|\. It's not for use with \fBrequire()\fR\|\.
+to put their bins in the system \fBPATH\fP\|\. It's not for use with \fBrequire()\fP\|\.
.P
-If you \fBrequire()\fR a module in your code, then that means it's a
+If you \fBrequire()\fP a module in your code, then that means it's a
dependency, and a part of your program\. You need to install it locally
in your program\.
.SH Why can't npm just put everything in one place, like other package managers?
@@ -60,20 +60,20 @@ problems than it solves\.
.P
It is much harder to avoid dependency conflicts without nesting
dependencies\. This is fundamental to the way that npm works, and has
-proven to be an extremely successful approach\. See npm help 5 \fBnpm\-folders\fR for
+proven to be an extremely successful approach\. See npm help 5 \fBnpm\-folders\fP for
more details\.
.P
If you want a package to be installed in one place, and have all your
-programs reference the same copy of it, then use the \fBnpm link\fR command\.
+programs reference the same copy of it, then use the \fBnpm link\fP command\.
That's what it's for\. Install it globally, then link it into each
program that uses it\.
.SH Whatever, I really want the old style 'everything global' style\.
.P
-Write your own package manager\. You could probably even wrap up \fBnpm\fR
+Write your own package manager\. You could probably even wrap up \fBnpm\fP
in a shell script if you really wanted to\.
.P
npm will not help you do something that is known to be a bad idea\.
-.SH Should I check my \fBnode_modules\fR folder into git?
+.SH Should I check my \fBnode_modules\fP folder into git?
.P
Usually, no\. Allow npm to resolve dependencies for your packages\.
.P
@@ -111,23 +111,23 @@ about the (capitalized) NPM program at http://www\.cabiatl\.com/mricro/npm/\|\.
The first seed that eventually grew into this flower was a bash utility
named "pm", which was a shortened descendent of "pkgmakeinst", a
bash function that was used to install various different things on different
-platforms, most often using Yahoo's \fByinst\fR\|\. If \fBnpm\fR was ever an
-acronym for anything, it was \fBnode pm\fR or maybe \fBnew pm\fR\|\.
+platforms, most often using Yahoo's \fByinst\fP\|\. If \fBnpm\fP was ever an
+acronym for anything, it was \fBnode pm\fP or maybe \fBnew pm\fP\|\.
.P
So, in all seriousness, the "npm" project is named after its command\-line
utility, which was organically selected to be easily typed by a right\-handed
programmer using a US QWERTY keyboard layout, ending with the
-right\-ring\-finger in a postition to type the \fB\-\fR key for flags and
+right\-ring\-finger in a postition to type the \fB\-\fP key for flags and
other command\-line arguments\. That command\-line utility is always
lower\-case, though it starts most sentences it is a part of\.
.SH How do I list installed packages?
.P
-\fBnpm ls\fR
+\fBnpm ls\fP
.SH How do I search for packages?
.P
-\fBnpm search\fR
+\fBnpm search\fP
.P
-Arguments are greps\. \fBnpm search jsdom\fR shows jsdom packages\.
+Arguments are greps\. \fBnpm search jsdom\fP shows jsdom packages\.
.SH How do I update npm?
.P
.RS 2
@@ -136,12 +136,12 @@ npm install npm \-g
.fi
.RE
.P
-You can also update all outdated local packages by doing \fBnpm update\fR without
-any arguments, or global packages by doing \fBnpm update \-g\fR\|\.
+You can also update all outdated local packages by doing \fBnpm update\fP without
+any arguments, or global packages by doing \fBnpm update \-g\fP\|\.
.P
Occasionally, the version of npm will progress such that the current
version cannot be properly installed with the version that you have
-installed already\. (Consider, if there is ever a bug in the \fBupdate\fR
+installed already\. (Consider, if there is ever a bug in the \fBupdate\fP
command\.)
.P
In those cases, you can do this:
@@ -151,7 +151,7 @@ In those cases, you can do this:
curl https://www\.npmjs\.com/install\.sh | sh
.fi
.RE
-.SH What is a \fBpackage\fR?
+.SH What is a \fBpackage\fP?
.P
A package is:
.RS 0
@@ -162,13 +162,13 @@ b) a gzipped tarball containing (a)
.IP \(bu 2
c) a url that resolves to (b)
.IP \(bu 2
-d) a \fB@\fR that is published on the registry with (c)
+d) a \fB@\fP that is published on the registry with (c)
.IP \(bu 2
-e) a \fB@\fR that points to (d)
+e) a \fB@\fP that points to (d)
.IP \(bu 2
-f) a \fB\fR that has a "latest" tag satisfying (e)
+f) a \fB\fP that has a "latest" tag satisfying (e)
.IP \(bu 2
-g) a \fBgit\fR url that, when cloned, results in (a)\.
+g) a \fBgit\fP url that, when cloned, results in (a)\.
.RE
.P
@@ -188,33 +188,33 @@ git+https://user@hostname/project/blah\.git#commit\-ish
.fi
.RE
.P
-The \fBcommit\-ish\fR can be any tag, sha, or branch which can be supplied as
-an argument to \fBgit checkout\fR\|\. The default is \fBmaster\fR\|\.
-.SH What is a \fBmodule\fR?
+The \fBcommit\-ish\fP can be any tag, sha, or branch which can be supplied as
+an argument to \fBgit checkout\fP\|\. The default is \fBmaster\fP\|\.
+.SH What is a \fBmodule\fP?
.P
-A module is anything that can be loaded with \fBrequire()\fR in a Node\.js
+A module is anything that can be loaded with \fBrequire()\fP in a Node\.js
program\. The following things are all examples of things that can be
loaded as modules:
.RS 0
.IP \(bu 2
-A folder with a \fBpackage\.json\fR file containing a \fBmain\fR field\.
+A folder with a \fBpackage\.json\fP file containing a \fBmain\fP field\.
.IP \(bu 2
-A folder with an \fBindex\.js\fR file in it\.
+A folder with an \fBindex\.js\fP file in it\.
.IP \(bu 2
A JavaScript file\.
.RE
.P
Most npm packages are modules, because they are libraries that you
-load with \fBrequire\fR\|\. However, there's no requirement that an npm
+load with \fBrequire\fP\|\. However, there's no requirement that an npm
package be a module! Some only contain an executable command\-line
-interface, and don't provide a \fBmain\fR field for use in Node programs\.
+interface, and don't provide a \fBmain\fP field for use in Node programs\.
.P
Almost all npm packages (at least, those that are Node programs)
\fIcontain\fR many modules within them (because every file they load with
-\fBrequire()\fR is a module)\.
+\fBrequire()\fP is a module)\.
.P
-In the context of a Node program, the \fBmodule\fR is also the thing that
+In the context of a Node program, the \fBmodule\fP is also the thing that
was loaded \fIfrom\fR a file\. For example, in the following program:
.P
.RS 2
@@ -223,25 +223,25 @@ var req = require('request')
.fi
.RE
.P
-we might say that "The variable \fBreq\fR refers to the \fBrequest\fR module"\.
-.SH So, why is it the "\fBnode_modules\fR" folder, but "\fBpackage\.json\fR" file? Why not \fBnode_packages\fR or \fBmodule\.json\fR?
+we might say that "The variable \fBreq\fP refers to the \fBrequest\fP module"\.
+.SH So, why is it the "\fBnode_modules\fP" folder, but "\fBpackage\.json\fP" file? Why not \fBnode_packages\fP or \fBmodule\.json\fP?
.P
-The \fBpackage\.json\fR file defines the package\. (See "What is a
+The \fBpackage\.json\fP file defines the package\. (See "What is a
package?" above\.)
.P
-The \fBnode_modules\fR folder is the place Node\.js looks for modules\.
+The \fBnode_modules\fP folder is the place Node\.js looks for modules\.
(See "What is a module?" above\.)
.P
-For example, if you create a file at \fBnode_modules/foo\.js\fR and then
-had a program that did \fBvar f = require('foo\.js')\fR then it would load
-the module\. However, \fBfoo\.js\fR is not a "package" in this case,
+For example, if you create a file at \fBnode_modules/foo\.js\fP and then
+had a program that did \fBvar f = require('foo\.js')\fP then it would load
+the module\. However, \fBfoo\.js\fP is not a "package" in this case,
because it does not have a package\.json\.
.P
Alternatively, if you create a package which does not have an
-\fBindex\.js\fR or a \fB"main"\fR field in the \fBpackage\.json\fR file, then it is
-not a module\. Even if it's installed in \fBnode_modules\fR, it can't be
-an argument to \fBrequire()\fR\|\.
-.SH \fB"node_modules"\fR is the name of my deity's arch\-rival, and a Forbidden Word in my religion\. Can I configure npm to use a different folder?
+\fBindex\.js\fP or a \fB"main"\fP field in the \fBpackage\.json\fP file, then it is
+not a module\. Even if it's installed in \fBnode_modules\fP, it can't be
+an argument to \fBrequire()\fP\|\.
+.SH \fB"node_modules"\fP is the name of my deity's arch\-rival, and a Forbidden Word in my religion\. Can I configure npm to use a different folder?
.P
No\. This will never happen\. This question comes up sometimes,
because it seems silly from the outside that npm couldn't just be
@@ -249,7 +249,7 @@ configured to put stuff somewhere else, and then npm could load them
from there\. It's an arbitrary spelling choice, right? What's the big
deal?
.P
-At the time of this writing, the string \fB\|'node_modules'\fR appears 151
+At the time of this writing, the string \fB\|'node_modules'\fP appears 151
times in 53 separate files in npm and node core (excluding tests and
documentation)\.
.P
@@ -263,27 +263,27 @@ deference to your deity's delicate feelings regarding spelling\.
Many of the others are in dependencies that npm uses, which are not
necessarily tightly coupled to npm (in the sense that they do not read
npm's configuration files, etc\.) Each of these would have to be
-configured to take the name of the \fBnode_modules\fR folder as a
+configured to take the name of the \fBnode_modules\fP folder as a
parameter\. Complexity hurdle #2\.
.P
Furthermore, npm has the ability to "bundle" dependencies by adding
-the dep names to the \fB"bundledDependencies"\fR list in package\.json,
+the dep names to the \fB"bundledDependencies"\fP list in package\.json,
which causes the folder to be included in the package tarball\. What
if the author of a module bundles its dependencies, and they use a
-different spelling for \fBnode_modules\fR? npm would have to rename the
+different spelling for \fBnode_modules\fP? npm would have to rename the
folder at publish time, and then be smart enough to unpack it using
your locally configured name\. Complexity hurdle #3\.
.P
Furthermore, what happens when you \fIchange\fR this name? Fine, it's
-easy enough the first time, just rename the \fBnode_modules\fR folders to
-\fB\|\./blergyblerp/\fR or whatever name you choose\. But what about when you
+easy enough the first time, just rename the \fBnode_modules\fP folders to
+\fB\|\./blergyblerp/\fP or whatever name you choose\. But what about when you
change it again? npm doesn't currently track any state about past
configuration settings, so this would be rather difficult to do
properly\. It would have to track every previous value for this
config, and always accept any of them, or else yesterday's install may
be broken tomorrow\. Complexity hurdle #4\.
.P
-Never going to happen\. The folder is named \fBnode_modules\fR\|\. It is
+Never going to happen\. The folder is named \fBnode_modules\fP\|\. It is
written indelibly in the Node Way, handed down from the ancient times
of Node 0\.3\.
.SH How do I install node with npm?
@@ -306,6 +306,8 @@ Windows:
.IP \(bu 2
http://github\.com/marcelklehr/nodist
.IP \(bu 2
+https://github\.com/coreybutler/nvm\-windows
+.IP \(bu 2
https://github\.com/hakobera/nvmw
.IP \(bu 2
https://github\.com/nanjingboy/nvmw
@@ -313,12 +315,12 @@ https://github\.com/nanjingboy/nvmw
.RE
.SH How can I use npm for development?
.P
-See npm help 7 \fBnpm\-developers\fR and npm help 5 \fBpackage\.json\fR\|\.
+See npm help 7 \fBnpm\-developers\fP and npm help 5 \fBpackage\.json\fP\|\.
.P
-You'll most likely want to \fBnpm link\fR your development folder\. That's
+You'll most likely want to \fBnpm link\fP your development folder\. That's
awesomely handy\.
.P
-To set up your own private registry, check out npm help 7 \fBnpm\-registry\fR\|\.
+To set up your own private registry, check out npm help 7 \fBnpm\-registry\fP\|\.
.SH Can I list a url as a dependency?
.P
Yes\. It should be a url to a gzipped tarball containing a single folder
@@ -326,10 +328,10 @@ that has a package\.json in its root, or a git url\.
(See "what is a package?" above\.)
.SH How do I symlink to a dev folder so I don't have to keep re\-installing?
.P
-See npm help \fBnpm\-link\fR
+See npm help \fBnpm\-link\fP
.SH The package registry website\. What is that exactly?
.P
-See npm help 7 \fBnpm\-registry\fR\|\.
+See npm help 7 \fBnpm\-registry\fP\|\.
.SH I forgot my password, and can't publish\. How do I reset it?
.P
Go to https://npmjs\.com/forgot\|\.
@@ -351,7 +353,7 @@ on Freenode IRC\.
.SH Why no namespaces?
.P
npm has only one global namespace\. If you want to namespace your own packages,
-you may: simply use the \fB\-\fR character to separate the names or use scoped
+you may: simply use the \fB\-\fP character to separate the names or use scoped
packages\. npm is a mostly anarchic system\. There is not sufficient need to
impose namespace rules on everyone\.
.P
@@ -359,9 +361,9 @@ As of 2\.0, npm supports scoped packages, which allow you to publish a group of
related modules without worrying about name collisions\.
.P
Every npm user owns the scope associated with their username\. For example, the
-user named \fBnpm\fR owns the scope \fB@npm\fR\|\. Scoped packages are published inside a
+user named \fBnpm\fP owns the scope \fB@npm\fP\|\. Scoped packages are published inside a
scope by naming them as if they were files under the scope directory, e\.g\., by
-setting \fBname\fR in \fBpackage\.json\fR to \fB@npm/npm\fR\|\.
+setting \fBname\fP in \fBpackage\.json\fP to \fB@npm/npm\fP\|\.
.P
Scoped packages are supported by the public npm registry\. The npm client is
backwards\-compatible with un\-scoped registries, so it can be used to work with
diff --git a/deps/npm/man/man7/npm-index.7 b/deps/npm/man/man7/npm-index.7
index 413e94b66ebbef..b67a68a4604223 100644
--- a/deps/npm/man/man7/npm-index.7
+++ b/deps/npm/man/man7/npm-index.7
@@ -1,4 +1,4 @@
-.TH "NPM\-INDEX" "7" "June 2015" "" ""
+.TH "NPM\-INDEX" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-index\fR \- Index of all npm documentation
.SS npm help README
@@ -85,6 +85,9 @@ Manage package owners
.SS npm help pack
.P
Create a tarball from a package
+.SS npm help ping
+.P
+Ping npm registry
.SS npm help prefix
.P
Display prefix
@@ -214,6 +217,9 @@ Manage package owners
.SS npm apihelp pack
.P
Create a tarball from a package
+.SS npm apihelp ping
+.P
+Ping npm registry
.SS npm apihelp prefix
.P
Display prefix
diff --git a/deps/npm/man/man7/npm-registry.7 b/deps/npm/man/man7/npm-registry.7
index 7a52caced21696..1cb4db20a699a6 100644
--- a/deps/npm/man/man7/npm-registry.7
+++ b/deps/npm/man/man7/npm-registry.7
@@ -1,4 +1,4 @@
-.TH "NPM\-REGISTRY" "7" "June 2015" "" ""
+.TH "NPM\-REGISTRY" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-registry\fR \- The JavaScript Package Registry
.SH DESCRIPTION
@@ -17,9 +17,9 @@ http://skimdb\.npmjs\.com/registry\|\. The code for the couchapp is
available at http://github\.com/npm/npm\-registry\-couchapp\|\.
.P
The registry URL used is determined by the scope of the package (see
-npm help 7 \fBnpm\-scope\fR)\. If no scope is specified, the default registry is used, which is
-supplied by the \fBregistry\fR config parameter\. See npm help \fBnpm\-config\fR,
-npm help 5 \fBnpmrc\fR, and npm help 7 \fBnpm\-config\fR for more on managing npm's configuration\.
+npm help 7 \fBnpm\-scope\fP)\. If no scope is specified, the default registry is used, which is
+supplied by the \fBregistry\fP config parameter\. See npm help \fBnpm\-config\fP,
+npm help 5 \fBnpmrc\fP, and npm help 7 \fBnpm\-config\fP for more on managing npm's configuration\.
.SH Can I run my own private registry?
.P
Yes!
@@ -33,15 +33,15 @@ to read any published packages, in addition to your private ones, and by
default will only publish internally\.
.P
If you then want to publish a package for the whole world to see, you can
-simply override the \fB\-\-registry\fR option for that \fBpublish\fR command\.
+simply override the \fB\-\-registry\fP option for that \fBpublish\fP command\.
.SH I don't want my package published in the official registry\. It's private\.
.P
-Set \fB"private": true\fR in your package\.json to prevent it from being
+Set \fB"private": true\fP in your package\.json to prevent it from being
published at all, or
-\fB"publishConfig":{"registry":"http://my\-internal\-registry\.local"}\fR
+\fB"publishConfig":{"registry":"http://my\-internal\-registry\.local"}\fP
to force it to be published only to your internal registry\.
.P
-See npm help 5 \fBpackage\.json\fR for more info on what goes in the package\.json file\.
+See npm help 5 \fBpackage\.json\fP for more info on what goes in the package\.json file\.
.SH Will you replicate from my registry into the public one?
.P
No\. If you want things to be public, then publish them into the public
diff --git a/deps/npm/man/man7/npm-scope.7 b/deps/npm/man/man7/npm-scope.7
index 29586c7a7399ab..4bfe58c7f8d532 100644
--- a/deps/npm/man/man7/npm-scope.7
+++ b/deps/npm/man/man7/npm-scope.7
@@ -1,4 +1,4 @@
-.TH "NPM\-SCOPE" "7" "June 2015" "" ""
+.TH "NPM\-SCOPE" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-scope\fR \- Scoped packages
.SH DESCRIPTION
@@ -23,13 +23,13 @@ used to work with scoped and un\-scoped registries at the same time\.
.SH Installing scoped packages
.P
Scoped packages are installed to a sub\-folder of the regular installation
-folder, e\.g\. if your other packages are installed in \fBnode_modules/packagename\fR,
-scoped modules will be in \fBnode_modules/@myorg/packagename\fR\|\. The scope folder
-(\fB@myorg\fR) is simply the name of the scope preceded by an @\-symbol, and can
+folder, e\.g\. if your other packages are installed in \fBnode_modules/packagename\fP,
+scoped modules will be in \fBnode_modules/@myorg/packagename\fP\|\. The scope folder
+(\fB@myorg\fP) is simply the name of the scope preceded by an @\-symbol, and can
contain any number of scoped packages\.
.P
A scoped package is installed by referencing it by name, preceded by an
-@\-symbol, in \fBnpm install\fR:
+@\-symbol, in \fBnpm install\fP:
.P
.RS 2
.nf
@@ -37,7 +37,7 @@ npm install @myorg/mypackage
.fi
.RE
.P
-Or in \fBpackage\.json\fR:
+Or in \fBpackage\.json\fP:
.P
.RS 2
.nf
@@ -48,7 +48,7 @@ Or in \fBpackage\.json\fR:
.RE
.P
Note that if the @\-symbol is omitted in either case npm will instead attempt to
-install from GitHub; see npm help \fBnpm\-install\fR\|\.
+install from GitHub; see npm help \fBnpm\-install\fP\|\.
.SH Requiring scoped packages
.P
Because scoped packages are installed into a scope folder, you have to
@@ -61,7 +61,7 @@ require('@myorg/mypackage')
.RE
.P
There is nothing special about the way Node treats scope folders, this is
-just specifying to require the module \fBmypackage\fR in the folder called \fB@myorg\fR\|\.
+just specifying to require the module \fBmypackage\fP in the folder called \fB@myorg\fP\|\.
.SH Publishing scoped packages
.P
Scoped packages can be published to any registry that supports them, including
@@ -72,19 +72,19 @@ the public npm registry\.
If you wish, you may associate a scope with a registry; see below\.
.SS Publishing public scoped packages to the public npm registry
.P
-To publish a public scoped package, you must specify \fB\-\-access public\fR with
+To publish a public scoped package, you must specify \fB\-\-access public\fP with
the initial publication\. This will publish the package and set access
-to \fBpublic\fR as if you had run \fBnpm access public\fR after publishing\.
+to \fBpublic\fP as if you had run \fBnpm access public\fP after publishing\.
.SS Publishing private scoped packages to the npm registry
.P
To publish a private scoped package to the npm registry, you must have
an npm Private Modules \fIhttps://www\.npmjs\.com/private\-modules\fR
account\.
.P
-You can then publish the module with \fBnpm publish\fR or \fBnpm publish
-\-\-access restricted\fR, and it will be present in the npm registry, with
+You can then publish the module with \fBnpm publish\fP or \fBnpm publish
+\-\-access restricted\fP, and it will be present in the npm registry, with
restricted access\. You can then change the access permissions, if
-desired, with \fBnpm access\fR or on the npmjs\.com website\.
+desired, with \fBnpm access\fP or on the npmjs\.com website\.
.SH Associating a scope with a registry
.P
Scopes can be associated with a separate registry\. This allows you to
@@ -102,7 +102,7 @@ npm login \-\-registry=http://reg\.example\.com \-\-scope=@myco
Scopes have a many\-to\-one relationship with registries: one registry can
host multiple scopes, but a scope only ever points to one registry\.
.P
-You can also associate a scope with a registry using \fBnpm config\fR:
+You can also associate a scope with a registry using \fBnpm config\fP:
.P
.RS 2
.nf
@@ -110,9 +110,9 @@ npm config set @myco:registry http://reg\.example\.com
.fi
.RE
.P
-Once a scope is associated with a registry, any \fBnpm install\fR for a package
+Once a scope is associated with a registry, any \fBnpm install\fP for a package
with that scope will request packages from that registry instead\. Any
-\fBnpm publish\fR for a package name that contains the scope will be published to
+\fBnpm publish\fP for a package name that contains the scope will be published to
that registry instead\.
.SH SEE ALSO
.RS 0
diff --git a/deps/npm/man/man7/npm-scripts.7 b/deps/npm/man/man7/npm-scripts.7
index cdd740396e8726..dd58324d86ce88 100644
--- a/deps/npm/man/man7/npm-scripts.7
+++ b/deps/npm/man/man7/npm-scripts.7
@@ -1,4 +1,4 @@
-.TH "NPM\-SCRIPTS" "7" "June 2015" "" ""
+.TH "NPM\-SCRIPTS" "7" "August 2015" "" ""
.SH "NAME"
\fBnpm-scripts\fR \- How npm handles the "scripts" field
.SH DESCRIPTION
@@ -9,7 +9,7 @@ following scripts:
.IP \(bu 2
prepublish:
Run BEFORE the package is published\. (Also run on local \fBnpm
-install\fR without any arguments\.)
+install\fP without any arguments\.)
.IP \(bu 2
publish, postpublish:
Run AFTER the package is published\.
@@ -33,29 +33,29 @@ postversion:
Run AFTER bump the package version\.
.IP \(bu 2
pretest, test, posttest:
-Run by the \fBnpm test\fR command\.
+Run by the \fBnpm test\fP command\.
.IP \(bu 2
prestop, stop, poststop:
-Run by the \fBnpm stop\fR command\.
+Run by the \fBnpm stop\fP command\.
.IP \(bu 2
prestart, start, poststart:
-Run by the \fBnpm start\fR command\.
+Run by the \fBnpm start\fP command\.
.IP \(bu 2
prerestart, restart, postrestart:
-Run by the \fBnpm restart\fR command\. Note: \fBnpm restart\fR will run the
-stop and start scripts if no \fBrestart\fR script is provided\.
+Run by the \fBnpm restart\fP command\. Note: \fBnpm restart\fP will run the
+stop and start scripts if no \fBrestart\fP script is provided\.
.RE
.P
Additionally, arbitrary scripts can be executed by running \fBnpm
-run\-script \fR\|\. \fIPre\fR and \fIpost\fR commands with matching
-names will be run for those as well (e\.g\. \fBpremyscript\fR, \fBmyscript\fR,
-\fBpostmyscript\fR)\.
+run\-script \fP\|\. \fIPre\fR and \fIpost\fR commands with matching
+names will be run for those as well (e\.g\. \fBpremyscript\fP, \fBmyscript\fP,
+\fBpostmyscript\fP)\.
.SH COMMON USES
.P
If you need to perform operations on your package before it is used, in a way
that is not dependent on the operating system or architecture of the
-target system, use a \fBprepublish\fR script\. This includes
+target system, use a \fBprepublish\fP script\. This includes
tasks such as:
.RS 0
.IP \(bu 2
@@ -67,18 +67,18 @@ Fetching remote resources that your package will use\.
.RE
.P
-The advantage of doing these things at \fBprepublish\fR time is that they can be done once, in a
+The advantage of doing these things at \fBprepublish\fP time is that they can be done once, in a
single place, thus reducing complexity and variability\.
Additionally, this means that:
.RS 0
.IP \(bu 2
-You can depend on \fBcoffee\-script\fR as a \fBdevDependency\fR, and thus
+You can depend on \fBcoffee\-script\fP as a \fBdevDependency\fP, and thus
your users don't need to have it installed\.
.IP \(bu 2
You don't need to include minifiers in your package, reducing
the size for your users\.
.IP \(bu 2
-You don't need to rely on your users having \fBcurl\fR or \fBwget\fR or
+You don't need to rely on your users having \fBcurl\fP or \fBwget\fP or
other system tools on the target machines\.
.RE
@@ -87,20 +87,20 @@ other system tools on the target machines\.
npm will default some script values based on package contents\.
.RS 0
.IP \(bu 2
-\fB"start": "node server\.js"\fR:
-If there is a \fBserver\.js\fR file in the root of your package, then npm
-will default the \fBstart\fR command to \fBnode server\.js\fR\|\.
+\fB"start": "node server\.js"\fP:
+If there is a \fBserver\.js\fP file in the root of your package, then npm
+will default the \fBstart\fP command to \fBnode server\.js\fP\|\.
.IP \(bu 2
-\fB"preinstall": "node\-waf clean || true; node\-waf configure build"\fR:
-If there is a \fBwscript\fR file in the root of your package, npm will
-default the \fBpreinstall\fR command to compile using node\-waf\.
+\fB"preinstall": "node\-waf clean || true; node\-waf configure build"\fP:
+If there is a \fBwscript\fP file in the root of your package, npm will
+default the \fBpreinstall\fP command to compile using node\-waf\.
.RE
.SH USER
.P
If npm was invoked with root privileges, then it will change the uid
-to the user account or uid specified by the \fBuser\fR config, which
-defaults to \fBnobody\fR\|\. Set the \fBunsafe\-perm\fR flag to run scripts with
+to the user account or uid specified by the \fBuser\fP config, which
+defaults to \fBnobody\fP\|\. Set the \fBunsafe\-perm\fP flag to run scripts with
root privileges\.
.SH ENVIRONMENT
.P
@@ -110,7 +110,7 @@ the process\.
.SS path
.P
If you depend on modules that define executable scripts, like test
-suites, then those executables will be added to the \fBPATH\fR for
+suites, then those executables will be added to the \fBPATH\fP for
executing the scripts\. So, if your package\.json has this:
.P
.RS 2
@@ -121,24 +121,24 @@ executing the scripts\. So, if your package\.json has this:
.fi
.RE
.P
-then you could run \fBnpm start\fR to execute the \fBbar\fR script, which is
-exported into the \fBnode_modules/\.bin\fR directory on \fBnpm install\fR\|\.
+then you could run \fBnpm start\fP to execute the \fBbar\fP script, which is
+exported into the \fBnode_modules/\.bin\fP directory on \fBnpm install\fP\|\.
.SS package\.json vars
.P
-The package\.json fields are tacked onto the \fBnpm_package_\fR prefix\. So,
-for instance, if you had \fB{"name":"foo", "version":"1\.2\.5"}\fR in your
+The package\.json fields are tacked onto the \fBnpm_package_\fP prefix\. So,
+for instance, if you had \fB{"name":"foo", "version":"1\.2\.5"}\fP in your
package\.json file, then your package scripts would have the
-\fBnpm_package_name\fR environment variable set to "foo", and the
-\fBnpm_package_version\fR set to "1\.2\.5"
+\fBnpm_package_name\fP environment variable set to "foo", and the
+\fBnpm_package_version\fP set to "1\.2\.5"
.SS configuration
.P
Configuration parameters are put in the environment with the
-\fBnpm_config_\fR prefix\. For instance, you can view the effective \fBroot\fR
-config by checking the \fBnpm_config_root\fR environment variable\.
+\fBnpm_config_\fP prefix\. For instance, you can view the effective \fBroot\fP
+config by checking the \fBnpm_config_root\fP environment variable\.
.SS Special: package\.json "config" object
.P
The package\.json "config" keys are overwritten in the environment if
-there is a config param of \fB[@]:\fR\|\. For example,
+there is a config param of \fB