diff options
Diffstat (limited to 'deps/npm/html/doc')
78 files changed, 484 insertions, 755 deletions
diff --git a/deps/npm/html/doc/README.html b/deps/npm/html/doc/README.html index f7a482f465..af5ea2e683 100644 --- a/deps/npm/html/doc/README.html +++ b/deps/npm/html/doc/README.html @@ -13,7 +13,7 @@ <p><a href="https://travis-ci.org/npm/npm"><img src="https://img.shields.io/travis/npm/npm/latest.svg" alt="Build Status"></a></p> <h2 id="synopsis">SYNOPSIS</h2> <p>This is just enough info to get you up and running.</p> -<p>Much more info available via <code>npm help</code> once it's installed.</p> +<p>Much more info will be available via <code>npm help</code> once it's installed.</p> <h2 id="important">IMPORTANT</h2> <p><strong>You need node v6 or higher to run this program.</strong></p> <p>To install an old <strong>and unsupported</strong> version of npm that works on node v5 @@ -40,15 +40,12 @@ paths, etc.) then read on.</p> <p>There's a pretty robust install script at <a href="https://www.npmjs.com/install.sh">https://www.npmjs.com/install.sh</a>. You can download that and run it.</p> <p>Here's an example using curl:</p> -<pre><code class="lang-sh">curl -L https://www.npmjs.com/install.sh | sh -</code></pre> +<pre><code class="language-sh">curl -L https://www.npmjs.com/install.sh | sh</code></pre> <h3 id="slightly-fancier">Slightly Fancier</h3> <p>You can set any npm configuration params with that script:</p> -<pre><code class="lang-sh">npm_config_prefix=/some/path sh install.sh -</code></pre> +<pre><code class="language-sh">npm_config_prefix=/some/path sh install.sh</code></pre> <p>Or, you can run it in uber-debuggery mode:</p> -<pre><code class="lang-sh">npm_debug=1 sh install.sh -</code></pre> +<pre><code class="language-sh">npm_debug=1 sh install.sh</code></pre> <h3 id="even-fancier">Even Fancier</h3> <p>Get the code with git. Use <code>make</code> to build the docs and do other stuff. If you plan on hacking on npm, <code>make link</code> is your friend.</p> @@ -69,11 +66,9 @@ git, and mess with it directly.</p> <p>No.</p> <h2 id="uninstalling">Uninstalling</h2> <p>So sad to see you go.</p> -<pre><code class="lang-sh">sudo npm uninstall npm -g -</code></pre> +<pre><code class="language-sh">sudo npm uninstall npm -g</code></pre> <p>Or, if that fails,</p> -<pre><code class="lang-sh">sudo make uninstall -</code></pre> +<pre><code class="language-sh">sudo make uninstall</code></pre> <h2 id="more-severe-uninstalling">More Severe Uninstalling</h2> <p>Usually, the above instructions are sufficient. That will remove npm, but leave behind anything you've installed.</p> @@ -82,13 +77,11 @@ then you can use the <code>npm ls</code> command to find them, and then <code>np remove them.</p> <p>To remove cruft left behind by npm 0.x, you can use the included <code>clean-old.sh</code> script file. You can run it conveniently like this:</p> -<pre><code class="lang-sh">npm explore npm -g -- sh scripts/clean-old.sh -</code></pre> +<pre><code class="language-sh">npm explore npm -g -- sh scripts/clean-old.sh</code></pre> <p>npm uses two configuration files, one for per-user configs, and another for global (every-user) configs. You can view them by doing:</p> -<pre><code class="lang-sh">npm config get userconfig # defaults to ~/.npmrc -npm config get globalconfig # defaults to /usr/local/etc/npmrc -</code></pre> +<pre><code class="language-sh">npm config get userconfig # defaults to ~/.npmrc +npm config get globalconfig # defaults to /usr/local/etc/npmrc</code></pre> <p>Uninstalling npm does not remove configuration files by default. You must remove them yourself manually if you want them gone. Note that this means that future npm installs will not remember the settings that @@ -102,7 +95,7 @@ you should <a href="https://docs.npmjs.com/misc/developers">read this</a>.</p> <p>When you find issues, please report them:</p> <ul> <li>web: -<a href="https://github.com/npm/npm/issues">https://github.com/npm/npm/issues</a></li> +<a href="https://npm.community/c/bugs">https://npm.community/c/bugs</a></li> </ul> <p>Be sure to include <em>all</em> of the output from the npm command that didn't work as expected. The <code>npm-debug.log</code> file is also helpful to provide.</p> @@ -127,5 +120,5 @@ doubt tell you to put the output in a gist or email.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer"><a href="../doc/README.html">README</a> — npm@6.1.0</p> +<p id="footer"><a href="../doc/README.html">README</a> — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-access.html b/deps/npm/html/doc/cli/npm-access.html index bbc9b1814b..3a06cf4cea 100644 --- a/deps/npm/html/doc/cli/npm-access.html +++ b/deps/npm/html/doc/cli/npm-access.html @@ -19,8 +19,7 @@ npm access revoke <scope:team> [<package>] npm access ls-packages [<user>|<scope>|<scope:team>] npm access ls-collaborators [<package> [<user>]] -npm access edit [<package>] -</code></pre><h2 id="description">DESCRIPTION</h2> +npm access edit [<package>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Used to set access controls on private packages.</p> <p>For all of the subcommands, <code>npm access</code> will perform actions on the packages in the current working directory if no package name is passed to the @@ -86,5 +85,5 @@ with an HTTP 402 status code (logically enough), unless you use <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-access — npm@6.1.0</p> +<p id="footer">npm-access — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-adduser.html b/deps/npm/html/doc/cli/npm-adduser.html index 629130d14f..448b0849be 100644 --- a/deps/npm/html/doc/cli/npm-adduser.html +++ b/deps/npm/html/doc/cli/npm-adduser.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm adduser [--registry=url] [--scope=@orgname] [--always-auth] [--auth-type=legacy] -aliases: login, add-user -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: login, add-user</code></pre><h2 id="description">DESCRIPTION</h2> <p>Create or verify a user named <code><username></code> in the specified registry, and save the credentials to the <code>.npmrc</code> file. If no registry is specified, the default registry will be used (see <code><a href="../misc/npm-config.html">npm-config(7)</a></code>).</p> @@ -37,16 +36,14 @@ to the scope of the project directory you're currently in, if any. See <code <p>If specified, the user and login credentials given will be associated with the specified scope. See <code><a href="../misc/npm-scope.html">npm-scope(7)</a></code>. You can use both at the same time, e.g.</p> -<pre><code>npm adduser --registry=http://myregistry.example.com --scope=@myco -</code></pre><p>This will set a registry for the given scope and login or create a user for +<pre><code>npm adduser --registry=http://myregistry.example.com --scope=@myco</code></pre><p>This will set a registry for the given scope and login or create a user for that registry at the same time.</p> <h3 id="always-auth">always-auth</h3> <p>Default: false</p> <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 <code>--registry</code> and / or <code>--scope</code>, e.g.</p> -<pre><code>npm adduser --registry=http://private-registry.example.com --always-auth -</code></pre><p>This will ensure that all requests to that registry (including for tarballs) +<pre><code>npm adduser --registry=http://private-registry.example.com --always-auth</code></pre><p>This will ensure that all requests to that registry (including for tarballs) include an authorization header. This setting may be necessary for use with private registries where metadata and package tarballs are stored on hosts with different hostnames. See <code>always-auth</code> in <code><a href="../misc/npm-config.html">npm-config(7)</a></code> for more details on @@ -81,5 +78,5 @@ username/password entry in legacy npm.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-adduser — npm@6.1.0</p> +<p id="footer">npm-adduser — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-audit.html b/deps/npm/html/doc/cli/npm-audit.html index e7e9c74b02..e8da37b2b1 100644 --- a/deps/npm/html/doc/cli/npm-audit.html +++ b/deps/npm/html/doc/cli/npm-audit.html @@ -11,29 +11,25 @@ <h1><a href="../cli/npm-audit.html">npm-audit</a></h1> <p>Run a security audit</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm audit [--json] -npm audit fix [--force|--package-lock-only|--dry-run|--production|--only=dev] -</code></pre><h2 id="examples">EXAMPLES</h2> +<pre><code>npm audit [--json|--parseable] +npm audit fix [--force|--package-lock-only|--dry-run|--production|--only=dev]</code></pre><h2 id="examples">EXAMPLES</h2> <p>Scan your project for vulnerabilities and automatically install any compatible updates to vulnerable dependencies:</p> -<pre><code>$ npm audit fix -</code></pre><p>Run <code>audit fix</code> without modifying <code>node_modules</code>, but still updating the +<pre><code>$ npm audit fix</code></pre><p>Run <code>audit fix</code> without modifying <code>node_modules</code>, but still updating the pkglock:</p> -<pre><code>$ npm audit fix --package-lock-only -</code></pre><p>Skip updating <code>devDependencies</code>:</p> -<pre><code>$ npm audit fix --only=prod -</code></pre><p>Have <code>audit fix</code> install semver-major updates to toplevel dependencies, not just +<pre><code>$ npm audit fix --package-lock-only</code></pre><p>Skip updating <code>devDependencies</code>:</p> +<pre><code>$ npm audit fix --only=prod</code></pre><p>Have <code>audit fix</code> install semver-major updates to toplevel dependencies, not just semver-compatible ones:</p> -<pre><code>$ npm audit fix --force -</code></pre><p>Do a dry run to get an idea of what <code>audit fix</code> will do, and <em>also</em> output +<pre><code>$ npm audit fix --force</code></pre><p>Do a dry run to get an idea of what <code>audit fix</code> will do, and <em>also</em> output install information in JSON format:</p> -<pre><code>$ npm audit fix --dry-run --json -</code></pre><p>Scan your project for vulnerabilities and just show the details, without fixing +<pre><code>$ npm audit fix --dry-run --json</code></pre><p>Scan your project for vulnerabilities and just show the details, without fixing anything:</p> -<pre><code>$ npm audit -</code></pre><p>Get the detailed audit report in JSON format:</p> -<pre><code>$ npm audit --json -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>$ npm audit</code></pre><p>Get the detailed audit report in JSON format:</p> +<pre><code>$ npm audit --json</code></pre><p>Get the detailed audit report in plain text result, separated by tab characters, allowing for +future reuse in scripting or command line post processing, like for example, selecting +some of the columns printed:</p> +<pre><code>$ npm audit --parseable</code></pre><p>To parse columns, you can use for example <code>awk</code>, and just print some of them:</p> +<pre><code>$ npm audit --parseable | awk -F $'\t' '{print $1,$4}'</code></pre><h2 id="description">DESCRIPTION</h2> <p>The audit command submits a description of the dependencies configured in your project to your default registry and asks for a report of known vulnerabilities. The report returned includes instructions on how to act on @@ -85,4 +81,4 @@ different between runs.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-audit — npm@6.1.0</p> +<p id="footer">npm-audit — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-bin.html b/deps/npm/html/doc/cli/npm-bin.html index 75cd0fef71..5f06b80fb0 100644 --- a/deps/npm/html/doc/cli/npm-bin.html +++ b/deps/npm/html/doc/cli/npm-bin.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-bin.html">npm-bin</a></h1> <p>Display npm bin folder</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm bin [-g|--global] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm bin [-g|--global]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the folder where npm will install executables.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -35,5 +34,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-bin — npm@6.1.0</p> +<p id="footer">npm-bin — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-bugs.html b/deps/npm/html/doc/cli/npm-bugs.html index c5d564941a..723d28de2a 100644 --- a/deps/npm/html/doc/cli/npm-bugs.html +++ b/deps/npm/html/doc/cli/npm-bugs.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm bugs [<pkgname>] -aliases: issues -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: issues</code></pre><h2 id="description">DESCRIPTION</h2> <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 <code>--browser</code> config param. If no package name is provided, it will search for @@ -55,5 +54,5 @@ a <code>package.json</code> in the current folder and use the <code>name</code> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-bugs — npm@6.1.0</p> +<p id="footer">npm-bugs — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-build.html b/deps/npm/html/doc/cli/npm-build.html index ffdbfed446..6b69efcf1a 100644 --- a/deps/npm/html/doc/cli/npm-build.html +++ b/deps/npm/html/doc/cli/npm-build.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-build.html">npm-build</a></h1> <p>Build a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm build [<package-folder>] -</code></pre><ul> +<pre><code>npm build [<package-folder>]</code></pre><ul> <li><code><package-folder></code>: A folder containing a <code>package.json</code> file in its root.</li> </ul> @@ -20,8 +19,7 @@ A folder containing a <code>package.json</code> file in its root.</li> <p>This is the plumbing command called by <code>npm link</code> and <code>npm install</code>.</p> <p>It should generally be called during installation, but if you need to run it directly, run:</p> -<pre><code>npm run-script build -</code></pre><h2 id="see-also">SEE ALSO</h2> +<pre><code>npm run-script build</code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-install.html">npm-install(1)</a></li> <li><a href="../cli/npm-link.html">npm-link(1)</a></li> @@ -40,5 +38,5 @@ directly, run:</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-build — npm@6.1.0</p> +<p id="footer">npm-build — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-bundle.html b/deps/npm/html/doc/cli/npm-bundle.html index cc6494ba6f..02977001c6 100644 --- a/deps/npm/html/doc/cli/npm-bundle.html +++ b/deps/npm/html/doc/cli/npm-bundle.html @@ -31,5 +31,5 @@ install packages into the local space.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-bundle — npm@6.1.0</p> +<p id="footer">npm-bundle — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-cache.html b/deps/npm/html/doc/cli/npm-cache.html index 8f3b4d2b1e..bc76fc61ac 100644 --- a/deps/npm/html/doc/cli/npm-cache.html +++ b/deps/npm/html/doc/cli/npm-cache.html @@ -19,8 +19,7 @@ npm cache add <name>@<version> npm cache clean [<path>] aliases: npm cache clear, npm cache rm -npm cache verify -</code></pre><h2 id="description">DESCRIPTION</h2> +npm cache verify</code></pre><h2 id="description">DESCRIPTION</h2> <p>Used to add, list, or clean the npm cache folder.</p> <ul> <li><p>add: @@ -89,5 +88,5 @@ verify</code>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-cache — npm@6.1.0</p> +<p id="footer">npm-cache — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-ci.html b/deps/npm/html/doc/cli/npm-ci.html index 82791325f1..de65c01cb9 100644 --- a/deps/npm/html/doc/cli/npm-ci.html +++ b/deps/npm/html/doc/cli/npm-ci.html @@ -11,25 +11,21 @@ <h1><a href="../cli/npm-ci.html">npm-ci</a></h1> <p>Install a project with a clean slate</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm ci -</code></pre><h2 id="example">EXAMPLE</h2> +<pre><code>npm ci</code></pre><h2 id="example">EXAMPLE</h2> <p>Make sure you have a package-lock and an up-to-date install:</p> <pre><code>$ cd ./my/npm/project $ npm install added 154 packages in 10s -$ ls | grep package-lock -</code></pre><p>Run <code>npm ci</code> in that project</p> +$ ls | grep package-lock</code></pre><p>Run <code>npm ci</code> in that project</p> <pre><code>$ npm ci -added 154 packages in 5s -</code></pre><p>Configure Travis to build using <code>npm ci</code> instead of <code>npm install</code>:</p> +added 154 packages in 5s</code></pre><p>Configure Travis to build using <code>npm ci</code> instead of <code>npm install</code>:</p> <pre><code># .travis.yml install: - npm ci # keep the npm cache around to speed up installs cache: directories: - - "$HOME/.npm" -</code></pre><h2 id="description">DESCRIPTION</h2> + - "$HOME/.npm"</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command is similar to <code><a href="../cli/npm-install.html">npm-install(1)</a></code>, except it's meant to be used in automated environments such as test platforms, continuous integration, and deployment. It can be significantly faster than a regular npm install by @@ -61,4 +57,4 @@ incrementally-installed local environments of most npm users.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-ci — npm@6.1.0</p> +<p id="footer">npm-ci — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-completion.html b/deps/npm/html/doc/cli/npm-completion.html index 381ce6ba8f..badfceefb6 100644 --- a/deps/npm/html/doc/cli/npm-completion.html +++ b/deps/npm/html/doc/cli/npm-completion.html @@ -11,16 +11,14 @@ <h1><a href="../cli/npm-completion.html">npm-completion</a></h1> <p>Tab Completion for npm</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>source <(npm completion) -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>source <(npm completion)</code></pre><h2 id="description">DESCRIPTION</h2> <p>Enables tab-completion in all npm commands.</p> <p>The synopsis above loads the completions into your current shell. Adding it to your ~/.bashrc or ~/.zshrc will make the completions available everywhere:</p> <pre><code>npm completion >> ~/.bashrc -npm completion >> ~/.zshrc -</code></pre><p>You may of course also pipe the output of npm completion to a file +npm completion >> ~/.zshrc</code></pre><p>You may of course also pipe the output of npm completion to a file such as <code>/usr/local/etc/bash_completion.d/npm</code> if you have a system that will read that file for you.</p> <p>When <code>COMP_CWORD</code>, <code>COMP_LINE</code>, and <code>COMP_POINT</code> are defined in the @@ -43,5 +41,5 @@ completions based on the arguments.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-completion — npm@6.1.0</p> +<p id="footer">npm-completion — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-config.html b/deps/npm/html/doc/cli/npm-config.html index dad4fb527f..7141ac0da2 100644 --- a/deps/npm/html/doc/cli/npm-config.html +++ b/deps/npm/html/doc/cli/npm-config.html @@ -19,8 +19,7 @@ npm config edit npm get <key> npm set <key> <value> [-g|--global] -aliases: c -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: c</code></pre><h2 id="description">DESCRIPTION</h2> <p>npm gets its config settings from the command line, environment variables, <code>npmrc</code> files, and in some cases, the <code>package.json</code> file.</p> <p>See <a href="../files/npmrc.html">npmrc(5)</a> for more information about the npmrc files.</p> @@ -31,22 +30,17 @@ of the user and global npmrc files.</p> <h2 id="sub-commands">Sub-commands</h2> <p>Config supports the following sub-commands:</p> <h3 id="set">set</h3> -<pre><code>npm config set key value -</code></pre><p>Sets the config key to the value.</p> +<pre><code>npm config set key value</code></pre><p>Sets the config key to the value.</p> <p>If value is omitted, then it sets it to "true".</p> <h3 id="get">get</h3> -<pre><code>npm config get key -</code></pre><p>Echo the config value to stdout.</p> +<pre><code>npm config get key</code></pre><p>Echo the config value to stdout.</p> <h3 id="list">list</h3> -<pre><code>npm config list -</code></pre><p>Show all the config settings. Use <code>-l</code> to also show defaults. Use <code>--json</code> +<pre><code>npm config list</code></pre><p>Show all the config settings. Use <code>-l</code> to also show defaults. Use <code>--json</code> to show the settings in json format.</p> <h3 id="delete">delete</h3> -<pre><code>npm config delete key -</code></pre><p>Deletes the key from all configuration files.</p> +<pre><code>npm config delete key</code></pre><p>Deletes the key from all configuration files.</p> <h3 id="edit">edit</h3> -<pre><code>npm config edit -</code></pre><p>Opens the config file in an editor. Use the <code>--global</code> flag to edit the +<pre><code>npm config edit</code></pre><p>Opens the config file in an editor. Use the <code>--global</code> flag to edit the global config.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -68,5 +62,5 @@ global config.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-config — npm@6.1.0</p> +<p id="footer">npm-config — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-dedupe.html b/deps/npm/html/doc/cli/npm-dedupe.html index 6e78044137..b31aeb5d80 100644 --- a/deps/npm/html/doc/cli/npm-dedupe.html +++ b/deps/npm/html/doc/cli/npm-dedupe.html @@ -14,8 +14,7 @@ <pre><code>npm dedupe npm ddp -aliases: find-dupes, ddp -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: find-dupes, ddp</code></pre><h2 id="description">DESCRIPTION</h2> <p>Searches the local package tree and attempts to simplify the overall structure by moving dependencies further up the tree, where they can be more effectively shared by multiple dependent packages.</p> @@ -24,13 +23,11 @@ be more effectively shared by multiple dependent packages.</p> +-- b <-- depends on c@1.0.x | `-- c@1.0.3 `-- d <-- depends on c@~1.0.9 - `-- c@1.0.10 -</code></pre><p>In this case, <code><a href="../cli/npm-dedupe.html">npm-dedupe(1)</a></code> will transform the tree to:</p> + `-- c@1.0.10</code></pre><p>In this case, <code><a href="../cli/npm-dedupe.html">npm-dedupe(1)</a></code> will transform the tree to:</p> <pre><code>a +-- b +-- d -`-- c@1.0.10 -</code></pre><p>Because of the hierarchical nature of node's module lookup, b and d +`-- c@1.0.10</code></pre><p>Because of the hierarchical nature of node's module lookup, b and d will both get their dependency met by the single c package at the root level of the tree.</p> <p>The deduplication algorithm walks the tree, moving each dependency as far @@ -61,5 +58,5 @@ result in new modules being installed.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-dedupe — npm@6.1.0</p> +<p id="footer">npm-dedupe — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-deprecate.html b/deps/npm/html/doc/cli/npm-deprecate.html index 7f6af91be8..311915d164 100644 --- a/deps/npm/html/doc/cli/npm-deprecate.html +++ b/deps/npm/html/doc/cli/npm-deprecate.html @@ -11,14 +11,12 @@ <h1><a href="../cli/npm-deprecate.html">npm-deprecate</a></h1> <p>Deprecate a version of a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm deprecate <pkg>[@<version>] <message> -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm deprecate <pkg>[@<version>] <message></code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will update the npm registry entry for a package, providing a deprecation warning to all who attempt to install it.</p> <p>It works on version ranges as well as specific versions, so you can do something like this:</p> -<pre><code>npm deprecate my-thing@"< 0.2.3" "critical bug fixed in v0.2.3" -</code></pre><p>Note that you must be the package owner to deprecate something. See the +<pre><code>npm deprecate my-thing@"< 0.2.3" "critical bug fixed in v0.2.3"</code></pre><p>Note that you must be the package owner to deprecate something. See the <code>owner</code> and <code>adduser</code> help topics.</p> <p>To un-deprecate a package, specify an empty string (<code>""</code>) for the <code>message</code> argument.</p> <h2 id="see-also">SEE ALSO</h2> @@ -38,5 +36,5 @@ something like this:</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-deprecate — npm@6.1.0</p> +<p id="footer">npm-deprecate — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-dist-tag.html b/deps/npm/html/doc/cli/npm-dist-tag.html index 0a2b2861dc..b35d13d372 100644 --- a/deps/npm/html/doc/cli/npm-dist-tag.html +++ b/deps/npm/html/doc/cli/npm-dist-tag.html @@ -15,13 +15,12 @@ npm dist-tag rm <pkg> <tag> npm dist-tag ls [<pkg>] -aliases: dist-tags -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: dist-tags</code></pre><h2 id="description">DESCRIPTION</h2> <p>Add, remove, and enumerate distribution tags on a package:</p> <ul> <li><p>add: Tags the specified version of the package with the specified tag, or the -<code>--tag</code> config if not specified. The tag you're adding is <code>latest</code> and you +<code>--tag</code> config if not specified. If the tag you're adding is <code>latest</code> and you have two-factor authentication on auth-and-writes then you'll need to include an otp on the command line with <code>--otp</code>.</p> </li> @@ -35,10 +34,8 @@ the current prefix.</p> </ul> <p>A tag can be used when installing packages as a reference to a version instead of using a specific version number:</p> -<pre><code>npm install <name>@<tag> -</code></pre><p>When installing dependencies, a preferred tagged version may be specified:</p> -<pre><code>npm install --tag <tag> -</code></pre><p>This also applies to <code>npm dedupe</code>.</p> +<pre><code>npm install <name>@<tag></code></pre><p>When installing dependencies, a preferred tagged version may be specified:</p> +<pre><code>npm install --tag <tag></code></pre><p>This also applies to <code>npm dedupe</code>.</p> <p>Publishing a package sets the <code>latest</code> tag to the published version unless the <code>--tag</code> option is used. For example, <code>npm publish --tag=beta</code>.</p> <p>By default, <code>npm install <pkg></code> (without any <code>@<version></code> or <code>@<tag></code> @@ -88,5 +85,5 @@ begin with a number or the letter <code>v</code>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-dist-tag — npm@6.1.0</p> +<p id="footer">npm-dist-tag — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-docs.html b/deps/npm/html/doc/cli/npm-docs.html index 43763b2cc2..1bd8781360 100644 --- a/deps/npm/html/doc/cli/npm-docs.html +++ b/deps/npm/html/doc/cli/npm-docs.html @@ -14,8 +14,7 @@ <pre><code>npm docs [<pkgname> [<pkgname> ...]] npm docs . npm home [<pkgname> [<pkgname> ...]] -npm home . -</code></pre><h2 id="description">DESCRIPTION</h2> +npm home .</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command tries to guess at the likely location of a package's documentation URL, and then tries to open it using the <code>--browser</code> config param. You can pass multiple package names at once. If no @@ -56,5 +55,5 @@ the current folder and use the <code>name</code> property.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-docs — npm@6.1.0</p> +<p id="footer">npm-docs — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-doctor.html b/deps/npm/html/doc/cli/npm-doctor.html index 5d3dff5245..b9c7013d41 100644 --- a/deps/npm/html/doc/cli/npm-doctor.html +++ b/deps/npm/html/doc/cli/npm-doctor.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-doctor.html">npm-doctor</a></h1> <p>Check your environments</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm doctor -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm doctor</code></pre><h2 id="description">DESCRIPTION</h2> <p><code>npm doctor</code> runs a set of checks to ensure that your npm installation has what it needs to manage your JavaScript packages. npm is mostly a standalone tool, but it does have some basic requirements that must be met:</p> @@ -103,4 +102,4 @@ cache, you should probably run <code>npm cache clean</code> and reset the cache. <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-doctor — npm@6.1.0</p> +<p id="footer">npm-doctor — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-edit.html b/deps/npm/html/doc/cli/npm-edit.html index 3d0b4a1bdc..7cb880067c 100644 --- a/deps/npm/html/doc/cli/npm-edit.html +++ b/deps/npm/html/doc/cli/npm-edit.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-edit.html">npm-edit</a></h1> <p>Edit an installed package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm edit <pkg>[@<version>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm edit <pkg>[@<version>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Opens the package folder in the default editor (or whatever you've configured as the npm <code>editor</code> config -- see <code><a href="../misc/npm-config.html">npm-config(7)</a></code>.)</p> <p>After it has been edited, the package is rebuilt so as to pick up any @@ -49,5 +48,5 @@ or <code>"notepad"</code> on Windows.</li> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-edit — npm@6.1.0</p> +<p id="footer">npm-edit — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-explore.html b/deps/npm/html/doc/cli/npm-explore.html index 4d5628ddbf..f23ba06859 100644 --- a/deps/npm/html/doc/cli/npm-explore.html +++ b/deps/npm/html/doc/cli/npm-explore.html @@ -11,15 +11,13 @@ <h1><a href="../cli/npm-explore.html">npm-explore</a></h1> <p>Browse an installed package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm explore <pkg> [ -- <command>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm explore <pkg> [ -- <command>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Spawn a subshell in the directory of the installed package specified.</p> <p>If a command is specified, then it is run in the subshell, which then immediately terminates.</p> <p>This is particularly handy in the case of git submodules in the <code>node_modules</code> folder:</p> -<pre><code>npm explore some-dependency -- git pull origin master -</code></pre><p>Note that the package is <em>not</em> automatically rebuilt afterwards, so be +<pre><code>npm explore some-dependency -- git pull origin master</code></pre><p>Note that the package is <em>not</em> automatically rebuilt afterwards, so be sure to use <code>npm rebuild <pkg></code> if you make any changes.</p> <h2 id="configuration">CONFIGURATION</h2> <h3 id="shell">shell</h3> @@ -49,5 +47,5 @@ Windows</li> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-explore — npm@6.1.0</p> +<p id="footer">npm-explore — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-help-search.html b/deps/npm/html/doc/cli/npm-help-search.html index 06204f99c4..67068704cc 100644 --- a/deps/npm/html/doc/cli/npm-help-search.html +++ b/deps/npm/html/doc/cli/npm-help-search.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-help-search.html">npm-help-search</a></h1> <p>Search npm help documentation</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm help-search <text> -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm help-search <text></code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will search the npm markdown documentation files for the terms provided, and then list the results, sorted by relevance.</p> <p>If only one result is found, then it will show that help topic.</p> @@ -45,5 +44,5 @@ where the terms were found in the documentation.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-help-search — npm@6.1.0</p> +<p id="footer">npm-help-search — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-help.html b/deps/npm/html/doc/cli/npm-help.html index 9301975467..642cd3cc2c 100644 --- a/deps/npm/html/doc/cli/npm-help.html +++ b/deps/npm/html/doc/cli/npm-help.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-help.html">npm-help</a></h1> <p>Get help on npm</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm help <term> [<terms..>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm help <term> [<terms..>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>If supplied a topic, then show the appropriate documentation page.</p> <p>If the topic does not exist, or if multiple terms are provided, then run the <code>help-search</code> command to find a match. Note that, if <code>help-search</code> @@ -50,5 +49,5 @@ matches are equivalent to specifying a topic name.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-help — npm@6.1.0</p> +<p id="footer">npm-help — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-hook.html b/deps/npm/html/doc/cli/npm-hook.html index b4e513f2fc..fbf86ab300 100644 --- a/deps/npm/html/doc/cli/npm-hook.html +++ b/deps/npm/html/doc/cli/npm-hook.html @@ -14,23 +14,15 @@ <pre><code>npm hook ls [pkg] npm hook add <entity> <url> <secret> npm hook update <id> <url> [secret] -npm hook rm <id> -</code></pre><h2 id="example">EXAMPLE</h2> +npm hook rm <id></code></pre><h2 id="example">EXAMPLE</h2> <p>Add a hook to watch a package for changes:</p> -<pre><code>$ npm hook add lodash https://example.com/ my-shared-secret -</code></pre><p>Add a hook to watch packages belonging to the user <code>substack</code>:</p> -<pre><code>$ npm hook add ~substack https://example.com/ my-shared-secret -</code></pre><p>Add a hook to watch packages in the scope <code>@npm</code></p> -<pre><code>$ npm hook add @npm https://example.com/ my-shared-secret -</code></pre><p>List all your active hooks:</p> -<pre><code>$ npm hook ls -</code></pre><p>List your active hooks for the <code>lodash</code> package:</p> -<pre><code>$ npm hook ls lodash -</code></pre><p>Update an existing hook's url:</p> -<pre><code>$ npm hook update id-deadbeef https://my-new-website.here/ -</code></pre><p>Remove a hook:</p> -<pre><code>$ npm hook rm id-deadbeef -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>$ npm hook add lodash https://example.com/ my-shared-secret</code></pre><p>Add a hook to watch packages belonging to the user <code>substack</code>:</p> +<pre><code>$ npm hook add ~substack https://example.com/ my-shared-secret</code></pre><p>Add a hook to watch packages in the scope <code>@npm</code></p> +<pre><code>$ npm hook add @npm https://example.com/ my-shared-secret</code></pre><p>List all your active hooks:</p> +<pre><code>$ npm hook ls</code></pre><p>List your active hooks for the <code>lodash</code> package:</p> +<pre><code>$ npm hook ls lodash</code></pre><p>Update an existing hook's url:</p> +<pre><code>$ npm hook update id-deadbeef https://my-new-website.here/</code></pre><p>Remove a hook:</p> +<pre><code>$ npm hook rm id-deadbeef</code></pre><h2 id="description">DESCRIPTION</h2> <p>Allows you to manage <a href="http://blog.npmjs.org/post/145260155635/introducing-hooks-get-notifications-of-npm">npm hooks</a>, including adding, removing, listing, and updating.</p> @@ -60,4 +52,4 @@ request came from your own configured hook.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-hook — npm@6.1.0</p> +<p id="footer">npm-hook — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-init.html b/deps/npm/html/doc/cli/npm-init.html index 4e405c2ccf..475f98b7ce 100644 --- a/deps/npm/html/doc/cli/npm-init.html +++ b/deps/npm/html/doc/cli/npm-init.html @@ -13,20 +13,15 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm init [--force|-f|--yes|-y|--scope] npm init <@scope> (same as `npx <@scope>/create`) -npm init [<@scope>/]<name> (same as `npx [<@scope>/]create-<name>`) -</code></pre><h2 id="examples">EXAMPLES</h2> +npm init [<@scope>/]<name> (same as `npx [<@scope>/]create-<name>`)</code></pre><h2 id="examples">EXAMPLES</h2> <p>Create a new React-based project using <a href="https://npm.im/create-react-app"><code>create-react-app</code></a>:</p> -<pre><code>$ npm init react-app ./my-react-app -</code></pre><p>Create a new <code>esm</code>-compatible package using <a href="https://npm.im/create-esm"><code>create-esm</code></a>:</p> +<pre><code>$ npm init react-app ./my-react-app</code></pre><p>Create a new <code>esm</code>-compatible package using <a href="https://npm.im/create-esm"><code>create-esm</code></a>:</p> <pre><code>$ mkdir my-esm-lib && cd my-esm-lib -$ npm init esm --yes -</code></pre><p>Generate a plain old package.json using legacy init:</p> +$ npm init esm --yes</code></pre><p>Generate a plain old package.json using legacy init:</p> <pre><code>$ mkdir my-npm-pkg && cd my-npm-pkg $ git init -$ npm init -</code></pre><p>Generate it without having it ask any questions:</p> -<pre><code>$ npm init -y -</code></pre><h2 id="description">DESCRIPTION</h2> +$ npm init</code></pre><p>Generate it without having it ask any questions:</p> +<pre><code>$ npm init -y</code></pre><h2 id="description">DESCRIPTION</h2> <p><code>npm init <initializer></code> can be used to set up a new or existing npm package.</p> <p><code>initializer</code> in this case is an npm package named <code>create-<initializer></code>, which will be installed by <a href="https://npm.im/npx"><code><a href="../cli/npx.html">npx(1)</a></code></a>, and then have its main bin @@ -66,5 +61,5 @@ will create a scoped package.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-init — npm@6.1.0</p> +<p id="footer">npm-init — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-install-ci-test.html b/deps/npm/html/doc/cli/npm-install-ci-test.html index 537a0263bf..c18e8da1f3 100644 --- a/deps/npm/html/doc/cli/npm-install-ci-test.html +++ b/deps/npm/html/doc/cli/npm-install-ci-test.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm install-ci-test -alias: npm cit -</code></pre><h2 id="description">DESCRIPTION</h2> +alias: npm cit</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command runs an <code>npm ci</code> followed immediately by an <code>npm test</code>.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -33,4 +32,4 @@ alias: npm cit <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-install-ci-test — npm@6.1.0</p> +<p id="footer">npm-install-ci-test — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-install-test.html b/deps/npm/html/doc/cli/npm-install-test.html index beb2d312a9..23ca987f90 100644 --- a/deps/npm/html/doc/cli/npm-install-test.html +++ b/deps/npm/html/doc/cli/npm-install-test.html @@ -21,8 +21,7 @@ npm install-test <tarball url> npm install-test <folder> alias: npm it -common options: [--save|--save-dev|--save-optional] [--save-exact] [--dry-run] -</code></pre><h2 id="description">DESCRIPTION</h2> +common options: [--save|--save-dev|--save-optional] [--save-exact] [--dry-run]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command runs an <code>npm install</code> followed immediately by an <code>npm test</code>. It takes exactly the same arguments as <code>npm install</code>.</p> <h2 id="see-also">SEE ALSO</h2> @@ -42,5 +41,5 @@ takes exactly the same arguments as <code>npm install</code>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-install-test — npm@6.1.0</p> +<p id="footer">npm-install-test — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-install.html b/deps/npm/html/doc/cli/npm-install.html index 5bc9cd985b..39ee8ce902 100644 --- a/deps/npm/html/doc/cli/npm-install.html +++ b/deps/npm/html/doc/cli/npm-install.html @@ -23,8 +23,7 @@ npm install <tarball url> npm install <folder> alias: npm i -common options: [-P|--save-prod|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [-B|--save-bundle] [--no-save] [--dry-run] -</code></pre><h2 id="description">DESCRIPTION</h2> +common options: [-P|--save-prod|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [-B|--save-bundle] [--no-save] [--dry-run]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command installs a package, and any packages that it depends on. If the package has a package-lock or shrinkwrap file, the installation of dependencies will be driven by that, with an <code>npm-shrinkwrap.json</code> taking precedence if both @@ -68,31 +67,34 @@ after packing it up into a tarball (b).</p> <li><p><code>npm install <tarball file></code>:</p> <p> 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 <code>npm link</code>. The filename <em>must</em> use <code>.tar</code>, <code>.tar.gz</code>, or <code>.tgz</code> as - the extension.</p> -<p> Example:</p> -<pre><code> npm install ./package.tgz -</code></pre></li> + using <code>npm link</code>.</p> +<p> Tarball requirements:</p> +<ul> +<li>The filename <em>must</em> use <code>.tar</code>, <code>.tar.gz</code>, or <code>.tgz</code> as +the extension.</li> +<li>The package contents should reside in a subfolder inside the tarball (usually it is called <code>package/</code>). npm strips one directory layer when installing the package (an equivalent of <code>tar x --strip-components=1</code> is run).</li> +<li><p>The package must contain a <code>package.json</code> file with <code>name</code> and <code>version</code> properties.</p> +<p>Example:</p> +<pre><code>npm install ./package.tgz</code></pre></li> +</ul> +</li> <li><p><code>npm install <tarball url></code>:</p> <p> 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://"</p> <p> Example:</p> -<pre><code> npm install https://github.com/indexzero/forever/tarball/v0.5.6 -</code></pre></li> +<pre><code> npm install https://github.com/indexzero/forever/tarball/v0.5.6</code></pre></li> <li><p><code>npm install [<@scope>/]<name></code>:</p> <p> Do a <code><name>@<tag></code> install, where <code><tag></code> is the "tag" config. (See <code><a href="../misc/npm-config.html">npm-config(7)</a></code>. The config's default value is <code>latest</code>.)</p> <p> In most cases, this will install the version of the modules tagged as <code>latest</code> on the npm registry.</p> <p> Example:</p> -<pre><code> npm install sax -</code></pre><p> <code>npm install</code> saves any specified packages into <code>dependencies</code> by default. +<pre><code> npm install sax</code></pre><p> <code>npm install</code> saves any specified packages into <code>dependencies</code> by default. Additionally, you can control where and how they get saved with some additional flags:</p> <ul> <li><p><code>-P, --save-prod</code>: Package will appear in your <code>dependencies</code>. This is the</p> -<pre><code> default unless `-D` or `-O` are present. -</code></pre></li> +<pre><code> default unless `-D` or `-O` are present.</code></pre></li> <li><p><code>-D, --save-dev</code>: Package will appear in your <code>devDependencies</code>.</p> </li> <li><p><code>-O, --save-optional</code>: Package will appear in your <code>optionalDependencies</code>.</p> @@ -121,30 +123,26 @@ npm install @myorg/privatepackage npm install node-tap --save-dev npm install dtrace-provider --save-optional npm install readable-stream --save-exact -npm install ansi-regex --save-bundle -</code></pre></li> +npm install ansi-regex --save-bundle</code></pre></li> </ul> </li> </ul> <pre><code>**Note**: If there is a file or folder named `<name>` in the current working directory, then it will try to install that, and only try to -fetch the package by name if it is not valid. -</code></pre><ul> +fetch the package by name if it is not valid.</code></pre><ul> <li><p><code>npm install [<@scope>/]<name>@<tag></code>:</p> <p> 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.</p> <p> Example:</p> <pre><code> npm install sax@latest - npm install @myorg/mypackage@latest -</code></pre></li> + npm install @myorg/mypackage@latest</code></pre></li> <li><p><code>npm install [<@scope>/]<name>@<version></code>:</p> <p> Install the specified version of the package. This will fail if the version has not been published to the registry.</p> <p> Example:</p> <pre><code> npm install sax@0.1.1 - npm install @myorg/privatepackage@1.5.0 -</code></pre></li> + npm install @myorg/privatepackage@1.5.0</code></pre></li> <li><p><code>npm install [<@scope>/]<name>@<version range></code>:</p> <p> Install a version of the package matching the specified version range. This will follow the same rules for resolving dependencies described in <code><a href="../files/package.json.html">package.json(5)</a></code>.</p> @@ -152,13 +150,11 @@ fetch the package by name if it is not valid. treat it as a single argument.</p> <p> Example:</p> <pre><code> npm install sax@">=0.1.0 <0.2.0" - npm install @myorg/privatepackage@">=0.1.0 <0.2.0" -</code></pre></li> + npm install @myorg/privatepackage@">=0.1.0 <0.2.0"</code></pre></li> <li><p><code>npm install <git remote url></code>:</p> <p> Installs the package from the hosted git provider, cloning it with <code>git</code>. For a full git remote url, only that URL will be attempted.</p> -<pre><code> <protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>] -</code></pre><p> <code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or +<pre><code> <protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>]</code></pre><p> <code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or <code>git+file</code>.</p> <p> If <code>#<commit-ish></code> is provided, it will be used to clone exactly that commit. If the commit-ish has the format <code>#semver:<semver></code>, <code><semver></code> can @@ -183,12 +179,11 @@ fetch the package by name if it is not valid. <li><p><code>GIT_SSL_NO_VERIFY</code></p> <p>See the git man page for details.</p> <p>Examples:</p> -<pre><code>npm install git+ssh://git@github.com:npm/npm.git#v1.0.27 -npm install git+ssh://git@github.com:npm/npm#semver:^5.0 -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 -</code></pre></li> +<pre><code>npm install git+ssh://git@github.com:npm/cli.git#v1.0.27 +npm install git+ssh://git@github.com:npm/cli#semver:^5.0 +npm install git+https://isaacs@github.com/npm/cli.git +npm install git://github.com/npm/cli.git#v1.0.27 +GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@github.com:npm/cli.git</code></pre></li> </ul> </li> <li><p><code>npm install <githubname>/<githubrepo>[#<commit-ish>]</code>:</p> @@ -207,8 +202,7 @@ GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@g done installing.</p> <p> Examples:</p> <pre><code> npm install mygithubuser/myproject - npm install github:mygithubuser/myproject -</code></pre></li> + npm install github:mygithubuser/myproject</code></pre></li> <li><p><code>npm install gist:[<githubname>/]<gistID>[#<commit-ish>|#semver:<semver>]</code>:</p> <p> Install the package at <code>https://gist.github.com/gistID</code> by attempting to clone it using <code>git</code>. The GitHub username associated with the gist is @@ -217,8 +211,7 @@ GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@g be installed if the package has a <code>prepare</code> script, before the package is done installing.</p> <p> Example:</p> -<pre><code> npm install gist:101a11beef -</code></pre></li> +<pre><code> npm install gist:101a11beef</code></pre></li> <li><p><code>npm install bitbucket:<bitbucketname>/<bitbucketrepo>[#<commit-ish>]</code>:</p> <p> Install the package at <code>https://bitbucket.org/bitbucketname/bitbucketrepo</code> by attempting to clone it using <code>git</code>.</p> @@ -232,8 +225,7 @@ GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@g be installed if the package has a <code>prepare</code> script, before the package is done installing.</p> <p> Example:</p> -<pre><code> npm install bitbucket:mybitbucketuser/myproject -</code></pre></li> +<pre><code> npm install bitbucket:mybitbucketuser/myproject</code></pre></li> <li><p><code>npm install gitlab:<gitlabname>/<gitlabrepo>[#<commit-ish>]</code>:</p> <p> Install the package at <code>https://gitlab.com/gitlabname/gitlabrepo</code> by attempting to clone it using <code>git</code>.</p> @@ -248,13 +240,11 @@ GIT_SSH_COMMAND='ssh -i ~/.ssh/custom_ident' npm install git+ssh://git@g done installing.</p> <p> Example:</p> <pre><code> npm install gitlab:mygitlabuser/myproject - npm install gitlab:myusr/myproj#semver:^5.0 -</code></pre></li> + npm install gitlab:myusr/myproj#semver:^5.0</code></pre></li> </ul> <p>You may combine multiple arguments, and even multiple types of arguments. For example:</p> -<pre><code>npm install sax@">=0.1.0 <0.2.0" bench supervisor -</code></pre><p>The <code>--tag</code> argument will apply to all of the specified install targets. If a +<pre><code>npm install sax@">=0.1.0 <0.2.0" bench supervisor</code></pre><p>The <code>--tag</code> 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> <p>The <code>--dry-run</code> argument will report in the usual way what the install would @@ -263,8 +253,7 @@ have done without actually installing anything.</p> instead of checking <code>node_modules</code> and downloading dependencies.</p> <p>The <code>-f</code> or <code>--force</code> argument will force npm to fetch remote resources even if a local copy exists on disk.</p> -<pre><code>npm install sax --force -</code></pre><p>The <code>-g</code> or <code>--global</code> argument will cause npm to install the package globally +<pre><code>npm install sax --force</code></pre><p>The <code>-g</code> or <code>--global</code> argument will cause npm to install the package globally rather than locally. See <code><a href="../files/npm-folders.html">npm-folders(5)</a></code>.</p> <p>The <code>--global-style</code> argument will cause npm to install the package into your local <code>node_modules</code> folder with the same layout it uses with the @@ -306,14 +295,12 @@ walk the clone and add any missing dependencies compare the original tree with the cloned tree and make a list of actions to take to convert one to the other execute all of the actions, deepest first - kinds of actions are install, update, remove and move -</code></pre><p>For this <code>package{dep}</code> structure: <code>A{B,C}, B{C}, C{D}</code>, + kinds of actions are install, update, remove and move</code></pre><p>For this <code>package{dep}</code> structure: <code>A{B,C}, B{C}, C{D}</code>, this algorithm produces:</p> <pre><code>A +-- B +-- C -+-- D -</code></pre><p>That is, the dependency from B to C is satisfied by the fact that A ++-- D</code></pre><p>That is, the dependency from B to C is satisfied by the fact that A already caused C to be installed at a higher level. D is still installed at the top level because nothing conflicts with it.</p> <p>For <code>A{B,C}, B{C,D@1}, C{D@2}</code>, this algorithm produces:</p> @@ -321,8 +308,7 @@ at the top level because nothing conflicts with it.</p> +-- B +-- C `-- D@2 -+-- D@1 -</code></pre><p>Because B's D@1 will be installed in the top level, C now has to install D@2 ++-- D@1</code></pre><p>Because B's D@1 will be installed in the top level, C now has to install D@2 privately for itself. This algorithm is deterministic, but different trees may be produced if two dependencies are requested for installation in a different order.</p> @@ -335,8 +321,7 @@ most cases can simply be addressed by changing the local package name.</p> <p>There are some very rare and pathological edge-cases where a cycle can cause npm to try to install a never-ending tree of packages. Here is the simplest case:</p> -<pre><code>A -> B -> A' -> B' -> A -> B -> A' -> B' -> A -> ... -</code></pre><p>where <code>A</code> is some version of a package, and <code>A'</code> is a different version +<pre><code>A -> B -> A' -> B' -> A -> B -> A' -> B' -> A -> ...</code></pre><p>where <code>A</code> is some version of a package, and <code>A'</code> is a different version of the same package. Because <code>B</code> depends on a different version of <code>A</code> than the one that is already in the tree, it must install a separate copy. The same is true of <code>A'</code>, which must install <code>B'</code>. Because <code>B'</code> @@ -377,5 +362,5 @@ affects a real use-case, it will be investigated.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-install — npm@6.1.0</p> +<p id="footer">npm-install — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-link.html b/deps/npm/html/doc/cli/npm-link.html index b84aad751d..f8e409541a 100644 --- a/deps/npm/html/doc/cli/npm-link.html +++ b/deps/npm/html/doc/cli/npm-link.html @@ -14,8 +14,7 @@ <pre><code>npm link (in package dir) npm link [<@scope>/]<pkg>[@<version>] -alias: npm ln -</code></pre><h2 id="description">DESCRIPTION</h2> +alias: npm ln</code></pre><h2 id="description">DESCRIPTION</h2> <p>Package linking is a two-step process.</p> <p>First, <code>npm link</code> in a package folder will create a symlink in the global folder <code>{prefix}/lib/node_modules/<package></code> that links to the package where the <code>npm @@ -36,23 +35,21 @@ test it iteratively without having to continually rebuild.</p> <pre><code>cd ~/projects/node-redis # go into the package directory npm link # creates global link cd ~/projects/node-bloggy # go into some other package directory. -npm link redis # link-install the package -</code></pre><p>Now, any changes to ~/projects/node-redis will be reflected in +npm link redis # link-install the package</code></pre><p>Now, any changes to ~/projects/node-redis will be reflected in ~/projects/node-bloggy/node_modules/node-redis/. Note that the link should be to the package name, not the directory name for that package.</p> <p>You may also shortcut the two steps in one. For example, to do the above use-case in a shorter way:</p> <pre><code>cd ~/projects/node-bloggy # go into the dir of your main project -npm link ../node-redis # link the dir of your dependency -</code></pre><p>The second line is the equivalent of doing:</p> +npm link ../node-redis # link the dir of your dependency</code></pre><p>The second line is the equivalent of doing:</p> <pre><code>(cd ../node-redis; npm link) -npm link node-redis -</code></pre><p>That is, it first creates a global link, and then links the global +npm link redis</code></pre><p>That is, it first creates a global link, and then links the global installation target into your project's <code>node_modules</code> folder.</p> +<p>Note that in this case, you are referring to the directory name, <code>node-redis</code>, +rather than the package name <code>redis</code>.</p> <p>If your linked package is scoped (see <code><a href="../misc/npm-scope.html">npm-scope(7)</a></code>) your link command must include that scope, e.g.</p> -<pre><code>npm link @myorg/privatepackage -</code></pre><h2 id="see-also">SEE ALSO</h2> +<pre><code>npm link @myorg/privatepackage</code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../misc/npm-developers.html">npm-developers(7)</a></li> <li><a href="../files/package.json.html">package.json(5)</a></li> @@ -74,5 +71,5 @@ include that scope, e.g.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-link — npm@6.1.0</p> +<p id="footer">npm-link — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-logout.html b/deps/npm/html/doc/cli/npm-logout.html index 3929410fa1..a709374d6f 100644 --- a/deps/npm/html/doc/cli/npm-logout.html +++ b/deps/npm/html/doc/cli/npm-logout.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-logout.html">npm-logout</a></h1> <p>Log out of the registry</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm logout [--registry=<url>] [--scope=<@scope>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm logout [--registry=<url>] [--scope=<@scope>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>When logged into a registry that supports token-based authentication, tell the server to end this token's session. This will invalidate the token everywhere you're using it, not just for the current environment.</p> @@ -29,8 +28,7 @@ it takes precedence.</p> <h3 id="scope">scope</h3> <p>Default: The scope of your current project, if any, otherwise none.</p> <p>If specified, you will be logged out of the specified scope. See <code><a href="../misc/npm-scope.html">npm-scope(7)</a></code>.</p> -<pre><code>npm logout --scope=@myco -</code></pre><h2 id="see-also">SEE ALSO</h2> +<pre><code>npm logout --scope=@myco</code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-adduser.html">npm-adduser(1)</a></li> <li><a href="../misc/npm-registry.html">npm-registry(7)</a></li> @@ -51,5 +49,5 @@ it takes precedence.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-logout — npm@6.1.0</p> +<p id="footer">npm-logout — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-ls.html b/deps/npm/html/doc/cli/npm-ls.html index cfbe4ee303..d2391791d1 100644 --- a/deps/npm/html/doc/cli/npm-ls.html +++ b/deps/npm/html/doc/cli/npm-ls.html @@ -13,18 +13,16 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm ls [[<@scope>/]<pkg> ...] -aliases: list, la, ll -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: list, la, ll</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will print to stdout all the versions of packages that are installed, as well as their dependencies, in a tree-structure.</p> <p>Positional arguments are <code>name@version-range</code> identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will <em>also</em> show the paths to the specified packages. For example, running <code>npm ls promzard</code> in npm's source tree will show:</p> -<pre><code>npm@6.1.0 /path/to/npm +<pre><code>npm@6.2.0 /path/to/npm └─┬ init-package-json@0.0.4 - └── promzard@0.1.5 -</code></pre><p>It will print out extraneous, missing, and invalid packages.</p> + └── promzard@0.1.5</code></pre><p>It will print out extraneous, missing, and invalid packages.</p> <p>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> @@ -110,5 +108,5 @@ project.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-ls — npm@6.1.0</p> +<p id="footer">npm-ls — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-outdated.html b/deps/npm/html/doc/cli/npm-outdated.html index 319f1ae45f..f2ae7faa34 100644 --- a/deps/npm/html/doc/cli/npm-outdated.html +++ b/deps/npm/html/doc/cli/npm-outdated.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-outdated.html">npm-outdated</a></h1> <p>Check for outdated packages</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm outdated [[<@scope>/]<pkg> ...] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm outdated [[<@scope>/]<pkg> ...]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will check the registry to see if any (or, specific) installed packages are currently outdated.</p> <p>In the output:</p> @@ -42,15 +41,13 @@ glob 5.0.15 5.0.15 6.0.1 test-outdated-output nothingness 0.0.3 git git test-outdated-output npm 3.5.1 3.5.2 3.5.1 test-outdated-output local-dev 0.0.3 linked linked test-outdated-output -once 1.3.2 1.3.3 1.3.3 test-outdated-output -</code></pre><p>With these <code>dependencies</code>:</p> -<pre><code class="lang-json">{ +once 1.3.2 1.3.3 1.3.3 test-outdated-output</code></pre><p>With these <code>dependencies</code>:</p> +<pre><code class="language-json">{ "glob": "^5.0.15", "nothingness": "github:othiym23/nothingness#master", "npm": "^3.5.1", "once": "^1.3.1" -} -</code></pre> +}</code></pre> <p>A few things to note:</p> <ul> <li><code>glob</code> requires <code>^5</code>, which prevents npm from installing <code>glob@6</code>, which is @@ -60,7 +57,7 @@ The installed committish might satisfy the dependency specifier (if it's something immutable, like a commit SHA), or it might not, so <code>npm outdated</code> and <code>npm update</code> have to fetch Git repos to check. This is why currently doing a reinstall of a Git dependency always forces a new clone and install.</li> -<li><a href="mailto:`npm@3.5.2">`npm@3.5.2</a><code>is marked as "wanted", but "latest" is</code><a href="mailto:npm@3.5.1">npm@3.5.1</a><code>because npm +<li><a href="mailto:%60npm@3.5.2">`npm@3.5.2</a><code>is marked as "wanted", but "latest" is</code><a href="mailto:npm@3.5.1">npm@3.5.1</a><code>because npm uses dist-tags to manage its</code>latest<code>and</code>next<code>release channels.</code>npm update<code>will install the _newest_ version, but</code>npm install npm<code>(with no semver range) will install whatever's tagged as</code>latest`.</li> <li><code>once</code> is just plain out of date. Reinstalling <code>node_modules</code> from scratch or @@ -117,5 +114,5 @@ project.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-outdated — npm@6.1.0</p> +<p id="footer">npm-outdated — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-owner.html b/deps/npm/html/doc/cli/npm-owner.html index 1c1ce66534..4e5485c6fa 100644 --- a/deps/npm/html/doc/cli/npm-owner.html +++ b/deps/npm/html/doc/cli/npm-owner.html @@ -15,8 +15,7 @@ npm owner rm <user> [<@scope>/]<pkg> npm owner ls [<@scope>/]<pkg> -aliases: author -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: author</code></pre><h2 id="description">DESCRIPTION</h2> <p>Manage ownership of published packages.</p> <ul> <li>ls: @@ -54,5 +53,5 @@ with <code>--otp</code>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-owner — npm@6.1.0</p> +<p id="footer">npm-owner — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-pack.html b/deps/npm/html/doc/cli/npm-pack.html index d3a560f14c..c3d49981da 100644 --- a/deps/npm/html/doc/cli/npm-pack.html +++ b/deps/npm/html/doc/cli/npm-pack.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-pack.html">npm-pack</a></h1> <p>Create a tarball from a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm pack [[<@scope>/]<pkg>...] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm pack [[<@scope>/]<pkg>...]</code></pre><h2 id="description">DESCRIPTION</h2> <p>For anything that's installable (that is, a package folder, tarball, tarball url, name@tag, name@version, name, or scoped name), this command will fetch it to the cache, and then copy the tarball to the @@ -41,5 +40,5 @@ overwritten the second time.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-pack — npm@6.1.0</p> +<p id="footer">npm-pack — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-ping.html b/deps/npm/html/doc/cli/npm-ping.html index 0e0d2afc7e..4687d11255 100644 --- a/deps/npm/html/doc/cli/npm-ping.html +++ b/deps/npm/html/doc/cli/npm-ping.html @@ -11,14 +11,11 @@ <h1><a href="../cli/npm-ping.html">npm-ping</a></h1> <p>Ping npm registry</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm ping [--registry <registry>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm ping [--registry <registry>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Ping the configured or given npm registry and verify authentication. If it works it will output something like:</p> -<pre><code>Ping success: {*Details about registry*} -</code></pre><p>otherwise you will get:</p> -<pre><code>Ping error: {*Detail about error} -</code></pre><h2 id="see-also">SEE ALSO</h2> +<pre><code>Ping success: {*Details about registry*}</code></pre><p>otherwise you will get:</p> +<pre><code>Ping error: {*Detail about error}</code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-config.html">npm-config(1)</a></li> <li><a href="../misc/npm-config.html">npm-config(7)</a></li> @@ -36,5 +33,5 @@ If it works it will output something like:</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-ping — npm@6.1.0</p> +<p id="footer">npm-ping — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-prefix.html b/deps/npm/html/doc/cli/npm-prefix.html index d9cdfd9782..0aaf04586b 100644 --- a/deps/npm/html/doc/cli/npm-prefix.html +++ b/deps/npm/html/doc/cli/npm-prefix.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-prefix.html">npm-prefix</a></h1> <p>Display prefix</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm prefix [-g] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm prefix [-g]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the local prefix to standard out. This is the closest parent directory to contain a package.json file unless <code>-g</code> is also specified.</p> <p>If <code>-g</code> is specified, this will be the value of the global prefix. See @@ -38,5 +37,5 @@ to contain a package.json file unless <code>-g</code> is also specified.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-prefix — npm@6.1.0</p> +<p id="footer">npm-prefix — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-profile.html b/deps/npm/html/doc/cli/npm-profile.html index 60fece551e..18f07a1fd8 100644 --- a/deps/npm/html/doc/cli/npm-profile.html +++ b/deps/npm/html/doc/cli/npm-profile.html @@ -15,8 +15,7 @@ npm profile set [--json|--parseable] <property> <value> npm profile set password npm profile enable-2fa [auth-and-writes|auth-only] -npm profile disable-2fa -</code></pre><h2 id="description">DESCRIPTION</h2> +npm profile disable-2fa</code></pre><h2 id="description">DESCRIPTION</h2> <p>Change your profile information on the registry. This not be available if you're using a non-npmjs registry.</p> <ul> @@ -44,8 +43,7 @@ properties. It looks like:</li> | created | 2015-02-26T01:38:35.892Z | +-----------------+---------------------------+ | updated | 2017-10-02T21:29:45.922Z | -+-----------------+---------------------------+ -</code></pre><ul> ++-----------------+---------------------------+</code></pre><ul> <li><p><code>npm profile set <property> <value></code>: Set the value of a profile property. You can set the following properties this way: email, fullname, homepage, freenode, twitter, github</p> @@ -90,4 +88,4 @@ available on non npmjs.com registries.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-profile — npm@6.1.0</p> +<p id="footer">npm-profile — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-prune.html b/deps/npm/html/doc/cli/npm-prune.html index 1c3ce7eb02..418ee88050 100644 --- a/deps/npm/html/doc/cli/npm-prune.html +++ b/deps/npm/html/doc/cli/npm-prune.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-prune.html">npm-prune</a></h1> <p>Remove extraneous packages</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm prune [[<@scope>/]<pkg>...] [--production] [--dry-run] [--json] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm prune [[<@scope>/]<pkg>...] [--production] [--dry-run] [--json]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command removes "extraneous" packages. If a package name is provided, then only packages matching one of the supplied names are removed.</p> @@ -48,5 +47,5 @@ and it's up to you to run <code>npm prune</code> from time-to-time to remove <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-prune — npm@6.1.0</p> +<p id="footer">npm-prune — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-publish.html b/deps/npm/html/doc/cli/npm-publish.html index 5a3c8b8f16..79f7515410 100644 --- a/deps/npm/html/doc/cli/npm-publish.html +++ b/deps/npm/html/doc/cli/npm-publish.html @@ -14,8 +14,7 @@ <pre><code>npm publish [<tarball>|<folder>] [--tag <tag>] [--access <public|restricted>] [--otp otpcode] Publishes '.' if no argument supplied -Sets tag 'latest' if no --tag specified -</code></pre><h2 id="description">DESCRIPTION</h2> +Sets tag 'latest' if no --tag specified</code></pre><h2 id="description">DESCRIPTION</h2> <p>Publishes a package to the registry so that it can be installed by name. All files in the package directory are included if no local <code>.gitignore</code> or <code>.npmignore</code> file exists. If both files exist and a file is ignored by @@ -85,5 +84,5 @@ packs them into a tarball to be uploaded to the registry.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-publish — npm@6.1.0</p> +<p id="footer">npm-publish — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-rebuild.html b/deps/npm/html/doc/cli/npm-rebuild.html index 4361ac43c1..537b3e53de 100644 --- a/deps/npm/html/doc/cli/npm-rebuild.html +++ b/deps/npm/html/doc/cli/npm-rebuild.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm rebuild [[<@scope>/<name>]...] -alias: npm rb -</code></pre><h2 id="description">DESCRIPTION</h2> +alias: npm rb</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command runs the <code>npm build</code> 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.</p> @@ -35,5 +34,5 @@ the new binary.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-rebuild — npm@6.1.0</p> +<p id="footer">npm-rebuild — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-repo.html b/deps/npm/html/doc/cli/npm-repo.html index e11513ceb0..c7a061020d 100644 --- a/deps/npm/html/doc/cli/npm-repo.html +++ b/deps/npm/html/doc/cli/npm-repo.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-repo.html">npm-repo</a></h1> <p>Open package repository page in the browser</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm repo [<pkg>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm repo [<pkg>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command tries to guess at the likely location of a package's repository URL, and then tries to open it using the <code>--browser</code> config param. If no package name is provided, it will search for @@ -41,5 +40,5 @@ a <code>package.json</code> in the current folder and use the <code>name</code> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-repo — npm@6.1.0</p> +<p id="footer">npm-repo — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-restart.html b/deps/npm/html/doc/cli/npm-restart.html index 918d331de4..8a3f8cb369 100644 --- a/deps/npm/html/doc/cli/npm-restart.html +++ b/deps/npm/html/doc/cli/npm-restart.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-restart.html">npm-restart</a></h1> <p>Restart a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm restart [-- <args>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm restart [-- <args>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This restarts a package.</p> <p>This runs a package's "stop", "restart", and "start" scripts, and associated pre- and post- scripts, in the order given below:</p> @@ -53,5 +52,5 @@ behavior will be accompanied by an increase in major version number</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-restart — npm@6.1.0</p> +<p id="footer">npm-restart — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-root.html b/deps/npm/html/doc/cli/npm-root.html index c97d05bdcd..3f6821e18e 100644 --- a/deps/npm/html/doc/cli/npm-root.html +++ b/deps/npm/html/doc/cli/npm-root.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-root.html">npm-root</a></h1> <p>Display npm root</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm root [-g] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm root [-g]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the effective <code>node_modules</code> folder to standard out.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -35,5 +34,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-root — npm@6.1.0</p> +<p id="footer">npm-root — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-run-script.html b/deps/npm/html/doc/cli/npm-run-script.html index c3ed88b8f1..6dc9539150 100644 --- a/deps/npm/html/doc/cli/npm-run-script.html +++ b/deps/npm/html/doc/cli/npm-run-script.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm run-script <command> [--silent] [-- <args>...] -alias: npm run -</code></pre><h2 id="description">DESCRIPTION</h2> +alias: npm run</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs an arbitrary command from a package's <code>"scripts"</code> object. If no <code>"command"</code> is provided, it will list the available scripts. <code>run[-script]</code> is used by the test, start, restart, and stop commands, but can be called @@ -24,8 +23,7 @@ separated into lifecycle (test, start, restart) and directly-run scripts.</p> use custom arguments when executing scripts. The special option <code>--</code> is used by <a href="http://goo.gl/KxMmtG">getopt</a> to delimit the end of the options. npm will pass all the arguments after the <code>--</code> directly to your script:</p> -<pre><code>npm run test -- --grep="pattern" -</code></pre><p>The arguments will only be passed to the script specified after <code>npm run</code> +<pre><code>npm run test -- --grep="pattern"</code></pre><p>The arguments will only be passed to the script specified after <code>npm run</code> and not to any pre or post script.</p> <p>The <code>env</code> 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 @@ -36,10 +34,8 @@ built-in.</p> locally-installed dependencies can be used without the <code>node_modules/.bin</code> prefix. For example, if there is a <code>devDependency</code> on <code>tap</code> in your package, you should write:</p> -<pre><code>"scripts": {"test": "tap test/\*.js"} -</code></pre><p>instead of</p> -<pre><code>"scripts": {"test": "node_modules/.bin/tap test/\*.js"} -</code></pre><p>to run your tests.</p> +<pre><code>"scripts": {"test": "tap test/\*.js"}</code></pre><p>instead of</p> +<pre><code>"scripts": {"test": "node_modules/.bin/tap test/\*.js"} </code></pre><p>to run your tests.</p> <p>The actual shell your script is run within is platform dependent. By default, on Unix-like systems it is the <code>/bin/sh</code> command, on Windows it is the <code>cmd.exe</code>. The actual shell referred to by <code>/bin/sh</code> also depends on the system. @@ -83,5 +79,5 @@ without breaking the execution chain.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-run-script — npm@6.1.0</p> +<p id="footer">npm-run-script — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-search.html b/deps/npm/html/doc/cli/npm-search.html index 30a47caf7d..1015bb9e96 100644 --- a/deps/npm/html/doc/cli/npm-search.html +++ b/deps/npm/html/doc/cli/npm-search.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm search [-l|--long] [--json] [--parseable] [--no-description] [search terms ...] -aliases: s, se, find -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: s, se, find</code></pre><h2 id="description">DESCRIPTION</h2> <p>Search the registry for packages matching the search terms. <code>npm search</code> performs a linear, incremental, lexically-ordered search through package metadata for all files in the registry. If color is enabled, it will further @@ -109,5 +108,5 @@ setting.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-search — npm@6.1.0</p> +<p id="footer">npm-search — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-shrinkwrap.html b/deps/npm/html/doc/cli/npm-shrinkwrap.html index b4a740e413..9784d1da24 100644 --- a/deps/npm/html/doc/cli/npm-shrinkwrap.html +++ b/deps/npm/html/doc/cli/npm-shrinkwrap.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-shrinkwrap.html">npm-shrinkwrap</a></h1> <p>Lock down dependency versions for publication</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm shrinkwrap -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm shrinkwrap</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command repurposes <code>package-lock.json</code> into a publishable <code>npm-shrinkwrap.json</code> or simply creates a new one. The file created and updated by this command will then take precedence over any other existing or future @@ -41,5 +40,5 @@ of package locks in npm, see <a href="../files/npm-package-locks.html">npm-packa <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-shrinkwrap — npm@6.1.0</p> +<p id="footer">npm-shrinkwrap — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-star.html b/deps/npm/html/doc/cli/npm-star.html index ef57f2254c..36325e3931 100644 --- a/deps/npm/html/doc/cli/npm-star.html +++ b/deps/npm/html/doc/cli/npm-star.html @@ -12,8 +12,7 @@ <h1><a href="../cli/npm-star.html">npm-star</a></h1> <p>Mark your favorite packages</p> <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm star [<pkg>...] -npm unstar [<pkg>...] -</code></pre><h2 id="description">DESCRIPTION</h2> +npm unstar [<pkg>...]</code></pre><h2 id="description">DESCRIPTION</h2> <p>"Starring" a package means that you have some interest in it. It's a vaguely positive way to show that you care.</p> <p>"Unstarring" is the same thing, but in reverse.</p> @@ -36,5 +35,5 @@ a vaguely positive way to show that you care.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-star — npm@6.1.0</p> +<p id="footer">npm-star — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-stars.html b/deps/npm/html/doc/cli/npm-stars.html index 9b28be20e0..c2cdcaf081 100644 --- a/deps/npm/html/doc/cli/npm-stars.html +++ b/deps/npm/html/doc/cli/npm-stars.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-stars.html">npm-stars</a></h1> <p>View packages marked as favorites</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm stars [<user>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm stars [<user>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>If you have starred a lot of neat things and want to find them again quickly this command lets you do just that.</p> <p>You may also want to see your friend's favorite packages, in this case @@ -36,5 +35,5 @@ you will most certainly enjoy this command.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-stars — npm@6.1.0</p> +<p id="footer">npm-stars — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-start.html b/deps/npm/html/doc/cli/npm-start.html index 258673ccfd..4d61a463af 100644 --- a/deps/npm/html/doc/cli/npm-start.html +++ b/deps/npm/html/doc/cli/npm-start.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-start.html">npm-start</a></h1> <p>Start a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm start [-- <args>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm start [-- <args>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs an arbitrary command specified in the package's <code>"start"</code> property of its <code>"scripts"</code> object. If no <code>"start"</code> property is specified on the <code>"scripts"</code> object, it will run <code>node server.js</code>.</p> @@ -39,5 +38,5 @@ more details.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-start — npm@6.1.0</p> +<p id="footer">npm-start — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-stop.html b/deps/npm/html/doc/cli/npm-stop.html index 88ce21fd9d..8f53a98b56 100644 --- a/deps/npm/html/doc/cli/npm-stop.html +++ b/deps/npm/html/doc/cli/npm-stop.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-stop.html">npm-stop</a></h1> <p>Stop a package</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm stop [-- <args>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm stop [-- <args>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "stop" script, if one was provided.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -34,5 +33,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-stop — npm@6.1.0</p> +<p id="footer">npm-stop — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-team.html b/deps/npm/html/doc/cli/npm-team.html index 9c89f72947..f4fb339a88 100644 --- a/deps/npm/html/doc/cli/npm-team.html +++ b/deps/npm/html/doc/cli/npm-team.html @@ -19,8 +19,7 @@ npm team rm <scope:team> <user> npm team ls <scope>|<scope:team> -npm team edit <scope:team> -</code></pre><h2 id="description">DESCRIPTION</h2> +npm team edit <scope:team></code></pre><h2 id="description">DESCRIPTION</h2> <p>Used to manage teams in organizations, and change team memberships. Does not handle permissions for packages.</p> <p>Teams must always be fully qualified with the organization/scope they belong to @@ -70,5 +69,5 @@ use the <code>npm access</code> command to grant or revoke the appropriate permi <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-team — npm@6.1.0</p> +<p id="footer">npm-team — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-test.html b/deps/npm/html/doc/cli/npm-test.html index 4abe456952..b559534388 100644 --- a/deps/npm/html/doc/cli/npm-test.html +++ b/deps/npm/html/doc/cli/npm-test.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code> npm test [-- <args>] - aliases: t, tst -</code></pre><h2 id="description">DESCRIPTION</h2> + aliases: t, tst</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "test" script, if one was provided.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -36,5 +35,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-test — npm@6.1.0</p> +<p id="footer">npm-test — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-token.html b/deps/npm/html/doc/cli/npm-token.html index c39e39779a..3c48209cee 100644 --- a/deps/npm/html/doc/cli/npm-token.html +++ b/deps/npm/html/doc/cli/npm-token.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm token list [--json|--parseable] npm token create [--read-only] [--cidr=1.1.1.1/24,2.2.2.2/16] -npm token revoke <id|token> -</code></pre><h2 id="description">DESCRIPTION</h2> +npm token revoke <id|token></code></pre><h2 id="description">DESCRIPTION</h2> <p>This list you list, create and revoke authentication tokens.</p> <ul> <li><p><code>npm token list</code>: @@ -36,8 +35,7 @@ JSON with <code>--json</code> or tab-separated values with <code>--parseable</co | 68c2fe | 127e51… | 2017-09-23 | no | | +--------+---------+------------+----------+----------------+ | 6334e1 | 1dadd1… | 2017-09-23 | no | | -+--------+---------+------------+----------+----------------+ -</code></pre></li> ++--------+---------+------------+----------+----------------+</code></pre></li> <li><p><code>npm token create [--read-only] [--cidr=<cidr-ranges>]</code>: Create a new authentication token. It can be <code>--read-only</code> or accept a list of <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">CIDR</a> ranges to @@ -53,8 +51,7 @@ two-factor authentication enabled, an otp.</p> | readonly | false | +----------------+--------------------------------------+ | created | 2017-10-02T07:52:24.838Z | -+----------------+--------------------------------------+ -</code></pre><ul> ++----------------+--------------------------------------+</code></pre><ul> <li><code>npm token revoke <token|id></code>: This removes an authentication token, making it immediately unusable. This can accept both complete tokens (as you get back from <code>npm token create</code> and will @@ -73,4 +70,4 @@ This will NOT accept the truncated token found in <code>npm token list</code> ou <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-token — npm@6.1.0</p> +<p id="footer">npm-token — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-uninstall.html b/deps/npm/html/doc/cli/npm-uninstall.html index 9a6b4ec1d7..a935b7b05c 100644 --- a/deps/npm/html/doc/cli/npm-uninstall.html +++ b/deps/npm/html/doc/cli/npm-uninstall.html @@ -13,13 +13,11 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm uninstall [<@scope>/]<pkg>[@<version>]... [-S|--save|-D|--save-dev|-O|--save-optional|--no-save] -aliases: remove, rm, r, un, unlink -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: remove, rm, r, un, unlink</code></pre><h2 id="description">DESCRIPTION</h2> <p>This uninstalls a package, completely removing everything npm installed on its behalf.</p> <p>Example:</p> -<pre><code>npm uninstall sax -</code></pre><p>In global mode (ie, with <code>-g</code> or <code>--global</code> appended to the command), +<pre><code>npm uninstall sax</code></pre><p>In global mode (ie, with <code>-g</code> or <code>--global</code> appended to the command), it uninstalls the current package context as a global package.</p> <p><code>npm uninstall</code> takes 3 exclusive, optional flags which save or update the package version in your main package.json:</p> @@ -41,8 +39,7 @@ well.</p> npm uninstall @myorg/privatepackage --save npm uninstall node-tap --save-dev npm uninstall dtrace-provider --save-optional -npm uninstall lodash --no-save -</code></pre><h2 id="see-also">SEE ALSO</h2> +npm uninstall lodash --no-save</code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-prune.html">npm-prune(1)</a></li> <li><a href="../cli/npm-install.html">npm-install(1)</a></li> @@ -63,5 +60,5 @@ npm uninstall lodash --no-save <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-uninstall — npm@6.1.0</p> +<p id="footer">npm-uninstall — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-unpublish.html b/deps/npm/html/doc/cli/npm-unpublish.html index 72e84ce862..6b68e3528b 100644 --- a/deps/npm/html/doc/cli/npm-unpublish.html +++ b/deps/npm/html/doc/cli/npm-unpublish.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-unpublish.html">npm-unpublish</a></h1> <p>Remove a package from the registry</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm unpublish [<@scope>/]<pkg>[@<version>] -</code></pre><h2 id="warning">WARNING</h2> +<pre><code>npm unpublish [<@scope>/]<pkg>[@<version>]</code></pre><h2 id="warning">WARNING</h2> <p><strong>It is generally considered bad behavior to remove versions of a library that others are depending on!</strong></p> <p>Consider using the <code>deprecate</code> command @@ -27,9 +26,10 @@ the root package entry is removed from the registry entirely.</p> version combination can never be reused. In order to publish the package again, a new version number must be used.</p> <p>With the default registry (<code>registry.npmjs.org</code>), unpublish is -only allowed with versions published in the last 24 hours. If you -are trying to unpublish a version published longer ago than that, -contact <a href="mailto:support@npmjs.com">support@npmjs.com</a>.</p> +only allowed with versions published in the last 72 hours. Similarly, +new versions of unpublished packages may not be republished until 72 hours +have passed. If you are trying to unpublish a version published longer +ago than that, contact <a href="mailto:support@npmjs.com">support@npmjs.com</a>.</p> <p>The scope is optional and follows the usual rules for <code><a href="../misc/npm-scope.html">npm-scope(7)</a></code>.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -51,5 +51,5 @@ contact <a href="mailto:support@npmjs.com">support@npmjs.com</a>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-unpublish — npm@6.1.0</p> +<p id="footer">npm-unpublish — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-update.html b/deps/npm/html/doc/cli/npm-update.html index 5b3f2a585d..29ed302416 100644 --- a/deps/npm/html/doc/cli/npm-update.html +++ b/deps/npm/html/doc/cli/npm-update.html @@ -13,8 +13,7 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm update [-g] [<pkg>...] -aliases: up, upgrade -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: up, upgrade</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will update all the packages listed to the latest version (specified by the <code>tag</code> config), respecting semver.</p> <p>It will also install missing packages. As with all commands that install @@ -24,14 +23,14 @@ as well.</p> packages.</p> <p>If no package name is specified, all packages in the specified location (global or local) will be updated.</p> -<p>As of <a href="mailto:`npm@2.6.1">`npm@2.6.1</a><code>, the</code>npm update<code>will only inspect top-level packages. +<p>As of <a href="mailto:%60npm@2.6.1">`npm@2.6.1</a><code>, the</code>npm update<code>will only inspect top-level packages. Prior versions of</code>npm<code>would also recursively inspect all dependencies. To get the old behavior, use</code>npm --depth 9999 update`.</p> -<p>As of <a href="mailto:`npm@5.0.0">`npm@5.0.0</a><code>, the</code>npm update<code>will change</code>package.json<code>to save the +<p>As of <a href="mailto:%60npm@5.0.0">`npm@5.0.0</a><code>, the</code>npm update<code>will change</code>package.json<code>to save the new version as the minimum required dependency. To get the old behavior, use</code>npm update --no-save`.</p> <h2 id="examples">EXAMPLES</h2> -<p>IMPORTANT VERSION NOTE: these examples assume <a href="mailto:`npm@2.6.1">`npm@2.6.1</a><code>or later. For +<p>IMPORTANT VERSION NOTE: these examples assume <a href="mailto:%60npm@2.6.1">`npm@2.6.1</a><code>or later. For older versions of</code>npm<code>, you must specify</code>--depth 0` to get the behavior described below.</p> <p>For the examples below, assume that the current package is <code>app</code> and it depends @@ -49,33 +48,28 @@ on dependencies, <code>dep1</code> (<code>dep2</code>, .. etc.). The published "0.4.0", "0.2.0" ] -} -</code></pre><h3 id="caret-dependencies">Caret Dependencies</h3> +}</code></pre><h3 id="caret-dependencies">Caret Dependencies</h3> <p>If <code>app</code>'s <code>package.json</code> contains:</p> <pre><code>"dependencies": { "dep1": "^1.1.1" -} -</code></pre><p>Then <code>npm update</code> will install <a href="mailto:`dep1@1.2.2">`dep1@1.2.2</a><code>, because</code>1.2.2<code>is</code>latest<code>and</code>1.2.2<code>satisfies</code>^1.1.1`.</p> +}</code></pre><p>Then <code>npm update</code> will install <a href="mailto:%60dep1@1.2.2">`dep1@1.2.2</a><code>, because</code>1.2.2<code>is</code>latest<code>and</code>1.2.2<code>satisfies</code>^1.1.1`.</p> <h3 id="tilde-dependencies">Tilde Dependencies</h3> <p>However, if <code>app</code>'s <code>package.json</code> contains:</p> <pre><code>"dependencies": { "dep1": "~1.1.1" -} -</code></pre><p>In this case, running <code>npm update</code> will install <a href="mailto:`dep1@1.1.2">`dep1@1.1.2</a><code>. Even though the</code>latest<code>tag points to</code>1.2.2<code>, this version does not satisfy</code>~1.1.1<code>, which is equivalent +}</code></pre><p>In this case, running <code>npm update</code> will install <a href="mailto:%60dep1@1.1.2">`dep1@1.1.2</a><code>. Even though the</code>latest<code>tag points to</code>1.2.2<code>, this version does not satisfy</code>~1.1.1<code>, which is equivalent to</code>>=1.1.1 <1.2.0<code>. So the highest-sorting version that satisfies</code>~1.1.1<code>is used, which is</code>1.1.2`.</p> <h3 id="caret-dependencies-below-1-0-0">Caret Dependencies below 1.0.0</h3> <p>Suppose <code>app</code> has a caret dependency on a version below <code>1.0.0</code>, for example:</p> <pre><code>"dependencies": { "dep1": "^0.2.0" -} -</code></pre><p><code>npm update</code> will install <a href="mailto:`dep1@0.2.0">`dep1@0.2.0</a><code>, because there are no other +}</code></pre><p><code>npm update</code> will install <a href="mailto:%60dep1@0.2.0">`dep1@0.2.0</a><code>, because there are no other versions which satisfy</code>^0.2.0`.</p> <p>If the dependence were on <code>^0.4.0</code>:</p> <pre><code>"dependencies": { "dep1": "^0.4.0" -} -</code></pre><p>Then <code>npm update</code> will install <a href="mailto:`dep1@0.4.1">`dep1@0.4.1</a><code>, because that is the highest-sorting +}</code></pre><p>Then <code>npm update</code> will install <a href="mailto:%60dep1@0.4.1">`dep1@0.4.1</a><code>, because that is the highest-sorting version that satisfies</code>^0.4.0<code>(</code>>= 0.4.0 <0.5.0`)</p> <h3 id="updating-globally-installed-packages">Updating Globally-Installed Packages</h3> <p><code>npm update -g</code> will apply the <code>update</code> action to each globally installed @@ -104,5 +98,5 @@ be <em>downgraded</em>.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-update — npm@6.1.0</p> +<p id="footer">npm-update — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-version.html b/deps/npm/html/doc/cli/npm-version.html index 3349206a76..2432c35610 100644 --- a/deps/npm/html/doc/cli/npm-version.html +++ b/deps/npm/html/doc/cli/npm-version.html @@ -15,8 +15,7 @@ 'npm [-v | --version]' to print npm version 'npm view <pkg> version' to view a package's published version -'npm ls' to inspect current package/dependency versions -</code></pre><h2 id="description">DESCRIPTION</h2> +'npm ls' to inspect current package/dependency versions</code></pre><h2 id="description">DESCRIPTION</h2> <p>Run this in a package directory to bump the version and write the new data back to <code>package.json</code>, <code>package-lock.json</code>, and, if present, <code>npm-shrinkwrap.json</code>.</p> <p>The <code>newversion</code> argument should be a valid semver string, a @@ -33,8 +32,7 @@ It will fail if the working directory is not clean, unless the <code>-f</code> o use it as a commit message when creating a version commit. If the <code>message</code> config contains <code>%s</code> then that will be replaced with the resulting version number. For example:</p> -<pre><code>npm version patch -m "Upgrade to %s for reasons" -</code></pre><p>If the <code>sign-git-tag</code> config is set, then the tag will be signed using +<pre><code>npm version patch -m "Upgrade to %s for reasons"</code></pre><p>If the <code>sign-git-tag</code> config is set, then the tag will be signed using the <code>-s</code> 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> <pre><code>$ npm config set sign-git-tag true @@ -44,8 +42,7 @@ You need a passphrase to unlock the secret key for user: "isaacs (http://blog.izs.me/) <i@izs.me>" 2048-bit RSA key, ID 6C481CF6, created 2010-08-31 -Enter passphrase: -</code></pre><p>If <code>preversion</code>, <code>version</code>, or <code>postversion</code> are in the <code>scripts</code> property of +Enter passphrase:</code></pre><p>If <code>preversion</code>, <code>version</code>, or <code>postversion</code> are in the <code>scripts</code> property of the package.json, they will be executed as part of running <code>npm version</code>.</p> <p>The exact order of execution is as follows:</p> <ol> @@ -68,8 +65,7 @@ the commit and/or tag.</li> "preversion": "npm test", "version": "npm run build && git add -A dist", "postversion": "git push && git push --tags && rm -rf build/temp" -} -</code></pre><p>This runs all your tests, and proceeds only if they pass. Then runs your <code>build</code> script, and +}</code></pre><p>This runs all your tests, and proceeds only if they pass. Then runs your <code>build</code> script, and adds everything in the <code>dist</code> directory to the commit. After the commit, it pushes the new commit and tag up to the server, and deletes the <code>build/temp</code> directory.</p> <h2 id="configuration">CONFIGURATION</h2> @@ -120,5 +116,5 @@ to the same value as the current version.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-version — npm@6.1.0</p> +<p id="footer">npm-version — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-view.html b/deps/npm/html/doc/cli/npm-view.html index bde97a8e15..58c7fc1d8a 100644 --- a/deps/npm/html/doc/cli/npm-view.html +++ b/deps/npm/html/doc/cli/npm-view.html @@ -13,50 +13,39 @@ <h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm view [<@scope>/]<name>[@<version>] [<field>[.<subfield>]...] -aliases: info, show, v -</code></pre><h2 id="description">DESCRIPTION</h2> +aliases: info, show, v</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command shows data about a package and prints it to the stream referenced by the <code>outfd</code> config, which defaults to stdout.</p> <p>To show the package registry entry for the <code>connect</code> package, you can do this:</p> -<pre><code>npm view connect -</code></pre><p>The default version is "latest" if unspecified.</p> +<pre><code>npm view connect</code></pre><p>The default version is "latest" if unspecified.</p> <p>Field names can be specified after the package descriptor. For example, to show the dependencies of the <code>ronn</code> package at version 0.3.5, you could do the following:</p> -<pre><code>npm view ronn@0.3.5 dependencies -</code></pre><p>You can view child fields by separating them with a period. +<pre><code>npm view ronn@0.3.5 dependencies</code></pre><p>You can view child fields by separating them with a period. To view the git repository URL for the latest version of npm, you could do this:</p> -<pre><code>npm view npm repository.url -</code></pre><p>This makes it easy to view information about a dependency with a bit of +<pre><code>npm view npm repository.url</code></pre><p>This makes it easy to view information about a dependency with a bit of shell scripting. For example, to view all the data about the version of opts that ronn depends on, you can do this:</p> -<pre><code>npm view opts@$(npm view ronn dependencies.opts) -</code></pre><p>For fields that are arrays, requesting a non-numeric field will return +<pre><code>npm view opts@$(npm view ronn dependencies.opts)</code></pre><p>For fields that are arrays, requesting a non-numeric field will return all of the values from the objects in the list. For example, to get all the contributor names for the "express" project, you can do this:</p> -<pre><code>npm view express contributors.email -</code></pre><p>You may also use numeric indices in square braces to specifically select +<pre><code>npm view express contributors.email</code></pre><p>You may also use numeric indices in square braces to specifically select an item in an array field. To just get the email address of the first contributor in the list, you can do this:</p> -<pre><code>npm view express contributors[0].email -</code></pre><p>Multiple fields may be specified, and will be printed one after another. +<pre><code>npm view express contributors[0].email</code></pre><p>Multiple fields may be specified, and will be printed one after another. For example, to get all the contributor names and email addresses, you can do this:</p> -<pre><code>npm view express contributors.name contributors.email -</code></pre><p>"Person" fields are shown as a string if they would be shown as an +<pre><code>npm view express contributors.name contributors.email</code></pre><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 <code><a href="../files/package.json.html">package.json(5)</a></code> for more on this.)</p> -<pre><code>npm view npm contributors -</code></pre><p>If a version range is provided, then data will be printed for every +<pre><code>npm view npm contributors</code></pre><p>If a version range is provided, then data will be printed for every matching version of the package. This will show which version of jsdom was required by each matching version of yui3:</p> -<pre><code>npm view yui3@'>0.5.4' dependencies.jsdom -</code></pre><p>To show the <code>connect</code> package version history, you can do +<pre><code>npm view yui3@'>0.5.4' dependencies.jsdom</code></pre><p>To show the <code>connect</code> package version history, you can do this:</p> -<pre><code>npm view connect versions -</code></pre><h2 id="output">OUTPUT</h2> +<pre><code>npm view connect versions</code></pre><h2 id="output">OUTPUT</h2> <p>If only a single string field for a single version is output, then it will not be colorized or quoted, so as to enable piping the output to another command. If the field is an object, it will be output as a JavaScript object literal.</p> @@ -86,5 +75,5 @@ the field name.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-view — npm@6.1.0</p> +<p id="footer">npm-view — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm-whoami.html b/deps/npm/html/doc/cli/npm-whoami.html index 3fe3ff115c..4a2c5ea508 100644 --- a/deps/npm/html/doc/cli/npm-whoami.html +++ b/deps/npm/html/doc/cli/npm-whoami.html @@ -11,8 +11,7 @@ <h1><a href="../cli/npm-whoami.html">npm-whoami</a></h1> <p>Display npm username</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm whoami [--registry <registry>] -</code></pre><h2 id="description">DESCRIPTION</h2> +<pre><code>npm whoami [--registry <registry>]</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the <code>username</code> config to standard output.</p> <h2 id="see-also">SEE ALSO</h2> <ul> @@ -33,5 +32,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-whoami — npm@6.1.0</p> +<p id="footer">npm-whoami — npm@6.2.0</p> diff --git a/deps/npm/html/doc/cli/npm.html b/deps/npm/html/doc/cli/npm.html index 50114e79e7..c4bb944deb 100644 --- a/deps/npm/html/doc/cli/npm.html +++ b/deps/npm/html/doc/cli/npm.html @@ -11,9 +11,8 @@ <h1><a href="../cli/npm.html">npm</a></h1> <p>javascript package manager</p> <h2 id="synopsis">SYNOPSIS</h2> -<pre><code>npm <command> [args] -</code></pre><h2 id="version">VERSION</h2> -<p>6.1.0</p> +<pre><code>npm <command> [args]</code></pre><h2 id="version">VERSION</h2> +<p>6.2.0</p> <h2 id="description">DESCRIPTION</h2> <p>npm is the package manager for the Node JavaScript platform. It puts modules in place so that node can find them, and manages dependency @@ -45,9 +44,11 @@ the <a href="https://github.com/TooTallNate/node-gyp/wiki">node-gyp Wiki</a>.</p <p>See <code><a href="../files/npm-folders.html">npm-folders(5)</a></code> to learn about where npm puts stuff.</p> <p>In particular, npm has two modes of operation:</p> <ul> -<li>global mode:<br>npm installs packages into the install prefix at +<li>global mode: +npm installs packages into the install prefix at <code>prefix/lib/node_modules</code> and bins are installed in <code>prefix/bin</code>.</li> -<li>local mode:<br>npm installs packages into the current project directory, which +<li>local mode: +npm installs packages into the current project directory, which defaults to the current working directory. Packages are installed to <code>./node_modules</code>, and bins are installed to <code>./node_modules/.bin</code>.</li> </ul> @@ -77,56 +78,52 @@ Use the <code>npm publish</code> command to upload your code to the registry.</l <p>npm is extremely configurable. It reads its configuration options from 5 places.</p> <ul> -<li>Command line switches:<br>Set a config with <code>--key val</code>. All keys take a value, even if they +<li>Command line switches: +Set a config with <code>--key val</code>. 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 <code>true</code>.</li> -<li>Environment Variables:<br>Set any config by prefixing the name in an environment variable with +<li>Environment Variables: +Set any config by prefixing the name in an environment variable with <code>npm_config_</code>. For example, <code>export npm_config_key=val</code>.</li> -<li>User Configs:<br>The file at $HOME/.npmrc is an ini-formatted list of configs. If +<li>User Configs: +The file at $HOME/.npmrc is an ini-formatted list of configs. If present, it is parsed. If the <code>userconfig</code> option is set in the cli or env, then that will be used instead.</li> -<li>Global Configs:<br>The file found at ../etc/npmrc (from the node executable, by default +<li>Global Configs: +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 <code>globalconfig</code> option is set in the cli, env, or user config, then that file is parsed instead.</li> -<li>Defaults:<br>npm's default configuration options are defined in +<li>Defaults: +npm's default configuration options are defined in lib/utils/config-defs.js. These must not be changed.</li> </ul> <p>See <code><a href="../misc/npm-config.html">npm-config(7)</a></code> for much much more information.</p> <h2 id="contributions">CONTRIBUTIONS</h2> <p>Patches welcome!</p> -<ul> -<li>code: -Read through <code><a href="../misc/npm-coding-style.html">npm-coding-style(7)</a></code> if you plan to submit code. -You don't have to agree with it, but you do have to follow it.</li> -<li>docs: -If you find an error in the documentation, edit the appropriate markdown -file in the "doc" folder. (Don't worry about generating the man page.)</li> -</ul> -<p>Contributors are listed in npm's <code>package.json</code> file. You can view them -easily by doing <code>npm view npm contributors</code>.</p> <p>If you would like to contribute, but don't know what to work on, read the contributing guidelines and check the issues list.</p> <ul> -<li><a href="https://github.com/npm/npm/wiki/Contributing-Guidelines">https://github.com/npm/npm/wiki/Contributing-Guidelines</a></li> -<li><a href="https://github.com/npm/npm/issues">https://github.com/npm/npm/issues</a></li> +<li><a href="https://github.com/npm/cli/blob/latest/CONTRIBUTING.md">CONTRIBUTING.md</a></li> +<li><a href="https://npm.community/c/bugs">Bug tracker</a></li> +<li><a href="https://npm.community/c/support">Support tracker</a></li> </ul> <h2 id="bugs">BUGS</h2> <p>When you find issues, please report them:</p> <ul> <li>web: -<a href="https://github.com/npm/npm/issues">https://github.com/npm/npm/issues</a></li> +<a href="https://npm.community/c/bugs">https://npm.community/c/bugs</a></li> </ul> -<p>Be sure to include <em>all</em> of the output from the npm command that didn't work -as expected. The <code>npm-debug.log</code> file is also helpful to provide.</p> -<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.</p> +<p>Be sure to follow the template and bug reporting guidelines. You can also ask +for help in the <a href="https://npm.community/c/support">support forum</a> if you're +unsure if it's actually a bug or are having trouble coming up with a detailed +reproduction to report.</p> <h2 id="author">AUTHOR</h2> <p><a href="http://blog.izs.me/">Isaac Z. Schlueter</a> :: <a href="https://github.com/isaacs/">isaacs</a> :: <a href="http://twitter.com/izs">@izs</a> :: -<a href="mailto:i@izs.me">i@izs.me</a></p> +<a href="mailto:i@izs.me">i@izs.me</a></p> <h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-help.html">npm-help(1)</a></li> @@ -150,5 +147,5 @@ will no doubt tell you to put the output in a gist or email.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm — npm@6.1.0</p> +<p id="footer">npm — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npm-folders.html b/deps/npm/html/doc/files/npm-folders.html index 0f85f255b2..4a9942d7ab 100644 --- a/deps/npm/html/doc/files/npm-folders.html +++ b/deps/npm/html/doc/files/npm-folders.html @@ -121,8 +121,7 @@ highest level possible, below the localized "target" folder.</p> | `-- asdf@* `-- baz@1.2.3 `-- quux@3.x - `-- bar -</code></pre><p>In this case, we might expect a folder structure like this:</p> + `-- bar</code></pre><p>In this case, we might expect a folder structure like this:</p> <pre><code>foo +-- node_modules +-- blerg (1.2.5) <---[A] @@ -134,15 +133,14 @@ highest level possible, below the localized "target" folder.</p> | `-- asdf (2.3.4) `-- baz (1.2.3) <---[D] `-- node_modules - `-- quux (3.2.0) <---[E] -</code></pre><p>Since foo depends directly on <a href="mailto:`bar@1.2.3">`bar@1.2.3</a><code>and</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>, those are + `-- quux (3.2.0) <---[E]</code></pre><p>Since foo depends directly on <a href="mailto:%60bar@1.2.3">`bar@1.2.3</a><code>and</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>, those are installed in foo's</code>node_modules` folder.</p> <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 <a href="mailto:`blerg@1.x">`blerg@1.x</a>`, +parent installation of blerg satisfies bar's dependency on <a href="mailto:%60blerg@1.x">`blerg@1.x</a>`, it does not install another copy under [B].</p> <p>Bar [B] also has dependencies on baz and asdf, so those are installed in -bar's <code>node_modules</code> folder. Because it depends on <a href="mailto:`baz@2.x">`baz@2.x</a><code>, it cannot +bar's <code>node_modules</code> folder. Because it depends on <a href="mailto:%60baz@2.x">`baz@2.x</a><code>, it cannot re-use the</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>installed in the parent</code>node_modules` folder [D], and must install its own copy [C].</p> <p>Underneath bar, the <code>baz -> quux -> bar</code> dependency creates a cycle. @@ -181,5 +179,5 @@ cannot be found elsewhere. See <code><a href="../files/package.json.html">packa <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-folders — npm@6.1.0</p> +<p id="footer">npm-folders — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npm-global.html b/deps/npm/html/doc/files/npm-global.html index 0f85f255b2..4a9942d7ab 100644 --- a/deps/npm/html/doc/files/npm-global.html +++ b/deps/npm/html/doc/files/npm-global.html @@ -121,8 +121,7 @@ highest level possible, below the localized "target" folder.</p> | `-- asdf@* `-- baz@1.2.3 `-- quux@3.x - `-- bar -</code></pre><p>In this case, we might expect a folder structure like this:</p> + `-- bar</code></pre><p>In this case, we might expect a folder structure like this:</p> <pre><code>foo +-- node_modules +-- blerg (1.2.5) <---[A] @@ -134,15 +133,14 @@ highest level possible, below the localized "target" folder.</p> | `-- asdf (2.3.4) `-- baz (1.2.3) <---[D] `-- node_modules - `-- quux (3.2.0) <---[E] -</code></pre><p>Since foo depends directly on <a href="mailto:`bar@1.2.3">`bar@1.2.3</a><code>and</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>, those are + `-- quux (3.2.0) <---[E]</code></pre><p>Since foo depends directly on <a href="mailto:%60bar@1.2.3">`bar@1.2.3</a><code>and</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>, those are installed in foo's</code>node_modules` folder.</p> <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 <a href="mailto:`blerg@1.x">`blerg@1.x</a>`, +parent installation of blerg satisfies bar's dependency on <a href="mailto:%60blerg@1.x">`blerg@1.x</a>`, it does not install another copy under [B].</p> <p>Bar [B] also has dependencies on baz and asdf, so those are installed in -bar's <code>node_modules</code> folder. Because it depends on <a href="mailto:`baz@2.x">`baz@2.x</a><code>, it cannot +bar's <code>node_modules</code> folder. Because it depends on <a href="mailto:%60baz@2.x">`baz@2.x</a><code>, it cannot re-use the</code><a href="mailto:baz@1.2.3">baz@1.2.3</a><code>installed in the parent</code>node_modules` folder [D], and must install its own copy [C].</p> <p>Underneath bar, the <code>baz -> quux -> bar</code> dependency creates a cycle. @@ -181,5 +179,5 @@ cannot be found elsewhere. See <code><a href="../files/package.json.html">packa <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-folders — npm@6.1.0</p> +<p id="footer">npm-folders — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npm-json.html b/deps/npm/html/doc/files/npm-json.html index 42e47069f2..0edcca4702 100644 --- a/deps/npm/html/doc/files/npm-json.html +++ b/deps/npm/html/doc/files/npm-json.html @@ -63,16 +63,14 @@ discover your package as it's listed in <code>npm search</code>.</p> <h2 id="homepage">homepage</h2> <p>The url to the project homepage.</p> <p>Example:</p> -<pre><code>"homepage": "https://github.com/owner/project#readme" -</code></pre><h2 id="bugs">bugs</h2> +<pre><code>"homepage": "https://github.com/owner/project#readme"</code></pre><h2 id="bugs">bugs</h2> <p>The url to your project's issue tracker and / or the email address to which issues should be reported. These are helpful for people who encounter issues with your package.</p> <p>It should look like this:</p> <pre><code>{ "url" : "https://github.com/owner/project/issues" , "email" : "project@hostname.com" -} -</code></pre><p>You can specify either one or both values. If you want to provide only a url, +}</code></pre><p>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> <p>If a url is provided, it will be used by the <code>npm bugs</code> command.</p> <h2 id="license">license</h2> @@ -80,17 +78,14 @@ you can specify the value for "bugs" as a simple string instead of an permitted to use it, and any restrictions you're placing on it.</p> <p>If you're using a common license such as BSD-2-Clause or MIT, add a current SPDX license identifier for the license you're using, like this:</p> -<pre><code>{ "license" : "BSD-3-Clause" } -</code></pre><p>You can check <a href="https://spdx.org/licenses/">the full list of SPDX license IDs</a>. +<pre><code>{ "license" : "BSD-3-Clause" }</code></pre><p>You can check <a href="https://spdx.org/licenses/">the full list of SPDX license IDs</a>. Ideally you should pick one that is <a href="https://opensource.org/licenses/alphabetical">OSI</a> approved.</p> <p>If your package is licensed under multiple common licenses, use an <a href="https://npmjs.com/package/spdx">SPDX license expression syntax version 2.0 string</a>, like this:</p> -<pre><code>{ "license" : "(ISC OR GPL-3.0)" } -</code></pre><p>If you are using a license that hasn't been assigned an SPDX identifier, or if +<pre><code>{ "license" : "(ISC OR GPL-3.0)" }</code></pre><p>If you are using a license that hasn't been assigned an SPDX identifier, or if you are using a custom license, use a string value like this one:</p> -<pre><code>{ "license" : "SEE LICENSE IN <filename>" } -</code></pre><p>Then include a file named <code><filename></code> at the top level of the package.</p> +<pre><code>{ "license" : "SEE LICENSE IN <filename>" }</code></pre><p>Then include a file named <code><filename></code> at the top level of the package.</p> <p>Some old packages used license objects or a "licenses" property containing an array of license objects:</p> <pre><code>// Not valid metadata @@ -110,25 +105,20 @@ array of license objects:</p> , "url": "https://opensource.org/licenses/apache2.0.php" } ] -} -</code></pre><p>Those styles are now deprecated. Instead, use SPDX expressions, like this:</p> +}</code></pre><p>Those styles are now deprecated. Instead, use SPDX expressions, like this:</p> <pre><code>{ "license": "ISC" } -{ "license": "(MIT OR Apache-2.0)" } -</code></pre><p>Finally, if you do not wish to grant others the right to use a private or +{ "license": "(MIT OR Apache-2.0)" }</code></pre><p>Finally, if you do not wish to grant others the right to use a private or unpublished package under any terms:</p> -<pre><code>{ "license": "UNLICENSED" } -</code></pre><p>Consider also setting <code>"private": true</code> to prevent accidental publication.</p> +<pre><code>{ "license": "UNLICENSED" }</code></pre><p>Consider also setting <code>"private": true</code> to prevent accidental publication.</p> <h2 id="people-fields-author-contributors">people fields: author, contributors</h2> <p>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:</p> <pre><code>{ "name" : "Barney Rubble" , "email" : "b@rubble.com" , "url" : "http://barnyrubble.tumblr.com/" -} -</code></pre><p>Or you can shorten that all into a single string, and npm will parse it for you:</p> -<pre><code>"Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)" -</code></pre><p>Both email and url are optional either way.</p> +}</code></pre><p>Or you can shorten that all into a single string, and npm will parse it for you:</p> +<pre><code>"Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)"</code></pre><p>Both email and url are optional either way.</p> <p>npm also sets a top-level "maintainers" field with your npm user info.</p> <h2 id="files">files</h2> <p>The optional <code>files</code> field is an array of file patterns that describes @@ -195,19 +185,16 @@ command name to local file name. On install, npm will symlink that file into <code>prefix/bin</code> for global installs, or <code>./node_modules/.bin/</code> for local installs.</p> <p>For example, myapp could have this:</p> -<pre><code>{ "bin" : { "myapp" : "./cli.js" } } -</code></pre><p>So, when you install myapp, it'll create a symlink from the <code>cli.js</code> script to +<pre><code>{ "bin" : { "myapp" : "./cli.js" } }</code></pre><p>So, when you install myapp, it'll create a symlink from the <code>cli.js</code> script to <code>/usr/local/bin/myapp</code>.</p> <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:</p> <pre><code>{ "name": "my-program" , "version": "1.2.5" -, "bin": "./path/to/program" } -</code></pre><p>would be the same as this:</p> +, "bin": "./path/to/program" }</code></pre><p>would be the same as this:</p> <pre><code>{ "name": "my-program" , "version": "1.2.5" -, "bin" : { "my-program" : "./path/to/program" } } -</code></pre><p>Please make sure that your file(s) referenced in <code>bin</code> starts with +, "bin" : { "my-program" : "./path/to/program" } }</code></pre><p>Please make sure that your file(s) referenced in <code>bin</code> starts with <code>#!/usr/bin/env node</code>, otherwise the scripts are started without the node executable!</p> <h2 id="man">man</h2> @@ -220,8 +207,7 @@ result from <code>man <pkgname></code>, regardless of its actual filename. , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : "./man/doc.1" -} -</code></pre><p>would link the <code>./man/doc.1</code> file in such that it is the target for <code>man foo</code></p> +}</code></pre><p>would link the <code>./man/doc.1</code> file in such that it is the target for <code>man foo</code></p> <p>If the filename doesn't start with the package name, then it's prefixed. So, this:</p> <pre><code>{ "name" : "foo" @@ -229,8 +215,7 @@ So, this:</p> , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : [ "./man/foo.1", "./man/bar.1" ] -} -</code></pre><p>will create files to do <code>man foo</code> and <code>man foo-bar</code>.</p> +}</code></pre><p>will create files to do <code>man foo</code> and <code>man foo-bar</code>.</p> <p>Man files must end with a number, and optionally a <code>.gz</code> suffix if they are compressed. The number dictates which man section the file is installed into.</p> <pre><code>{ "name" : "foo" @@ -238,8 +223,7 @@ compressed. The number dictates which man section the file is installed into.</ , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : [ "./man/foo.1", "./man/foo.2" ] -} -</code></pre><p>will create entries for <code>man foo</code> and <code>man 2 foo</code></p> +}</code></pre><p>will create entries for <code>man foo</code> and <code>man 2 foo</code></p> <h2 id="directories">directories</h2> <p>The CommonJS <a href="http://wiki.commonjs.org/wiki/Packages/1.0">Packages</a> spec details a few ways that you can indicate the structure of your package using a <code>directories</code> @@ -274,14 +258,13 @@ command will be able to find you.</p> <p>Do it like this:</p> <pre><code>"repository" : { "type" : "git" - , "url" : "https://github.com/npm/npm.git" + , "url" : "https://github.com/npm/cli.git" } "repository" : { "type" : "svn" , "url" : "https://v8.googlecode.com/svn/trunk/" - } -</code></pre><p>The URL should be a publicly available (perhaps read-only) url that can be handed + }</code></pre><p>The URL should be a publicly available (perhaps read-only) url that can be handed directly to a VCS program without any modification. It should not be a url to an html project page that you put in your browser. It's for computers.</p> <p>For GitHub, GitHub gist, Bitbucket, or GitLab repositories you can use the same @@ -294,8 +277,7 @@ shortcut syntax you use for <code>npm install</code>:</p> "repository": "bitbucket:user/repo" -"repository": "gitlab:user/repo" -</code></pre><h2 id="scripts">scripts</h2> +"repository": "gitlab:user/repo"</code></pre><h2 id="scripts">scripts</h2> <p>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> @@ -305,8 +287,7 @@ event, and the value is the command to run at that point.</p> scripts that persist across upgrades. For instance, if a package had the following:</p> <pre><code>{ "name" : "foo" -, "config" : { "port" : "8080" } } -</code></pre><p>and then had a "start" command that then referenced the +, "config" : { "port" : "8080" } }</code></pre><p>and then had a "start" command that then referenced the <code>npm_package_config_port</code> environment variable, then the user could override that by doing <code>npm config set foo:port 8001</code>.</p> <p>See <code><a href="../misc/npm-config.html">npm-config(7)</a></code> and <code><a href="../misc/npm-scripts.html">npm-scripts(7)</a></code> for more on package @@ -353,15 +334,13 @@ tarball or git URL.</p> , "lat" : "latest" , "dyl" : "file:../dyl" } -} -</code></pre><h3 id="urls-as-dependencies">URLs as Dependencies</h3> +}</code></pre><h3 id="urls-as-dependencies">URLs as Dependencies</h3> <p>You may specify a tarball URL in place of a version range.</p> <p>This tarball will be downloaded and installed locally to your package at install time.</p> <h3 id="git-urls-as-dependencies">Git URLs as Dependencies</h3> <p>Git urls are of the form:</p> -<pre><code><protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>] -</code></pre><p><code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or +<pre><code><protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>]</code></pre><p><code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or <code>git+file</code>.</p> <p>If <code>#<commit-ish></code> is provided, it will be used to clone exactly that commit. If the commit-ish has the format <code>#semver:<semver></code>, <code><semver></code> can @@ -370,11 +349,10 @@ or refs matching that range in the remote repository, much as it would for a registry dependency. If neither <code>#<commit-ish></code> or <code>#semver:<semver></code> is specified, then <code>master</code> is used.</p> <p>Examples:</p> -<pre><code>git+ssh://git@github.com:npm/npm.git#v1.0.27 -git+ssh://git@github.com:npm/npm#semver:^5.0 -git+https://isaacs@github.com/npm/npm.git -git://github.com/npm/npm.git#v1.0.27 -</code></pre><h3 id="github-urls">GitHub URLs</h3> +<pre><code>git+ssh://git@github.com:npm/cli.git#v1.0.27 +git+ssh://git@github.com:npm/cli#semver:^5.0 +git+https://isaacs@github.com/npm/cli.git +git://github.com/npm/cli.git#v1.0.27</code></pre><h3 id="github-urls">GitHub URLs</h3> <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 <code>commit-ish</code> suffix can be included. For example:</p> @@ -386,24 +364,21 @@ included. For example:</p> "mocha": "mochajs/mocha#4727d357ea", "module": "user/repo#feature\/branch" } -} -</code></pre><h3 id="local-paths">Local Paths</h3> +}</code></pre><h3 id="local-paths">Local Paths</h3> <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 <code>npm install -S</code> or <code>npm install --save</code>, using any of these forms:</p> <pre><code>../foo/bar ~/foo/bar ./foo/bar -/foo/bar -</code></pre><p>in which case they will be normalized to a relative path and added to your +/foo/bar</code></pre><p>in which case they will be normalized to a relative path and added to your <code>package.json</code>. For example:</p> <pre><code>{ "name": "baz", "dependencies": { "bar": "file:../foo/bar" } -} -</code></pre><p>This feature is helpful for local offline development and creating +}</code></pre><p>This feature is helpful for local offline development and creating tests that require npm installing where you don't want to hit an external server, but should not be used when publishing packages to the public registry.</p> @@ -430,8 +405,7 @@ script to do this, and make the required package a devDependency.</p> "prepare": "coffee -o lib/ -c src/waza.coffee" }, "main": "lib/waza.js" -} -</code></pre><p>The <code>prepare</code> script will be run before publishing, so that users +}</code></pre><p>The <code>prepare</code> 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 <code>npm install</code>), it'll run this script as well, so that you can test it easily.</p> @@ -447,13 +421,11 @@ a specific interface, expected and specified by the host documentation.</p> "peerDependencies": { "tea": "2.x" } -} -</code></pre><p>This ensures your package <code>tea-latte</code> can be installed <em>along</em> with the second +}</code></pre><p>This ensures your package <code>tea-latte</code> can be installed <em>along</em> with the second major version of the host package <code>tea</code> only. <code>npm install tea-latte</code> could possibly yield the following dependency graph:</p> <pre><code>├── tea-latte@1.3.5 -└── tea@2.2.0 -</code></pre><p><strong>NOTE: npm versions 1 and 2 will automatically install <code>peerDependencies</code> if +└── tea@2.2.0</code></pre><p><strong>NOTE: npm versions 1 and 2 will automatically install <code>peerDependencies</code> 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.</strong> The @@ -481,8 +453,7 @@ array and executing <code>npm pack</code>.</p> "bundledDependencies": [ "renderized", "super-streams" ] -} -</code></pre><p>we can obtain <code>awesome-web-framework-1.0.0.tgz</code> file by running <code>npm pack</code>. +}</code></pre><p>we can obtain <code>awesome-web-framework-1.0.0.tgz</code> file by running <code>npm pack</code>. This file contains the dependencies <code>renderized</code> and <code>super-streams</code> which can be installed in a new project by executing <code>npm install awesome-web-framework-1.0.0.tgz</code>.</p> @@ -509,21 +480,18 @@ if ( notGoodFooVersion(fooVersion) ) { if (foo) { foo.doFooThings() -} -</code></pre><p>Entries in <code>optionalDependencies</code> will override entries of the same name in +}</code></pre><p>Entries in <code>optionalDependencies</code> will override entries of the same name in <code>dependencies</code>, so it's usually best to only put in one place.</p> <h2 id="engines">engines</h2> <p>You can specify the version of node that your stuff works on:</p> -<pre><code>{ "engines" : { "node" : ">=0.10.3 <0.12" } } -</code></pre><p>And, like with dependencies, if you don't specify the version (or if you +<pre><code>{ "engines" : { "node" : ">=0.10.3 <0.12" } }</code></pre><p>And, like with dependencies, if you don't specify the version (or if you specify "*" as the version), then any version of node will do.</p> <p>If you specify an "engines" field, then npm will require that "node" be somewhere on that list. If "engines" is omitted, then npm will just assume that it works on node.</p> <p>You can also use the "engines" field to specify which versions of npm are capable of properly installing your program. For example:</p> -<pre><code>{ "engines" : { "npm" : "~1.0.20" } } -</code></pre><p>Unless the user has set the <code>engine-strict</code> config flag, this +<pre><code>{ "engines" : { "npm" : "~1.0.20" } }</code></pre><p>Unless the user has set the <code>engine-strict</code> config flag, this field is advisory only and will only produce warnings when your package is installed as a dependency.</p> <h2 id="enginestrict">engineStrict</h2> <p><strong>This feature was removed in npm 3.0.0</strong></p> @@ -532,20 +500,16 @@ user had set <code>engine-strict</code>. It is no longer used.</p> <h2 id="os">os</h2> <p>You can specify which operating systems your module will run on:</p> -<pre><code>"os" : [ "darwin", "linux" ] -</code></pre><p>You can also blacklist instead of whitelist operating systems, +<pre><code>"os" : [ "darwin", "linux" ]</code></pre><p>You can also blacklist instead of whitelist operating systems, just prepend the blacklisted os with a '!':</p> -<pre><code>"os" : [ "!win32" ] -</code></pre><p>The host operating system is determined by <code>process.platform</code></p> +<pre><code>"os" : [ "!win32" ]</code></pre><p>The host operating system is determined by <code>process.platform</code></p> <p>It is allowed to both blacklist, and whitelist, although there isn't any good reason to do this.</p> <h2 id="cpu">cpu</h2> <p>If your code only runs on certain cpu architectures, you can specify which ones.</p> -<pre><code>"cpu" : [ "x64", "ia32" ] -</code></pre><p>Like the <code>os</code> option, you can also blacklist architectures:</p> -<pre><code>"cpu" : [ "!arm", "!mips" ] -</code></pre><p>The host architecture is determined by <code>process.arch</code></p> +<pre><code>"cpu" : [ "x64", "ia32" ]</code></pre><p>Like the <code>os</code> option, you can also blacklist architectures:</p> +<pre><code>"cpu" : [ "!arm", "!mips" ]</code></pre><p>The host architecture is determined by <code>process.arch</code></p> <h2 id="preferglobal">preferGlobal</h2> <p><strong>DEPRECATED</strong></p> <p>This option used to trigger an npm warning, but it will no longer warn. It is @@ -610,5 +574,5 @@ ignored.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">package.json — npm@6.1.0</p> +<p id="footer">package.json — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npm-package-locks.html b/deps/npm/html/doc/files/npm-package-locks.html index fe9115c14a..50ac0d4db8 100644 --- a/deps/npm/html/doc/files/npm-package-locks.html +++ b/deps/npm/html/doc/files/npm-package-locks.html @@ -34,31 +34,26 @@ unable to do this. There are multiple reasons for this:</p> "dependencies": { "B": "<0.1.0" } -} -</code></pre><p>package B:</p> +}</code></pre><p>package B:</p> <pre><code>{ "name": "B", "version": "0.0.1", "dependencies": { "C": "<0.1.0" } -} -</code></pre><p>and package C:</p> +}</code></pre><p>and package C:</p> <pre><code>{ "name": "C", "version": "0.0.1" -} -</code></pre><p>If these are the only versions of A, B, and C available in the +}</code></pre><p>If these are the only versions of A, B, and C available in the registry, then a normal <code>npm install A</code> will install:</p> <pre><code>A@0.1.0 `-- B@0.0.1 - `-- C@0.0.1 -</code></pre><p>However, if <a href="mailto:B@0.0.2">B@0.0.2</a> is published, then a fresh <code>npm install A</code> will + `-- C@0.0.1</code></pre><p>However, if <a href="mailto:B@0.0.2">B@0.0.2</a> is published, then a fresh <code>npm install A</code> will install:</p> <pre><code>A@0.1.0 `-- B@0.0.2 - `-- C@0.0.1 -</code></pre><p>assuming the new version did not modify B's dependencies. Of course, + `-- C@0.0.1</code></pre><p>assuming the new version did not modify B's dependencies. Of course, the new version of B could include a new version of C and any number of new dependencies. If such changes are undesirable, the author of A could specify a dependency on <a href="mailto:B@0.0.1">B@0.0.1</a>. However, if A's author and B's @@ -85,8 +80,7 @@ which will look something like this:</p> } } } -} -</code></pre><p>This file describes an <em>exact</em>, and more importantly <em>reproducible</em> +}</code></pre><p>This file describes an <em>exact</em>, and more importantly <em>reproducible</em> <code>node_modules</code> tree. Once it's present, any future installation will base its work off this file, instead of recalculating dependency versions off p<a href="../files/ackage.json.html">ackage.json(5)</a>.</p> @@ -109,8 +103,7 @@ executed afterwards. These scripts run for both <code>package-lock.json</code> a file:</p> <pre><code>"scripts": { "postshrinkwrap": "json -I -e \"this.myMetadata = $MY_APP_METADATA\"" -} -</code></pre><h3 id="using-locked-packages">Using locked packages</h3> +}</code></pre><h3 id="using-locked-packages">Using locked packages</h3> <p>Using a locked package is no different than using any package without a package lock: any commands that update <code>node_modules</code> and/or <code>package.json</code>'s dependencies will automatically sync the existing lockfile. This includes <code>npm @@ -127,7 +120,7 @@ inform you of any changes npm has made to your <code>node_modules</code>, so you if any transitive dependencies were updated, hoisted, etc.</p> <h3 id="resolving-lockfile-conflicts">Resolving lockfile conflicts</h3> <p>Occasionally, two separate npm install will create package locks that cause -merge conflicts in source control systems. As of <a href="mailto:`npm@5.7.0">`npm@5.7.0</a><code>, these conflicts +merge conflicts in source control systems. As of <a href="mailto:%60npm@5.7.0">`npm@5.7.0</a><code>, these conflicts can be resolved by manually fixing any</code>package.json<code>conflicts, and then running</code>npm install [--package-lock-only]<code>again. npm will automatically resolve any conflicts for you and write a merged package lock that includes all @@ -137,7 +130,7 @@ local</code>node_modules/`.</p> <a href="https://npm.im/npm-merge-driver"><code>npm-merge-driver</code></a>, which will teach git how to do this itself without any user interaction. In short: <code>$ npx npm-merge-driver install -g</code> will let you do this, and even works with -<a href="mailto:pre-`npm@5.7.0">pre-`npm@5.7.0</a><code>versions of npm 5, albeit a bit more noisily. Note that if</code>package.json<code>itself conflicts, you will have to resolve that by hand and run</code>npm install` manually, even with the merge driver.</p> +<a href="mailto:pre-%60npm@5.7.0">pre-`npm@5.7.0</a><code>versions of npm 5, albeit a bit more noisily. Note that if</code>package.json<code>itself conflicts, you will have to resolve that by hand and run</code>npm install` manually, even with the merge driver.</p> <h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="https://medium.com/@sdboyer/so-you-want-to-write-a-package-manager-4ae9c17d9527">https://medium.com/@sdboyer/so-you-want-to-write-a-package-manager-4ae9c17d9527</a></li> @@ -158,4 +151,4 @@ npm-merge-driver install -g</code> will let you do this, and even works with <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-package-locks — npm@6.1.0</p> +<p id="footer">npm-package-locks — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npm-shrinkwrap.json.html b/deps/npm/html/doc/files/npm-shrinkwrap.json.html index 1fca199c38..66cd483cb4 100644 --- a/deps/npm/html/doc/files/npm-shrinkwrap.json.html +++ b/deps/npm/html/doc/files/npm-shrinkwrap.json.html @@ -42,4 +42,4 @@ to the manual page for <a href="../files/package-lock.json.html">package-lock.js <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-shrinkwrap.json — npm@6.1.0</p> +<p id="footer">npm-shrinkwrap.json — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/npmrc.html b/deps/npm/html/doc/files/npmrc.html index e821a43090..bdb87a2019 100644 --- a/deps/npm/html/doc/files/npmrc.html +++ b/deps/npm/html/doc/files/npmrc.html @@ -27,21 +27,18 @@ of the user and global npmrc files.</p> <p>All npm config files are an ini-formatted list of <code>key = value</code> parameters. Environment variables can be replaced using <code>${VARIABLE_NAME}</code>. For example:</p> -<pre><code>prefix = ${HOME}/.npm-packages -</code></pre><p>Each of these files is loaded, and config options are resolved in +<pre><code>prefix = ${HOME}/.npm-packages</code></pre><p>Each of these files is loaded, and config options are resolved in priority order. For example, a setting in the userconfig file would override the setting in the globalconfig file.</p> <p>Array values are specified by adding "[]" after the key name. For example:</p> <pre><code>key[] = "first value" -key[] = "second value" -</code></pre><h4 id="comments">Comments</h4> +key[] = "second value"</code></pre><h4 id="comments">Comments</h4> <p>Lines in <code>.npmrc</code> files are interpreted as comments when they begin with a <code>;</code> or <code>#</code> character. <code>.npmrc</code> files are parsed by <a href="https://github.com/npm/ini">npm/ini</a>, which specifies this comment syntax.</p> <p>For example:</p> <pre><code># last modified: 01 Jan 2016 ; Set a new registry for a scoped package -@myscope:registry=https://mycustomregistry.example.org -</code></pre><h3 id="per-project-config-file">Per-project config file</h3> +@myscope:registry=https://mycustomregistry.example.org</code></pre><h3 id="per-project-config-file">Per-project config file</h3> <p>When working locally in a project, a <code>.npmrc</code> file in the root of the project (ie, a sibling of <code>node_modules</code> and <code>package.json</code>) will set config values specific to this project.</p> @@ -85,5 +82,5 @@ manner.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npmrc — npm@6.1.0</p> +<p id="footer">npmrc — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/package-lock.json.html b/deps/npm/html/doc/files/package-lock.json.html index fcce7979d7..82ccc40dc0 100644 --- a/deps/npm/html/doc/files/package-lock.json.html +++ b/deps/npm/html/doc/files/package-lock.json.html @@ -130,4 +130,4 @@ should match via normal matching rules a dependency either in our <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">package-lock.json — npm@6.1.0</p> +<p id="footer">package-lock.json — npm@6.2.0</p> diff --git a/deps/npm/html/doc/files/package.json.html b/deps/npm/html/doc/files/package.json.html index 42e47069f2..0edcca4702 100644 --- a/deps/npm/html/doc/files/package.json.html +++ b/deps/npm/html/doc/files/package.json.html @@ -63,16 +63,14 @@ discover your package as it's listed in <code>npm search</code>.</p> <h2 id="homepage">homepage</h2> <p>The url to the project homepage.</p> <p>Example:</p> -<pre><code>"homepage": "https://github.com/owner/project#readme" -</code></pre><h2 id="bugs">bugs</h2> +<pre><code>"homepage": "https://github.com/owner/project#readme"</code></pre><h2 id="bugs">bugs</h2> <p>The url to your project's issue tracker and / or the email address to which issues should be reported. These are helpful for people who encounter issues with your package.</p> <p>It should look like this:</p> <pre><code>{ "url" : "https://github.com/owner/project/issues" , "email" : "project@hostname.com" -} -</code></pre><p>You can specify either one or both values. If you want to provide only a url, +}</code></pre><p>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> <p>If a url is provided, it will be used by the <code>npm bugs</code> command.</p> <h2 id="license">license</h2> @@ -80,17 +78,14 @@ you can specify the value for "bugs" as a simple string instead of an permitted to use it, and any restrictions you're placing on it.</p> <p>If you're using a common license such as BSD-2-Clause or MIT, add a current SPDX license identifier for the license you're using, like this:</p> -<pre><code>{ "license" : "BSD-3-Clause" } -</code></pre><p>You can check <a href="https://spdx.org/licenses/">the full list of SPDX license IDs</a>. +<pre><code>{ "license" : "BSD-3-Clause" }</code></pre><p>You can check <a href="https://spdx.org/licenses/">the full list of SPDX license IDs</a>. Ideally you should pick one that is <a href="https://opensource.org/licenses/alphabetical">OSI</a> approved.</p> <p>If your package is licensed under multiple common licenses, use an <a href="https://npmjs.com/package/spdx">SPDX license expression syntax version 2.0 string</a>, like this:</p> -<pre><code>{ "license" : "(ISC OR GPL-3.0)" } -</code></pre><p>If you are using a license that hasn't been assigned an SPDX identifier, or if +<pre><code>{ "license" : "(ISC OR GPL-3.0)" }</code></pre><p>If you are using a license that hasn't been assigned an SPDX identifier, or if you are using a custom license, use a string value like this one:</p> -<pre><code>{ "license" : "SEE LICENSE IN <filename>" } -</code></pre><p>Then include a file named <code><filename></code> at the top level of the package.</p> +<pre><code>{ "license" : "SEE LICENSE IN <filename>" }</code></pre><p>Then include a file named <code><filename></code> at the top level of the package.</p> <p>Some old packages used license objects or a "licenses" property containing an array of license objects:</p> <pre><code>// Not valid metadata @@ -110,25 +105,20 @@ array of license objects:</p> , "url": "https://opensource.org/licenses/apache2.0.php" } ] -} -</code></pre><p>Those styles are now deprecated. Instead, use SPDX expressions, like this:</p> +}</code></pre><p>Those styles are now deprecated. Instead, use SPDX expressions, like this:</p> <pre><code>{ "license": "ISC" } -{ "license": "(MIT OR Apache-2.0)" } -</code></pre><p>Finally, if you do not wish to grant others the right to use a private or +{ "license": "(MIT OR Apache-2.0)" }</code></pre><p>Finally, if you do not wish to grant others the right to use a private or unpublished package under any terms:</p> -<pre><code>{ "license": "UNLICENSED" } -</code></pre><p>Consider also setting <code>"private": true</code> to prevent accidental publication.</p> +<pre><code>{ "license": "UNLICENSED" }</code></pre><p>Consider also setting <code>"private": true</code> to prevent accidental publication.</p> <h2 id="people-fields-author-contributors">people fields: author, contributors</h2> <p>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:</p> <pre><code>{ "name" : "Barney Rubble" , "email" : "b@rubble.com" , "url" : "http://barnyrubble.tumblr.com/" -} -</code></pre><p>Or you can shorten that all into a single string, and npm will parse it for you:</p> -<pre><code>"Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)" -</code></pre><p>Both email and url are optional either way.</p> +}</code></pre><p>Or you can shorten that all into a single string, and npm will parse it for you:</p> +<pre><code>"Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)"</code></pre><p>Both email and url are optional either way.</p> <p>npm also sets a top-level "maintainers" field with your npm user info.</p> <h2 id="files">files</h2> <p>The optional <code>files</code> field is an array of file patterns that describes @@ -195,19 +185,16 @@ command name to local file name. On install, npm will symlink that file into <code>prefix/bin</code> for global installs, or <code>./node_modules/.bin/</code> for local installs.</p> <p>For example, myapp could have this:</p> -<pre><code>{ "bin" : { "myapp" : "./cli.js" } } -</code></pre><p>So, when you install myapp, it'll create a symlink from the <code>cli.js</code> script to +<pre><code>{ "bin" : { "myapp" : "./cli.js" } }</code></pre><p>So, when you install myapp, it'll create a symlink from the <code>cli.js</code> script to <code>/usr/local/bin/myapp</code>.</p> <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:</p> <pre><code>{ "name": "my-program" , "version": "1.2.5" -, "bin": "./path/to/program" } -</code></pre><p>would be the same as this:</p> +, "bin": "./path/to/program" }</code></pre><p>would be the same as this:</p> <pre><code>{ "name": "my-program" , "version": "1.2.5" -, "bin" : { "my-program" : "./path/to/program" } } -</code></pre><p>Please make sure that your file(s) referenced in <code>bin</code> starts with +, "bin" : { "my-program" : "./path/to/program" } }</code></pre><p>Please make sure that your file(s) referenced in <code>bin</code> starts with <code>#!/usr/bin/env node</code>, otherwise the scripts are started without the node executable!</p> <h2 id="man">man</h2> @@ -220,8 +207,7 @@ result from <code>man <pkgname></code>, regardless of its actual filename. , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : "./man/doc.1" -} -</code></pre><p>would link the <code>./man/doc.1</code> file in such that it is the target for <code>man foo</code></p> +}</code></pre><p>would link the <code>./man/doc.1</code> file in such that it is the target for <code>man foo</code></p> <p>If the filename doesn't start with the package name, then it's prefixed. So, this:</p> <pre><code>{ "name" : "foo" @@ -229,8 +215,7 @@ So, this:</p> , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : [ "./man/foo.1", "./man/bar.1" ] -} -</code></pre><p>will create files to do <code>man foo</code> and <code>man foo-bar</code>.</p> +}</code></pre><p>will create files to do <code>man foo</code> and <code>man foo-bar</code>.</p> <p>Man files must end with a number, and optionally a <code>.gz</code> suffix if they are compressed. The number dictates which man section the file is installed into.</p> <pre><code>{ "name" : "foo" @@ -238,8 +223,7 @@ compressed. The number dictates which man section the file is installed into.</ , "description" : "A packaged foo fooer for fooing foos" , "main" : "foo.js" , "man" : [ "./man/foo.1", "./man/foo.2" ] -} -</code></pre><p>will create entries for <code>man foo</code> and <code>man 2 foo</code></p> +}</code></pre><p>will create entries for <code>man foo</code> and <code>man 2 foo</code></p> <h2 id="directories">directories</h2> <p>The CommonJS <a href="http://wiki.commonjs.org/wiki/Packages/1.0">Packages</a> spec details a few ways that you can indicate the structure of your package using a <code>directories</code> @@ -274,14 +258,13 @@ command will be able to find you.</p> <p>Do it like this:</p> <pre><code>"repository" : { "type" : "git" - , "url" : "https://github.com/npm/npm.git" + , "url" : "https://github.com/npm/cli.git" } "repository" : { "type" : "svn" , "url" : "https://v8.googlecode.com/svn/trunk/" - } -</code></pre><p>The URL should be a publicly available (perhaps read-only) url that can be handed + }</code></pre><p>The URL should be a publicly available (perhaps read-only) url that can be handed directly to a VCS program without any modification. It should not be a url to an html project page that you put in your browser. It's for computers.</p> <p>For GitHub, GitHub gist, Bitbucket, or GitLab repositories you can use the same @@ -294,8 +277,7 @@ shortcut syntax you use for <code>npm install</code>:</p> "repository": "bitbucket:user/repo" -"repository": "gitlab:user/repo" -</code></pre><h2 id="scripts">scripts</h2> +"repository": "gitlab:user/repo"</code></pre><h2 id="scripts">scripts</h2> <p>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> @@ -305,8 +287,7 @@ event, and the value is the command to run at that point.</p> scripts that persist across upgrades. For instance, if a package had the following:</p> <pre><code>{ "name" : "foo" -, "config" : { "port" : "8080" } } -</code></pre><p>and then had a "start" command that then referenced the +, "config" : { "port" : "8080" } }</code></pre><p>and then had a "start" command that then referenced the <code>npm_package_config_port</code> environment variable, then the user could override that by doing <code>npm config set foo:port 8001</code>.</p> <p>See <code><a href="../misc/npm-config.html">npm-config(7)</a></code> and <code><a href="../misc/npm-scripts.html">npm-scripts(7)</a></code> for more on package @@ -353,15 +334,13 @@ tarball or git URL.</p> , "lat" : "latest" , "dyl" : "file:../dyl" } -} -</code></pre><h3 id="urls-as-dependencies">URLs as Dependencies</h3> +}</code></pre><h3 id="urls-as-dependencies">URLs as Dependencies</h3> <p>You may specify a tarball URL in place of a version range.</p> <p>This tarball will be downloaded and installed locally to your package at install time.</p> <h3 id="git-urls-as-dependencies">Git URLs as Dependencies</h3> <p>Git urls are of the form:</p> -<pre><code><protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>] -</code></pre><p><code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or +<pre><code><protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>]</code></pre><p><code><protocol></code> is one of <code>git</code>, <code>git+ssh</code>, <code>git+http</code>, <code>git+https</code>, or <code>git+file</code>.</p> <p>If <code>#<commit-ish></code> is provided, it will be used to clone exactly that commit. If the commit-ish has the format <code>#semver:<semver></code>, <code><semver></code> can @@ -370,11 +349,10 @@ or refs matching that range in the remote repository, much as it would for a registry dependency. If neither <code>#<commit-ish></code> or <code>#semver:<semver></code> is specified, then <code>master</code> is used.</p> <p>Examples:</p> -<pre><code>git+ssh://git@github.com:npm/npm.git#v1.0.27 -git+ssh://git@github.com:npm/npm#semver:^5.0 -git+https://isaacs@github.com/npm/npm.git -git://github.com/npm/npm.git#v1.0.27 -</code></pre><h3 id="github-urls">GitHub URLs</h3> +<pre><code>git+ssh://git@github.com:npm/cli.git#v1.0.27 +git+ssh://git@github.com:npm/cli#semver:^5.0 +git+https://isaacs@github.com/npm/cli.git +git://github.com/npm/cli.git#v1.0.27</code></pre><h3 id="github-urls">GitHub URLs</h3> <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 <code>commit-ish</code> suffix can be included. For example:</p> @@ -386,24 +364,21 @@ included. For example:</p> "mocha": "mochajs/mocha#4727d357ea", "module": "user/repo#feature\/branch" } -} -</code></pre><h3 id="local-paths">Local Paths</h3> +}</code></pre><h3 id="local-paths">Local Paths</h3> <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 <code>npm install -S</code> or <code>npm install --save</code>, using any of these forms:</p> <pre><code>../foo/bar ~/foo/bar ./foo/bar -/foo/bar -</code></pre><p>in which case they will be normalized to a relative path and added to your +/foo/bar</code></pre><p>in which case they will be normalized to a relative path and added to your <code>package.json</code>. For example:</p> <pre><code>{ "name": "baz", "dependencies": { "bar": "file:../foo/bar" } -} -</code></pre><p>This feature is helpful for local offline development and creating +}</code></pre><p>This feature is helpful for local offline development and creating tests that require npm installing where you don't want to hit an external server, but should not be used when publishing packages to the public registry.</p> @@ -430,8 +405,7 @@ script to do this, and make the required package a devDependency.</p> "prepare": "coffee -o lib/ -c src/waza.coffee" }, "main": "lib/waza.js" -} -</code></pre><p>The <code>prepare</code> script will be run before publishing, so that users +}</code></pre><p>The <code>prepare</code> 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 <code>npm install</code>), it'll run this script as well, so that you can test it easily.</p> @@ -447,13 +421,11 @@ a specific interface, expected and specified by the host documentation.</p> "peerDependencies": { "tea": "2.x" } -} -</code></pre><p>This ensures your package <code>tea-latte</code> can be installed <em>along</em> with the second +}</code></pre><p>This ensures your package <code>tea-latte</code> can be installed <em>along</em> with the second major version of the host package <code>tea</code> only. <code>npm install tea-latte</code> could possibly yield the following dependency graph:</p> <pre><code>├── tea-latte@1.3.5 -└── tea@2.2.0 -</code></pre><p><strong>NOTE: npm versions 1 and 2 will automatically install <code>peerDependencies</code> if +└── tea@2.2.0</code></pre><p><strong>NOTE: npm versions 1 and 2 will automatically install <code>peerDependencies</code> 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.</strong> The @@ -481,8 +453,7 @@ array and executing <code>npm pack</code>.</p> "bundledDependencies": [ "renderized", "super-streams" ] -} -</code></pre><p>we can obtain <code>awesome-web-framework-1.0.0.tgz</code> file by running <code>npm pack</code>. +}</code></pre><p>we can obtain <code>awesome-web-framework-1.0.0.tgz</code> file by running <code>npm pack</code>. This file contains the dependencies <code>renderized</code> and <code>super-streams</code> which can be installed in a new project by executing <code>npm install awesome-web-framework-1.0.0.tgz</code>.</p> @@ -509,21 +480,18 @@ if ( notGoodFooVersion(fooVersion) ) { if (foo) { foo.doFooThings() -} -</code></pre><p>Entries in <code>optionalDependencies</code> will override entries of the same name in +}</code></pre><p>Entries in <code>optionalDependencies</code> will override entries of the same name in <code>dependencies</code>, so it's usually best to only put in one place.</p> <h2 id="engines">engines</h2> <p>You can specify the version of node that your stuff works on:</p> -<pre><code>{ "engines" : { "node" : ">=0.10.3 <0.12" } } -</code></pre><p>And, like with dependencies, if you don't specify the version (or if you +<pre><code>{ "engines" : { "node" : ">=0.10.3 <0.12" } }</code></pre><p>And, like with dependencies, if you don't specify the version (or if you specify "*" as the version), then any version of node will do.</p> <p>If you specify an "engines" field, then npm will require that "node" be somewhere on that list. If "engines" is omitted, then npm will just assume that it works on node.</p> <p>You can also use the "engines" field to specify which versions of npm are capable of properly installing your program. For example:</p> -<pre><code>{ "engines" : { "npm" : "~1.0.20" } } -</code></pre><p>Unless the user has set the <code>engine-strict</code> config flag, this +<pre><code>{ "engines" : { "npm" : "~1.0.20" } }</code></pre><p>Unless the user has set the <code>engine-strict</code> config flag, this field is advisory only and will only produce warnings when your package is installed as a dependency.</p> <h2 id="enginestrict">engineStrict</h2> <p><strong>This feature was removed in npm 3.0.0</strong></p> @@ -532,20 +500,16 @@ user had set <code>engine-strict</code>. It is no longer used.</p> <h2 id="os">os</h2> <p>You can specify which operating systems your module will run on:</p> -<pre><code>"os" : [ "darwin", "linux" ] -</code></pre><p>You can also blacklist instead of whitelist operating systems, +<pre><code>"os" : [ "darwin", "linux" ]</code></pre><p>You can also blacklist instead of whitelist operating systems, just prepend the blacklisted os with a '!':</p> -<pre><code>"os" : [ "!win32" ] -</code></pre><p>The host operating system is determined by <code>process.platform</code></p> +<pre><code>"os" : [ "!win32" ]</code></pre><p>The host operating system is determined by <code>process.platform</code></p> <p>It is allowed to both blacklist, and whitelist, although there isn't any good reason to do this.</p> <h2 id="cpu">cpu</h2> <p>If your code only runs on certain cpu architectures, you can specify which ones.</p> -<pre><code>"cpu" : [ "x64", "ia32" ] -</code></pre><p>Like the <code>os</code> option, you can also blacklist architectures:</p> -<pre><code>"cpu" : [ "!arm", "!mips" ] -</code></pre><p>The host architecture is determined by <code>process.arch</code></p> +<pre><code>"cpu" : [ "x64", "ia32" ]</code></pre><p>Like the <code>os</code> option, you can also blacklist architectures:</p> +<pre><code>"cpu" : [ "!arm", "!mips" ]</code></pre><p>The host architecture is determined by <code>process.arch</code></p> <h2 id="preferglobal">preferGlobal</h2> <p><strong>DEPRECATED</strong></p> <p>This option used to trigger an npm warning, but it will no longer warn. It is @@ -610,5 +574,5 @@ ignored.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">package.json — npm@6.1.0</p> +<p id="footer">package.json — npm@6.2.0</p> diff --git a/deps/npm/html/doc/index.html b/deps/npm/html/doc/index.html index 7a0db0c538..638ec9a08d 100644 --- a/deps/npm/html/doc/index.html +++ b/deps/npm/html/doc/index.html @@ -180,5 +180,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-index — npm@6.1.0</p> +<p id="footer">npm-index — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-coding-style.html b/deps/npm/html/doc/misc/npm-coding-style.html index 204556e25a..e8133c1794 100644 --- a/deps/npm/html/doc/misc/npm-coding-style.html +++ b/deps/npm/html/doc/misc/npm-coding-style.html @@ -29,21 +29,17 @@ statements onto multiple lines.</p> <p>Curly braces belong on the same line as the thing that necessitates them.</p> <p>Bad:</p> <pre><code>function () -{ -</code></pre><p>Good:</p> -<pre><code>function () { -</code></pre><p>If a block needs to wrap to the next line, use a curly brace. Don't +{</code></pre><p>Good:</p> +<pre><code>function () {</code></pre><p>If a block needs to wrap to the next line, use a curly brace. Don't use it if it doesn't.</p> <p>Bad:</p> <pre><code>if (foo) { bar() } while (foo) - bar() -</code></pre><p>Good:</p> + bar()</code></pre><p>Good:</p> <pre><code>if (foo) bar() while (foo) { bar() -} -</code></pre><h2 id="semicolons">Semicolons</h2> +}</code></pre><h2 id="semicolons">Semicolons</h2> <p>Don't use them except in four situations:</p> <ul> <li><code>for (;;)</code> loops. They're actually required.</li> @@ -64,8 +60,7 @@ for (var i = 0; i < 10; i ++) { default: throw new Error('unknown state') } end() -} -</code></pre><p>Note that starting lines with <code>-</code> and <code>+</code> also should be prefixed +}</code></pre><p>Note that starting lines with <code>-</code> and <code>+</code> also should be prefixed with a semicolon, but this is much less common.</p> <h2 id="comma-first">Comma First</h2> <p>If there is a list of things separated by commas, and it wraps @@ -82,15 +77,12 @@ final token in the list on a line by itself. For example:</p> , a = 1 , b = 'abc' , etc - , somethingElse -</code></pre><h2 id="quotes">Quotes</h2> + , somethingElse</code></pre><h2 id="quotes">Quotes</h2> <p>Use single quotes for strings except to avoid escaping.</p> <p>Bad:</p> -<pre><code>var notOk = "Just double quotes" -</code></pre><p>Good:</p> +<pre><code>var notOk = "Just double quotes"</code></pre><p>Good:</p> <pre><code>var ok = 'String contains "double" quotes' -var alsoOk = "String contains 'single' quotes or apostrophe" -</code></pre><h2 id="whitespace">Whitespace</h2> +var alsoOk = "String contains 'single' quotes or apostrophe"</code></pre><h2 id="whitespace">Whitespace</h2> <p>Put a single space in front of <code>(</code> for anything other than a function call. Also use a single space wherever it makes things more readable.</p> <p>Don't leave trailing whitespace at the end of lines. Don't indent empty @@ -153,5 +145,5 @@ set to anything."</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-coding-style — npm@6.1.0</p> +<p id="footer">npm-coding-style — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-config.html b/deps/npm/html/doc/misc/npm-config.html index 0abd19a970..fcfbb71f3c 100644 --- a/deps/npm/html/doc/misc/npm-config.html +++ b/deps/npm/html/doc/misc/npm-config.html @@ -82,27 +82,22 @@ configuration parameter, then it is expanded to that configuration parameter. For example:</p> <pre><code>npm ls --par # same as: -npm ls --parseable -</code></pre><p>If multiple single-character shorthands are strung together, and the +npm ls --parseable</code></pre><p>If multiple single-character shorthands are strung together, and the resulting combination is unambiguously not some other configuration param, then it is expanded to its various component pieces. For example:</p> <pre><code>npm ls -gpld # same as: -npm ls --global --parseable --long --loglevel info -</code></pre><h2 id="per-package-config-settings">Per-Package Config Settings</h2> +npm ls --global --parseable --long --loglevel info</code></pre><h2 id="per-package-config-settings">Per-Package Config Settings</h2> <p>When running scripts (see <code><a href="../misc/npm-scripts.html">npm-scripts(7)</a></code>) the package.json "config" keys are overwritten in the environment if there is a config param of <code><name>[@<version>]:<key></code>. For example, if the package.json has this:</p> <pre><code>{ "name" : "foo" , "config" : { "port" : "8080" } -, "scripts" : { "start" : "node server.js" } } -</code></pre><p>and the server.js is this:</p> -<pre><code>http.createServer(...).listen(process.env.npm_package_config_port) -</code></pre><p>then the user could change the behavior by doing:</p> -<pre><code>npm config set foo:port 80 -</code></pre><p>See <a href="../files/package.json.html">package.json(5)</a> for more information.</p> +, "scripts" : { "start" : "node server.js" } }</code></pre><p>and the server.js is this:</p> +<pre><code>http.createServer(...).listen(process.env.npm_package_config_port)</code></pre><p>then the user could change the behavior by doing:</p> +<pre><code>npm config set foo:port 80</code></pre><p>See <a href="../files/package.json.html">package.json(5)</a> for more information.</p> <h2 id="config-settings">Config Settings</h2> <h3 id="access">access</h3> <ul> @@ -172,13 +167,11 @@ ostensibly Unix systems.</p> <p>The Certificate Authority signing certificate that is trusted for SSL connections to the registry. Values should be in PEM format (Windows calls it "Base-64 encoded X.509 (.CER)") with newlines replaced by the string "\n". For example:</p> -<pre><code>ca="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----" -</code></pre><p>Set to <code>null</code> to only allow "known" registrars, or to a specific CA cert +<pre><code>ca="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"</code></pre><p>Set to <code>null</code> to only allow "known" registrars, or to a specific CA cert to trust only that specific signing authority.</p> <p>Multiple CAs can be trusted by specifying an array of certificates:</p> <pre><code>ca[]="..." -ca[]="..." -</code></pre><p>See also the <code>strict-ssl</code> config.</p> +ca[]="..."</code></pre><p>See also the <code>strict-ssl</code> config.</p> <h3 id="cafile">cafile</h3> <ul> <li>Default: <code>null</code></li> @@ -232,8 +225,7 @@ well as for the CA information to be stored in a file on disk.</p> </ul> <p>A client certificate to pass when accessing the registry. Values should be in PEM format (Windows calls it "Base-64 encoded X.509 (.CER)") with newlines replaced by the string "\n". For example:</p> -<pre><code>cert="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----" -</code></pre><p>It is <em>not</em> the path to a certificate file (and there is no "certfile" option).</p> +<pre><code>cert="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"</code></pre><p>It is <em>not</em> the path to a certificate file (and there is no "certfile" option).</p> <h3 id="cidr">cidr</h3> <ul> <li>Default: <code>null</code></li> @@ -487,8 +479,7 @@ output from <code>npm ls --json</code> and <code>npm search --json</code> are cu </ul> <p>A client key to pass when accessing the registry. Values should be in PEM format with newlines replaced by the string "\n". For example:</p> -<pre><code>key="-----BEGIN PRIVATE KEY-----\nXXXX\nXXXX\n-----END PRIVATE KEY-----" -</code></pre><p>It is <em>not</em> the path to a key file (and there is no "keyfile" option).</p> +<pre><code>key="-----BEGIN PRIVATE KEY-----\nXXXX\nXXXX\n-----END PRIVATE KEY-----"</code></pre><p>It is <em>not</em> the path to a key file (and there is no "keyfile" option).</p> <h3 id="legacy-bundling">legacy-bundling</h3> <ul> <li>Default: false</li> @@ -884,6 +875,15 @@ Windows</li> <p>If set to false, then ignore <code>npm-shrinkwrap.json</code> files when installing. This will also prevent <em>writing</em> <code>npm-shrinkwrap.json</code> if <code>save</code> is true.</p> <p>This option is an alias for <code>--package-lock</code>.</p> +<h3 id="sign-git-commit">sign-git-commit</h3> +<ul> +<li>Default: false</li> +<li>Type: Boolean</li> +</ul> +<p>If set to true, then the <code>npm version</code> command will commit the new package +version using <code>-S</code> to add a signature.</p> +<p>Note that git requires you to have set up GPG keys in your git configs +for this to work properly.</p> <h3 id="sign-git-tag">sign-git-tag</h3> <ul> <li>Default: false</li> @@ -966,6 +966,13 @@ false, it uses ascii characters to draw trees.</p> <p>Set to true to suppress the UID/GID switching when running package scripts. If set explicitly to false, then installing as a non-root user will fail.</p> +<h3 id="update-notifier">update-notifier</h3> +<ul> +<li>Default: true</li> +<li>Type: Boolean</li> +</ul> +<p>Set to false to suppress the update notification when using an older +version of npm than the latest.</p> <h3 id="usage">usage</h3> <ul> <li>Default: false</li> @@ -1043,5 +1050,5 @@ exit successfully.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-config — npm@6.1.0</p> +<p id="footer">npm-config — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-developers.html b/deps/npm/html/doc/misc/npm-developers.html index 526bcc6d34..961bf22c41 100644 --- a/deps/npm/html/doc/misc/npm-developers.html +++ b/deps/npm/html/doc/misc/npm-developers.html @@ -39,8 +39,7 @@ after packing it up into a tarball (b).</p> <pre><code>git://github.com/user/project.git#commit-ish git+ssh://user@hostname:project.git#commit-ish git+http://user@hostname/project/blah.git#commit-ish -git+https://user@hostname/project/blah.git#commit-ish -</code></pre><p>The <code>commit-ish</code> can be any tag, sha, or branch which can be supplied as +git+https://user@hostname/project/blah.git#commit-ish</code></pre><p>The <code>commit-ish</code> can be any tag, sha, or branch which can be supplied as an argument to <code>git checkout</code>. The default is <code>master</code>.</p> <h2 id="the-package-json-file">The package.json File</h2> <p>You need to have a <code>package.json</code> file in the root of your project to do @@ -154,26 +153,21 @@ problems trying to publish it. Or, worse yet, you'll be able to publish it, but you'll be publishing a broken or pointless package. So don't do that.</p> <p>In the root of your package, do this:</p> -<pre><code>npm install . -g -</code></pre><p>That'll show you that it's working. If you'd rather just create a symlink +<pre><code>npm install . -g</code></pre><p>That'll show you that it's working. If you'd rather just create a symlink package that points to your working directory, then do this:</p> -<pre><code>npm link -</code></pre><p>Use <code>npm ls -g</code> to see if it's there.</p> +<pre><code>npm link</code></pre><p>Use <code>npm ls -g</code> to see if it's there.</p> <p>To test a local install, go into some other folder, and then do:</p> <pre><code>cd ../some-other-folder -npm install ../my-package -</code></pre><p>to install it locally into the node_modules folder in that other place.</p> +npm install ../my-package</code></pre><p>to install it locally into the node_modules folder in that other place.</p> <p>Then go into the node-repl, and try using require("my-thing") to bring in your module's main module.</p> <h2 id="create-a-user-account">Create a User Account</h2> <p>Create a user with the adduser command. It works like this:</p> -<pre><code>npm adduser -</code></pre><p>and then follow the prompts.</p> +<pre><code>npm adduser</code></pre><p>and then follow the prompts.</p> <p>This is documented better in <a href="../cli/npm-adduser.html">npm-adduser(1)</a>.</p> <h2 id="publish-your-package">Publish your package</h2> <p>This part's easy. In the root of your folder, do this:</p> -<pre><code>npm publish -</code></pre><p>You can give publish a url to a tarball, or a filename of a tarball, +<pre><code>npm publish</code></pre><p>You can give publish a url to a tarball, or a filename of a tarball, or a path to a folder.</p> <p>Note that pretty much <strong>everything in that folder will be exposed</strong> by default. So, if you have secret stuff in there, use a @@ -204,5 +198,5 @@ from a fresh checkout.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-developers — npm@6.1.0</p> +<p id="footer">npm-developers — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-disputes.html b/deps/npm/html/doc/misc/npm-disputes.html index 543a601979..dccfe0394b 100644 --- a/deps/npm/html/doc/misc/npm-disputes.html +++ b/deps/npm/html/doc/misc/npm-disputes.html @@ -20,7 +20,7 @@ Conduct.</p> <h2 id="tl-dr">TL;DR</h2> <ol> <li>Get the author email with <code>npm owner ls <pkgname></code></li> -<li>Email the author, CC <a href="mailto:support@npmjs.com">support@npmjs.com</a></li> +<li>Email the author, CC <a href="mailto:support@npmjs.com">support@npmjs.com</a></li> <li>After a few weeks, if there's no resolution, we'll sort it out.</li> </ol> <p>Don't squat on package names. Publish code or move out of the way.</p> @@ -44,7 +44,7 @@ publishes it to the npm registry. Being a simple little thing, it never really has to be updated. Alice works for Foo Inc, the makers of the critically acclaimed and widely-marketed <code>foo</code> JavaScript toolkit framework. They publish it to npm as <code>foojs</code>, but people are routinely confused when -<code>npm install</code>foo<code></code> is some different thing.</li> +<code>npm install foo</code> is some different thing.</li> <li><p>Yusuf writes a parser for the widely-known <code>foo</code> file format, because he needs it for work. Then, he gets a new job, and never updates the prototype. Later on, Alice writes a much more complete <code>foo</code> parser, but can't publish, @@ -55,12 +55,12 @@ because Yusuf's <code>foo</code> is in the way.</p> </li> <li>Alice emails Yusuf, explaining the situation <strong>as respectfully as possible</strong>, and what she would like to do with the module name. She adds the npm support -staff <a href="mailto:support@npmjs.com">support@npmjs.com</a> to the CC list of the email. Mention in the email +staff <a href="mailto:support@npmjs.com">support@npmjs.com</a> to the CC list of the email. Mention in the email that Yusuf can run npm owner <code>add alice foo</code> to add Alice as an owner of the foo package.</li> <li>After a reasonable amount of time, if Yusuf has not responded, or if Yusuf and Alice can't come to any sort of resolution, email support -<a href="mailto:support@npmjs.com">support@npmjs.com</a> and we'll sort it out. ("Reasonable" is usually at least +<a href="mailto:support@npmjs.com">support@npmjs.com</a> and we'll sort it out. ("Reasonable" is usually at least 4 weeks.)</li> </ol> <h2 id="reasoning">REASONING</h2> @@ -96,12 +96,12 @@ application database or otherwise putting non-packagey things into it.</li> <a href="https://www.npmjs.com/policies/conduct">Code of Conduct</a> such as hateful language, pornographic content, or harassment.</li> </ol> -<p>If you see bad behavior like this, please report it to <a href="mailto:abuse@npmjs.com">abuse@npmjs.com</a> right +<p>If you see bad behavior like this, please report it to <a href="mailto:abuse@npmjs.com">abuse@npmjs.com</a> right away. <strong>You are never expected to resolve abusive behavior on your own. We are here to help.</strong></p> <h2 id="trademarks">TRADEMARKS</h2> <p>If you think another npm publisher is infringing your trademark, such as by -using a confusingly similar package name, email <a href="mailto:abuse@npmjs.com">abuse@npmjs.com</a> with a link to +using a confusingly similar package name, email <a href="mailto:abuse@npmjs.com">abuse@npmjs.com</a> with a link to the package or user account on <a href="https://npmjs.com">https://npmjs.com</a>. Attach a copy of your trademark registration certificate.</p> <p>If we see that the package's publisher is intentionally misleading others by @@ -111,7 +111,7 @@ clear up any confusion with changes to their package's <code><a href="../../ metadata.</p> <h2 id="changes">CHANGES</h2> <p>This is a living document and may be updated from time to time. Please refer to -the <a href="https://github.com/npm/npm/commits/master/doc/misc/npm-disputes.md">git history for this document</a> +the <a href="https://github.com/npm/cli/commits/latest/doc/misc/npm-disputes.md">git history for this document</a> to view the changes.</p> <h2 id="license">LICENSE</h2> <p>Copyright (C) npm, Inc., All rights reserved</p> @@ -134,5 +134,5 @@ License.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-disputes — npm@6.1.0</p> +<p id="footer">npm-disputes — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-index.html b/deps/npm/html/doc/misc/npm-index.html index d3c382a203..7c67f1b99a 100644 --- a/deps/npm/html/doc/misc/npm-index.html +++ b/deps/npm/html/doc/misc/npm-index.html @@ -180,5 +180,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-index — npm@6.1.0</p> +<p id="footer">npm-index — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-orgs.html b/deps/npm/html/doc/misc/npm-orgs.html index 3ed6709f33..e2ed0d240c 100644 --- a/deps/npm/html/doc/misc/npm-orgs.html +++ b/deps/npm/html/doc/misc/npm-orgs.html @@ -29,46 +29,37 @@ <ul> <li>Check who you’ve added to your org:</li> </ul> -<pre><code>npm team ls <org>:developers -</code></pre><ul> +<pre><code>npm team ls <org>:developers</code></pre><ul> <li><p>Each org is automatically given a <code>developers</code> team, so you can see the whole list of team members in your org. This team automatically gets read-write access to all packages, but you can change that with the <code>access</code> command.</p> </li> <li><p>Create a new team:</p> </li> </ul> -<pre><code>npm team create <org:team> -</code></pre><ul> +<pre><code>npm team create <org:team></code></pre><ul> <li>Add members to that team:</li> </ul> -<pre><code>npm team add <org:team> <user> -</code></pre><h2 id="publish-a-package-and-adjust-package-access">Publish a package and adjust package access</h2> +<pre><code>npm team add <org:team> <user></code></pre><h2 id="publish-a-package-and-adjust-package-access">Publish a package and adjust package access</h2> <ul> <li>In package directory, run</li> </ul> -<pre><code>npm init --scope=<org> -</code></pre><p>to scope it for your org & publish as usual</p> +<pre><code>npm init --scope=<org></code></pre><p>to scope it for your org & publish as usual</p> <ul> <li>Grant access: </li> </ul> -<pre><code>npm access grant <read-only|read-write> <org:team> [<package>] -</code></pre><ul> +<pre><code>npm access grant <read-only|read-write> <org:team> [<package>]</code></pre><ul> <li>Revoke access:</li> </ul> -<pre><code>npm access revoke <org:team> [<package>] -</code></pre><h2 id="monitor-your-package-access">Monitor your package access</h2> +<pre><code>npm access revoke <org:team> [<package>]</code></pre><h2 id="monitor-your-package-access">Monitor your package access</h2> <ul> <li>See what org packages a team member can access:</li> </ul> -<pre><code>npm access ls-packages <org> <user> -</code></pre><ul> +<pre><code>npm access ls-packages <org> <user></code></pre><ul> <li>See packages available to a specific team:</li> </ul> -<pre><code>npm access ls-packages <org:team> -</code></pre><ul> +<pre><code>npm access ls-packages <org:team></code></pre><ul> <li>Check which teams are collaborating on a package:</li> </ul> -<pre><code>npm access ls-collaborators <pkg> -</code></pre><h2 id="see-also">SEE ALSO</h2> +<pre><code>npm access ls-collaborators <pkg></code></pre><h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../cli/npm-team.html">npm-team(1)</a></li> <li><a href="../cli/npm-access.html">npm-access(1)</a></li> @@ -86,5 +77,5 @@ <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-orgs — npm@6.1.0</p> +<p id="footer">npm-orgs — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-registry.html b/deps/npm/html/doc/misc/npm-registry.html index f3f9704a87..1a5626646d 100644 --- a/deps/npm/html/doc/misc/npm-registry.html +++ b/deps/npm/html/doc/misc/npm-registry.html @@ -43,8 +43,8 @@ interesting. This is used to gather better metrics on how npm is used by humans, versus build farms.</li> </ul> -<p>The npm registry does not to correlate the information in these headers with -any authenticated accounts that may be used in the same requests.</p> +<p>The npm registry does not try to correlate the information in these headers +with any authenticated accounts that may be used in the same requests.</p> <h2 id="can-i-run-my-own-private-registry-">Can I run my own private registry?</h2> <p>Yes!</p> <p>The easiest way is to replicate the couch database, and use the same (or @@ -90,5 +90,5 @@ effectively implement the entire CouchDB API anyway.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-registry — npm@6.1.0</p> +<p id="footer">npm-registry — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-scope.html b/deps/npm/html/doc/misc/npm-scope.html index 7c285406b2..fe4a1abc25 100644 --- a/deps/npm/html/doc/misc/npm-scope.html +++ b/deps/npm/html/doc/misc/npm-scope.html @@ -15,8 +15,7 @@ follows the usual rules for package names (URL-safe characters, no leading dots or underscores). When used in package names, scopes are preceded by an <code>@</code> symbol and followed by a slash, e.g.</p> -<pre><code>@somescope/somepackagename -</code></pre><p>Scopes are a way of grouping related packages together, and also affect a few +<pre><code>@somescope/somepackagename</code></pre><p>Scopes are a way of grouping related packages together, and also affect a few things about the way npm treats the package.</p> <p>Each npm user/organization has their own scope, and only you can add packages in your scope. This means you don't have to worry about someone taking your @@ -34,18 +33,15 @@ folder (<code>@myorg</code>) is simply the name of the scope preceded by an <cod contain any number of scoped packages.</p> <p>A scoped package is installed by referencing it by name, preceded by an <code>@</code> symbol, in <code>npm install</code>:</p> -<pre><code>npm install @myorg/mypackage -</code></pre><p>Or in <code>package.json</code>:</p> +<pre><code>npm install @myorg/mypackage</code></pre><p>Or in <code>package.json</code>:</p> <pre><code>"dependencies": { "@myorg/mypackage": "^1.3.0" -} -</code></pre><p>Note that if the <code>@</code> symbol is omitted, in either case, npm will instead attempt to +}</code></pre><p>Note that if the <code>@</code> symbol is omitted, in either case, npm will instead attempt to install from GitHub; see <code><a href="../cli/npm-install.html">npm-install(1)</a></code>.</p> <h2 id="requiring-scoped-packages">Requiring scoped packages</h2> <p>Because scoped packages are installed into a scope folder, you have to include the name of the scope when requiring them in your code, e.g.</p> -<pre><code>require('@myorg/mypackage') -</code></pre><p>There is nothing special about the way Node treats scope folders. This +<pre><code>require('@myorg/mypackage')</code></pre><p>There is nothing special about the way Node treats scope folders. This simply requires the <code>mypackage</code> module in the folder named <code>@myorg</code>.</p> <h2 id="publishing-scoped-packages">Publishing scoped packages</h2> <p>Scoped packages can be published from the CLI as of <code>npm@2</code> and can be @@ -71,12 +67,10 @@ desired, with <code>npm access</code> or on the npmjs.com website.</p> seamlessly use a mix of packages from the primary npm registry and one or more private registries, such as npm Enterprise.</p> <p>You can associate a scope with a registry at login, e.g.</p> -<pre><code>npm login --registry=http://reg.example.com --scope=@myco -</code></pre><p>Scopes have a many-to-one relationship with registries: one registry can +<pre><code>npm login --registry=http://reg.example.com --scope=@myco</code></pre><p>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> <p>You can also associate a scope with a registry using <code>npm config</code>:</p> -<pre><code>npm config set @myco:registry http://reg.example.com -</code></pre><p>Once a scope is associated with a registry, any <code>npm install</code> for a package +<pre><code>npm config set @myco:registry http://reg.example.com</code></pre><p>Once a scope is associated with a registry, any <code>npm install</code> for a package with that scope will request packages from that registry instead. Any <code>npm publish</code> for a package name that contains the scope will be published to that registry instead.</p> @@ -99,5 +93,5 @@ that registry instead.</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-scope — npm@6.1.0</p> +<p id="footer">npm-scope — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/npm-scripts.html b/deps/npm/html/doc/misc/npm-scripts.html index 43b0ca63e0..d76bba3b61 100644 --- a/deps/npm/html/doc/misc/npm-scripts.html +++ b/deps/npm/html/doc/misc/npm-scripts.html @@ -60,11 +60,11 @@ Run by the <code>npm shrinkwrap</code> command.</li> <p>Additionally, arbitrary scripts can be executed by running <code>npm run-script <stage></code>. <em>Pre</em> and <em>post</em> commands with matching names will be run for those as well (e.g. <code>premyscript</code>, <code>myscript</code>, -<code>postmyscript</code>). Scripts from dependencies can be run with `npm explore</p> -<p><pkg> -- npm run <stage>`.</p> +<code>postmyscript</code>). Scripts from dependencies can be run with <code>npm explore +<pkg> -- npm run <stage></code>.</p> <h2 id="prepublish-and-prepare">PREPUBLISH AND PREPARE</h2> <h3 id="deprecation-note">DEPRECATION NOTE</h3> -<p>Since <a href="mailto:`npm@1.1.71">`npm@1.1.71</a><code>, the npm CLI has run the</code>prepublish<code>script for both</code>npm +<p>Since <a href="mailto:%60npm@1.1.71">`npm@1.1.71</a><code>, the npm CLI has run the</code>prepublish<code>script for both</code>npm publish<code>and</code>npm install<code>, because it's a convenient way to prepare a package for use (some common use cases are described in the section below). It has also turned out to be, in practice, [very @@ -125,8 +125,7 @@ suites, then those executables will be added to the <code>PATH</code> for executing the scripts. So, if your package.json has this:</p> <pre><code>{ "name" : "foo" , "dependencies" : { "bar" : "0.1.x" } -, "scripts": { "start" : "bar ./test" } } -</code></pre><p>then you could run <code>npm start</code> to execute the <code>bar</code> script, which is +, "scripts": { "start" : "bar ./test" } }</code></pre><p>then you could run <code>npm start</code> to execute the <code>bar</code> script, which is exported into the <code>node_modules/.bin</code> directory on <code>npm install</code>.</p> <h3 id="package-json-vars">package.json vars</h3> <p>The package.json fields are tacked onto the <code>npm_package_</code> prefix. So, @@ -144,12 +143,9 @@ there is a config param of <code><name>[@<version>]:<key></cod if the package.json has this:</p> <pre><code>{ "name" : "foo" , "config" : { "port" : "8080" } -, "scripts" : { "start" : "node server.js" } } -</code></pre><p>and the server.js is this:</p> -<pre><code>http.createServer(...).listen(process.env.npm_package_config_port) -</code></pre><p>then the user could change the behavior by doing:</p> -<pre><code>npm config set foo:port 80 -</code></pre><h3 id="current-lifecycle-event">current lifecycle event</h3> +, "scripts" : { "start" : "node server.js" } }</code></pre><p>and the server.js is this:</p> +<pre><code>http.createServer(...).listen(process.env.npm_package_config_port)</code></pre><p>then the user could change the behavior by doing:</p> +<pre><code>npm config set foo:port 80</code></pre><h3 id="current-lifecycle-event">current lifecycle event</h3> <p>Lastly, the <code>npm_lifecycle_event</code> environment variable is set to whichever stage of the cycle is being executed. So, you could have a single script used for different parts of the process which switches @@ -157,16 +153,14 @@ based on what's currently happening.</p> <p>Objects are flattened following this format, so if you had <code>{"scripts":{"install":"foo.js"}}</code> in your package.json, then you'd see this in the script:</p> -<pre><code>process.env.npm_package_scripts_install === "foo.js" -</code></pre><h2 id="examples">EXAMPLES</h2> +<pre><code>process.env.npm_package_scripts_install === "foo.js"</code></pre><h2 id="examples">EXAMPLES</h2> <p>For example, if your package.json contains this:</p> <pre><code>{ "scripts" : { "install" : "scripts/install.js" , "postinstall" : "scripts/install.js" , "uninstall" : "scripts/uninstall.js" } -} -</code></pre><p>then <code>scripts/install.js</code> will be called for the install +}</code></pre><p>then <code>scripts/install.js</code> will be called for the install and post-install stages of the lifecycle, and <code>scripts/uninstall.js</code> will be called when the package is uninstalled. Since <code>scripts/install.js</code> is running for two different phases, it would @@ -179,8 +173,7 @@ fine:</p> , "install" : "make && make install" , "test" : "make test" } -} -</code></pre><h2 id="exiting">EXITING</h2> +}</code></pre><h2 id="exiting">EXITING</h2> <p>Scripts are run by passing the line as a script argument to <code>sh</code>.</p> <p>If the script exits with a code other than 0, then this will abort the process.</p> @@ -239,5 +232,5 @@ scripts is for compilation which must be done on the target architecture.</li> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">npm-scripts — npm@6.1.0</p> +<p id="footer">npm-scripts — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/removing-npm.html b/deps/npm/html/doc/misc/removing-npm.html index 15077119ab..3abcf7adb1 100644 --- a/deps/npm/html/doc/misc/removing-npm.html +++ b/deps/npm/html/doc/misc/removing-npm.html @@ -12,10 +12,8 @@ <h1><a href="../cli/npm-removal.html">npm-removal</a></h1> <p>Cleaning the Slate</p> <h2 id="synopsis">SYNOPSIS</h2> <p>So sad to see you go.</p> -<pre><code>sudo npm uninstall npm -g -</code></pre><p>Or, if that fails, get the npm source code, and do:</p> -<pre><code>sudo make uninstall -</code></pre><h2 id="more-severe-uninstalling">More Severe Uninstalling</h2> +<pre><code>sudo npm uninstall npm -g</code></pre><p>Or, if that fails, get the npm source code, and do:</p> +<pre><code>sudo make uninstall</code></pre><h2 id="more-severe-uninstalling">More Severe Uninstalling</h2> <p>Usually, the above instructions are sufficient. That will remove npm, but leave behind anything you've installed.</p> <p>If that doesn't work, or if you require more drastic measures, @@ -29,16 +27,13 @@ you configured node with a different <code>--prefix</code>, or installed npm wit different prefix setting, then adjust the paths accordingly, replacing <code>/usr/local</code> with your install prefix.</p> <p>To remove everything npm-related manually:</p> -<pre><code>rm -rf /usr/local/{lib/node{,/.npm,_modules},bin,share/man}/npm* -</code></pre><p>If you installed things <em>with</em> npm, then your best bet is to uninstall +<pre><code>rm -rf /usr/local/{lib/node{,/.npm,_modules},bin,share/man}/npm*</code></pre><p>If you installed things <em>with</em> npm, then your best bet is to uninstall them with npm first, and then install them again once you have a proper install. This can help find any symlinks that are lying around:</p> -<pre><code>ls -laF /usr/local/{lib/node{,/.npm},bin,share/man} | grep npm -</code></pre><p>Prior to version 0.3, npm used shim files for executables and node +<pre><code>ls -laF /usr/local/{lib/node{,/.npm},bin,share/man} | grep npm</code></pre><p>Prior to version 0.3, npm used shim files for executables and node modules. To track those down, you can do the following:</p> -<pre><code>find /usr/local/{lib/node,bin} -exec grep -l npm \{\} \; ; -</code></pre><p>(This is also in the <a href="../../doc/README.html">README</a> file.)</p> +<pre><code>find /usr/local/{lib/node,bin} -exec grep -l npm \{\} \; ;</code></pre><p>(This is also in the <a href="../../doc/README.html">README</a> file.)</p> <h2 id="see-also">SEE ALSO</h2> <ul> <li><a href="../../doc/README.html">README</a></li> @@ -57,5 +52,5 @@ modules. To track those down, you can do the following:</p> <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">removing-npm — npm@6.1.0</p> +<p id="footer">removing-npm — npm@6.2.0</p> diff --git a/deps/npm/html/doc/misc/semver.html b/deps/npm/html/doc/misc/semver.html index b3a69fbce3..028d50aade 100644 --- a/deps/npm/html/doc/misc/semver.html +++ b/deps/npm/html/doc/misc/semver.html @@ -11,12 +11,11 @@ <h1><a href="../misc/semver.html">semver</a></h1> <p>The semantic versioner for npm</p> <h2 id="install">Install</h2> -<pre><code class="lang-bash">npm install --save semver -` -</code></pre> +<pre><code class="language-bash">npm install --save semver +`</code></pre> <h2 id="usage">Usage</h2> <p>As a node module:</p> -<pre><code class="lang-js">const semver = require('semver') +<pre><code class="language-js">const semver = require('semver') semver.valid('1.2.3') // '1.2.3' semver.valid('a.b.c') // null @@ -25,8 +24,7 @@ semver.satisfies('1.2.3', '1.x || >=2.5.0 || 5.0.0 - 7.2.3') semver.gt('1.2.3', '9.8.7') // false semver.lt('1.2.3', '9.8.7') // true semver.valid(semver.coerce('v2')) // '2.0.0' -semver.valid(semver.coerce('42.6.7.9.3-alpha')) // '42.6.7' -</code></pre> +semver.valid(semver.coerce('42.6.7.9.3-alpha')) // '42.6.7'</code></pre> <p>As a command-line utility:</p> <pre><code>$ semver -h @@ -65,8 +63,7 @@ all supplied ranges, and prints all satisfying versions. If no satisfying versions are found, then exits failure. Versions are printed in ascending order, so supplying -multiple versions to the utility will just sort them. -</code></pre><h2 id="versions">Versions</h2> +multiple versions to the utility will just sort them.</code></pre><h2 id="versions">Versions</h2> <p>A "version" is described by the <code>v2.0.0</code> specification found at <a href="http://semver.org/">http://semver.org/</a>.</p> <p>A leading <code>"="</code> or <code>"v"</code> character is stripped off and ignored.</p> @@ -123,17 +120,14 @@ similar risk on the <em>next</em> set of prerelease versions.</p> <h4 id="prerelease-identifiers">Prerelease Identifiers</h4> <p>The method <code>.inc</code> takes an additional <code>identifier</code> string argument that will append the value of the string as a prerelease identifier:</p> -<pre><code class="lang-javascript">semver.inc('1.2.3', 'prerelease', 'beta') -// '1.2.4-beta.0' -</code></pre> +<pre><code class="language-javascript">semver.inc('1.2.3', 'prerelease', 'beta') +// '1.2.4-beta.0'</code></pre> <p>command-line example:</p> -<pre><code class="lang-bash">$ semver 1.2.3 -i prerelease --preid beta -1.2.4-beta.0 -</code></pre> +<pre><code class="language-bash">$ semver 1.2.3 -i prerelease --preid beta +1.2.4-beta.0</code></pre> <p>Which then can be used to increment further:</p> -<pre><code class="lang-bash">$ semver 1.2.4-beta.0 -i prerelease -1.2.4-beta.1 -</code></pre> +<pre><code class="language-bash">$ semver 1.2.4-beta.0 -i prerelease +1.2.4-beta.1</code></pre> <h3 id="advanced-range-syntax">Advanced Range Syntax</h3> <p>Advanced range syntax desugars to primitive comparators in deterministic ways.</p> @@ -231,7 +225,7 @@ zero.</p> <h3 id="range-grammar">Range Grammar</h3> <p>Putting all this together, here is a Backus-Naur grammar for ranges, for the benefit of parser authors:</p> -<pre><code class="lang-bnf">range-set ::= range ( logical-or range ) * +<pre><code class="language-bnf">range-set ::= range ( logical-or range ) * logical-or ::= ( ' ' ) * '||' ( ' ' ) * range ::= hyphen | simple ( ' ' simple ) * | '' hyphen ::= partial ' - ' partial @@ -246,8 +240,7 @@ qualifier ::= ( '-' pre )? ( '+' build )? pre ::= parts build ::= parts parts ::= part ( '.' part ) * -part ::= nr | [-0-9A-Za-z]+ -</code></pre> +part ::= nr | [-0-9A-Za-z]+</code></pre> <h2 id="functions">Functions</h2> <p>All methods and classes take a final <code>loose</code> boolean argument that, if true, will be more forgiving about not-quite-valid semver strings. @@ -357,5 +350,5 @@ higher value components are invalid (<code>9999999999999999.4.7.4</code> is like <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr> <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr> </table> -<p id="footer">semver — npm@6.1.0</p> +<p id="footer">semver — npm@6.2.0</p> |