diff options
| author | isaacs <i@izs.me> | 2014-05-05 18:20:40 -0700 |
|---|---|---|
| committer | isaacs <i@izs.me> | 2014-05-05 18:20:40 -0700 |
| commit | 120f7cf55fb977a145dca0ed840ea5a07730da05 (patch) | |
| tree | d71ec93330b3e2514c144fa212579158bf5e3b3a /deps/npm/html/doc/api | |
| parent | 00890e43fb935c8bc5dc150f0f2c96bc465d8a4d (diff) | |
| download | node-new-120f7cf55fb977a145dca0ed840ea5a07730da05.tar.gz | |
npm: upgrade to 1.4.10
* Don't set referer if already set
* fetch: Send referer and npm-session headers
* run-script: Support --parseable and --json
* list runnable scripts (Evan Lucas)
* Use marked instead of ronn for html docs
Diffstat (limited to 'deps/npm/html/doc/api')
39 files changed, 384 insertions, 557 deletions
diff --git a/deps/npm/html/doc/api/npm-bin.html b/deps/npm/html/doc/api/npm-bin.html index a05ce13f7e..56bde010d9 100644 --- a/deps/npm/html/doc/api/npm-bin.html +++ b/deps/npm/html/doc/api/npm-bin.html @@ -10,17 +10,13 @@ <div id="wrapper"> <h1><a href="../api/npm-bin.html">npm-bin</a></h1> <p>Display npm bin folder</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.bin(args, cb)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.bin(args, cb) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the folder where npm will install executables.</p> - <p>This function should not be used programmatically. Instead, just refer to the <code>npm.bin</code> member.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -32,5 +28,5 @@ to the <code>npm.bin</code> member.</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-bin — npm@1.4.9</p> +<p id="footer">npm-bin — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-bugs.html b/deps/npm/html/doc/api/npm-bugs.html index 4bebd01512..4e5074f545 100644 --- a/deps/npm/html/doc/api/npm-bugs.html +++ b/deps/npm/html/doc/api/npm-bugs.html @@ -10,23 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-bugs.html">npm-bugs</a></h1> <p>Bugs for a package in a web browser maybe</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.bugs(package, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.bugs(package, callback) +</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.</p> - <p>Like other commands, the first parameter is an array. This command only uses the first element, which is expected to be a package name with an optional version number.</p> - <p>This command will launch a browser, so this command may not be the most friendly for programmatic use.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -38,5 +33,5 @@ friendly for programmatic use.</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-bugs — npm@1.4.9</p> +<p id="footer">npm-bugs — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-commands.html b/deps/npm/html/doc/api/npm-commands.html index d0363d2fe9..3c68e4ba52 100644 --- a/deps/npm/html/doc/api/npm-commands.html +++ b/deps/npm/html/doc/api/npm-commands.html @@ -10,26 +10,21 @@ <div id="wrapper"> <h1><a href="../api/npm-commands.html">npm-commands</a></h1> <p>npm commands</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands[<command>](args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands[<command>](args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>npm comes with a full set of commands, and each of the commands takes a similar set of arguments.</p> - <p>In general, all commands on the command object take an <strong>array</strong> of positional argument <strong>strings</strong>. The last argument to any function is a callback. Some commands are special and take other optional arguments.</p> - <p>All commands have their own man page. See <code>man npm-<command></code> for command-line usage, or <code>man 3 npm-<command></code> for programmatic usage.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../misc/npm-index.html">npm-index(7)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../misc/npm-index.html">npm-index(7)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -41,5 +36,5 @@ usage, or <code>man 3 npm-<command></code> for programmatic usage.</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-commands — npm@1.4.9</p> +<p id="footer">npm-commands — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-config.html b/deps/npm/html/doc/api/npm-config.html index caad29032a..eee2e52bb5 100644 --- a/deps/npm/html/doc/api/npm-config.html +++ b/deps/npm/html/doc/api/npm-config.html @@ -10,31 +10,42 @@ <div id="wrapper"> <h1><a href="../api/npm-config.html">npm-config</a></h1> <p>Manage the npm configuration files</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - +<h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm.commands.config(args, callback) var val = npm.config.get(key) -npm.config.set(key, val)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +npm.config.set(key, val) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This function acts much the same way as the command-line version. The first element in the array tells config what to do. Possible values are:</p> - -<ul><li><p><code>set</code></p><p>Sets a config parameter. The second element in <code>args</code> is interpreted as the -key, and the third element is interpreted as the value.</p></li><li><p><code>get</code></p><p>Gets the value of a config parameter. The second element in <code>args</code> is the -key to get the value of.</p></li><li><p><code>delete</code> (<code>rm</code> or <code>del</code>)</p><p>Deletes a parameter from the config. The second element in <code>args</code> is the -key to delete.</p></li><li><p><code>list</code> (<code>ls</code>)</p><p>Show all configs that aren't secret. No parameters necessary.</p></li><li><p><code>edit</code>:</p><p>Opens the config file in the default editor. This command isn't very useful -programmatically, but it is made available.</p></li></ul> - +<ul> +<li><p><code>set</code></p> +<p> Sets a config parameter. The second element in <code>args</code> is interpreted as the + key, and the third element is interpreted as the value.</p> +</li> +<li><p><code>get</code></p> +<p> Gets the value of a config parameter. The second element in <code>args</code> is the + key to get the value of.</p> +</li> +<li><p><code>delete</code> (<code>rm</code> or <code>del</code>)</p> +<p> Deletes a parameter from the config. The second element in <code>args</code> is the + key to delete.</p> +</li> +<li><p><code>list</code> (<code>ls</code>)</p> +<p> Show all configs that aren't secret. No parameters necessary.</p> +</li> +<li><p><code>edit</code>:</p> +<p> Opens the config file in the default editor. This command isn't very useful + programmatically, but it is made available.</p> +</li> +</ul> <p>To programmatically access npm configuration settings, or set them for the duration of a program, use the <code>npm.config.set</code> and <code>npm.config.get</code> functions instead.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../api/npm.html">npm(3)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../api/npm.html">npm(3)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -46,5 +57,5 @@ functions 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-config — npm@1.4.9</p> +<p id="footer">npm-config — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-deprecate.html b/deps/npm/html/doc/api/npm-deprecate.html index 0dc3214921..9513b96482 100644 --- a/deps/npm/html/doc/api/npm-deprecate.html +++ b/deps/npm/html/doc/api/npm-deprecate.html @@ -10,30 +10,32 @@ <div id="wrapper"> <h1><a href="../api/npm-deprecate.html">npm-deprecate</a></h1> <p>Deprecate a version of a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.deprecate(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.deprecate(args, callback) +</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>The 'args' parameter must have exactly two elements:</p> - -<ul><li><p><code>package[@version]</code></p><p>The <code>version</code> portion is optional, and may be either a range, or a -specific version, or a tag.</p></li><li><p><code>message</code></p><p>The warning message that will be printed whenever a user attempts to -install the package.</p></li></ul> - +<ul> +<li><p><code>package[@version]</code></p> +<p> The <code>version</code> portion is optional, and may be either a range, or a + specific version, or a tag.</p> +</li> +<li><p><code>message</code></p> +<p> The warning message that will be printed whenever a user attempts to + install the package.</p> +</li> +</ul> <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> +<ul> +<li><a href="../api/npm-publish.html">npm-publish(3)</a></li> +<li><a href="../api/npm-unpublish.html">npm-unpublish(3)</a></li> +<li><a href="../misc/npm-registry.html">npm-registry(7)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../api/npm-publish.html">npm-publish(3)</a></li><li><a href="../api/npm-unpublish.html">npm-unpublish(3)</a></li><li><a href="../misc/npm-registry.html">npm-registry(7)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -45,5 +47,5 @@ install the package.</p></li></ul> <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@1.4.9</p> +<p id="footer">npm-deprecate — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-docs.html b/deps/npm/html/doc/api/npm-docs.html index 26ce16900e..62e246e060 100644 --- a/deps/npm/html/doc/api/npm-docs.html +++ b/deps/npm/html/doc/api/npm-docs.html @@ -10,23 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-docs.html">npm-docs</a></h1> <p>Docs for a package in a web browser maybe</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.docs(package, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.docs(package, callback) +</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.</p> - <p>Like other commands, the first parameter is an array. This command only uses the first element, which is expected to be a package name with an optional version number.</p> - <p>This command will launch a browser, so this command may not be the most friendly for programmatic use.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -38,5 +33,5 @@ friendly for programmatic use.</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@1.4.9</p> +<p id="footer">npm-docs — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-edit.html b/deps/npm/html/doc/api/npm-edit.html index 28404e8775..78e685f04c 100644 --- a/deps/npm/html/doc/api/npm-edit.html +++ b/deps/npm/html/doc/api/npm-edit.html @@ -10,28 +10,21 @@ <div id="wrapper"> <h1><a href="../api/npm-edit.html">npm-edit</a></h1> <p>Edit an installed package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.edit(package, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.edit(package, callback) +</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>npm help config</code>.)</p> - <p>After it has been edited, the package is rebuilt so as to pick up any changes in compiled packages.</p> - <p>For instance, you can do <code>npm install connect</code> to install connect into your package, and then <code>npm.commands.edit(["connect"], callback)</code> to make a few changes to your locally installed copy.</p> - <p>The first parameter is a string array with a single element, the package to open. The package can optionally have a version number attached.</p> - <p>Since this command opens an editor in a new process, be careful about where and how this is used.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -43,5 +36,5 @@ and how this is used.</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-edit — npm@1.4.9</p> +<p id="footer">npm-edit — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-explore.html b/deps/npm/html/doc/api/npm-explore.html index da568a5ebe..d177e9089d 100644 --- a/deps/npm/html/doc/api/npm-explore.html +++ b/deps/npm/html/doc/api/npm-explore.html @@ -10,22 +10,16 @@ <div id="wrapper"> <h1><a href="../api/npm-explore.html">npm-explore</a></h1> <p>Browse an installed package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.explore(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.explore(args, callback) +</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>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> - <p>The first element in the 'args' parameter must be a package name. After that is the optional command, which can be any number of strings. All of the strings will be combined into one, space-delimited command.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -37,5 +31,5 @@ sure to use <code>npm rebuild <pkg></code> if you make any changes.</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-explore — npm@1.4.9</p> +<p id="footer">npm-explore — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-help-search.html b/deps/npm/html/doc/api/npm-help-search.html index b59a915114..ec4c6ea06e 100644 --- a/deps/npm/html/doc/api/npm-help-search.html +++ b/deps/npm/html/doc/api/npm-help-search.html @@ -10,30 +10,29 @@ <div id="wrapper"> <h1><a href="../api/npm-help-search.html">npm-help-search</a></h1> <p>Search the help pages</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.helpSearch(args, [silent,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.helpSearch(args, [silent,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command is rarely useful, but it exists in the rare case that it is.</p> - <p>This command takes an array of search terms and returns the help pages that match in order of best match.</p> - <p>If there is only one match, then npm displays that help section. If there are multiple results, the results are printed to the screen formatted and the array of results is returned. Each result is an object with these properties:</p> - -<ul><li>hits: -A map of args to number of hits on that arg. For example, {"npm": 3}</li><li>found: -Total number of unique args that matched.</li><li>totalHits: -Total number of hits.</li><li>lines: -An array of all matching lines (and some adjacent lines).</li><li>file: -Name of the file that matched</li></ul> - +<ul> +<li>hits: +A map of args to number of hits on that arg. For example, {"npm": 3}</li> +<li>found: +Total number of unique args that matched.</li> +<li>totalHits: +Total number of hits.</li> +<li>lines: +An array of all matching lines (and some adjacent lines).</li> +<li>file: +Name of the file that matched</li> +</ul> <p>The silent parameter is not neccessary not used, but it may in the future.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -45,5 +44,5 @@ Name of the file that matched</li></ul> <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@1.4.9</p> +<p id="footer">npm-help-search — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-init.html b/deps/npm/html/doc/api/npm-init.html index 9c5167718a..81d790bb75 100644 --- a/deps/npm/html/doc/api/npm-init.html +++ b/deps/npm/html/doc/api/npm-init.html @@ -10,33 +10,24 @@ <div id="wrapper"> <h1>npm <a href="../api/init.html">init</a></h1> <p>Interactively create a package.json file</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.init(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.init(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This will ask you a bunch of questions, and then write a package.json for you.</p> - <p>It attempts to make reasonable guesses about what you want things to be set to, and then writes a package.json file with the options you've selected.</p> - <p>If you already have a package.json file, it'll read that first, and default to the options in there.</p> - <p>It is strictly additive, so it does not delete options from your package.json without a really good reason to do so.</p> - <p>Since this function expects to be run on the command-line, it doesn't work very well as a programmatically. The best option is to roll your own, and since JavaScript makes it stupid simple to output formatted JSON, that is the preferred method. If you're sure you want to handle command-line prompting, then go ahead and use this programmatically.</p> - -<h2 id="SEE-ALSO">SEE ALSO</h2> - +<h2 id="see-also">SEE ALSO</h2> <p><a href="../files/package.json.html">package.json(5)</a></p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -48,5 +39,5 @@ then go ahead and use this programmatically.</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@1.4.9</p> +<p id="footer">npm-init — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-install.html b/deps/npm/html/doc/api/npm-install.html index 1ffdc9c142..5fa76079aa 100644 --- a/deps/npm/html/doc/api/npm-install.html +++ b/deps/npm/html/doc/api/npm-install.html @@ -10,23 +10,17 @@ <div id="wrapper"> <h1><a href="../api/npm-install.html">npm-install</a></h1> <p>install a package programmatically</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.install([where,] packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.install([where,] packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This acts much the same ways as installing on the command-line.</p> - <p>The 'where' parameter is optional and only used internally, and it specifies where the packages should be installed to.</p> - <p>The 'packages' parameter is an array of strings. Each element in the array is the name of a package to be installed.</p> - <p>Finally, 'callback' is a function that will be called when all packages have been installed or when an error has been encountered.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -38,5 +32,5 @@ installed or when an error has been encountered.</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@1.4.9</p> +<p id="footer">npm-install — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-link.html b/deps/npm/html/doc/api/npm-link.html index 9be928229c..1f162e3b40 100644 --- a/deps/npm/html/doc/api/npm-link.html +++ b/deps/npm/html/doc/api/npm-link.html @@ -10,37 +10,27 @@ <div id="wrapper"> <h1><a href="../api/npm-link.html">npm-link</a></h1> <p>Symlink a package folder</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - +<h2 id="synopsis">SYNOPSIS</h2> <pre><code>npm.command.link(callback) -npm.command.link(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +npm.command.link(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Package linking is a two-step process.</p> - <p>Without parameters, link will create a globally-installed symbolic link from <code>prefix/package-name</code> to the current folder.</p> - <p>With a parameters, link will create a symlink from the local <code>node_modules</code> folder to the global symlink.</p> - <p>When creating tarballs for <code>npm publish</code>, the linked packages are "snapshotted" to their current state by resolving the symbolic links.</p> - <p>This is handy for installing your own stuff, so that you can work on it and test it iteratively without having to continually rebuild.</p> - <p>For example:</p> - <pre><code>npm.commands.link(cb) # creates global link from the cwd # (say redis package) -npm.commands.link('redis', cb) # link-install the package</code></pre> - -<p>Now, any changes to the redis package will be reflected in +npm.commands.link('redis', cb) # link-install the package +</code></pre><p>Now, any changes to the redis package will be reflected in the package in the current working directory</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -52,5 +42,5 @@ the package in the current working directory</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@1.4.9</p> +<p id="footer">npm-link — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-load.html b/deps/npm/html/doc/api/npm-load.html index 9b28559a05..b996d7aa9a 100644 --- a/deps/npm/html/doc/api/npm-load.html +++ b/deps/npm/html/doc/api/npm-load.html @@ -10,30 +10,22 @@ <div id="wrapper"> <h1><a href="../api/npm-load.html">npm-load</a></h1> <p>Load config settings</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.load(conf, cb)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.load(conf, cb) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>npm.load() must be called before any other function call. Both parameters are optional, but the second is recommended.</p> - <p>The first parameter is an object hash of command-line config params, and the second parameter is a callback that will be called when npm is loaded and ready to serve.</p> - <p>The first parameter should follow a similar structure as the package.json config object.</p> - <p>For example, to emulate the --dev flag, pass an object that looks like this:</p> - <pre><code>{ "dev": true -}</code></pre> +} +</code></pre><p>For a list of all the available command-line configs, see <code>npm help config</code></p> -<p>For a list of all the available command-line configs, see <code>npm help config</code></p> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -45,5 +37,5 @@ config object.</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-load — npm@1.4.9</p> +<p id="footer">npm-load — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-ls.html b/deps/npm/html/doc/api/npm-ls.html index aead5264be..cd5f19880b 100644 --- a/deps/npm/html/doc/api/npm-ls.html +++ b/deps/npm/html/doc/api/npm-ls.html @@ -10,57 +10,48 @@ <div id="wrapper"> <h1><a href="../api/npm-ls.html">npm-ls</a></h1> <p>List installed packages</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.ls(args, [silent,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.ls(args, [silent,] callback) +</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. It will also return that data using the callback.</p> - <p>This command does not take any arguments, but args must be defined. Beyond that, if any arguments are passed in, npm will politely warn that it does not take positional arguments, though you may set config flags like with any other command, such as <code>global</code> to list global packages.</p> - <p>It will print out extraneous, missing, and invalid packages.</p> - <p>If the silent parameter is set to true, nothing will be output to the screen, but the data will still be returned.</p> - <p>Callback is provided an error if one occurred, the full data about which packages are installed and which dependencies they will receive, and a "lite" data object which just shows which versions are installed where. Note that the full data object is a circular structure, so care must be taken if it is serialized to JSON.</p> - -<h2 id="CONFIGURATION">CONFIGURATION</h2> - +<h2 id="configuration">CONFIGURATION</h2> <h3 id="long">long</h3> - -<ul><li>Default: false</li><li>Type: Boolean</li></ul> - +<ul> +<li>Default: false</li> +<li>Type: Boolean</li> +</ul> <p>Show extended information.</p> - <h3 id="parseable">parseable</h3> - -<ul><li>Default: false</li><li>Type: Boolean</li></ul> - +<ul> +<li>Default: false</li> +<li>Type: Boolean</li> +</ul> <p>Show parseable output instead of tree view.</p> - <h3 id="global">global</h3> - -<ul><li>Default: false</li><li>Type: Boolean</li></ul> - +<ul> +<li>Default: false</li> +<li>Type: Boolean</li> +</ul> <p>List packages in the global install prefix instead of in the current project.</p> - <p>Note, if parseable is set or long isn't set, then duplicates will be trimmed. This means that if a submodule a same dependency as a parent module, then the dependency will only be output once.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -72,5 +63,5 @@ dependency will only be output once.</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@1.4.9</p> +<p id="footer">npm-ls — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-outdated.html b/deps/npm/html/doc/api/npm-outdated.html index 895b679a24..854942b7d6 100644 --- a/deps/npm/html/doc/api/npm-outdated.html +++ b/deps/npm/html/doc/api/npm-outdated.html @@ -10,17 +10,13 @@ <div id="wrapper"> <h1><a href="../api/npm-outdated.html">npm-outdated</a></h1> <p>Check for outdated packages</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.outdated([packages,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.outdated([packages,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command will check the registry to see if the specified packages are currently outdated.</p> - <p>If the 'packages' parameter is left out, npm will check all packages.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -32,5 +28,5 @@ currently outdated.</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@1.4.9</p> +<p id="footer">npm-outdated — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-owner.html b/deps/npm/html/doc/api/npm-owner.html index d0abc7095a..8a71f25e40 100644 --- a/deps/npm/html/doc/api/npm-owner.html +++ b/deps/npm/html/doc/api/npm-owner.html @@ -10,32 +10,32 @@ <div id="wrapper"> <h1><a href="../api/npm-owner.html">npm-owner</a></h1> <p>Manage package owners</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.owner(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.owner(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>The first element of the 'args' parameter defines what to do, and the subsequent elements depend on the action. Possible values for the action are (order of parameters are given in parenthesis):</p> - -<ul><li>ls (package): +<ul> +<li>ls (package): List all the users who have access to modify a package and push new versions. -Handy when you need to know who to bug for help.</li><li>add (user, package): +Handy when you need to know who to bug for help.</li> +<li>add (user, package): Add a new user as a maintainer of a package. This user is enabled to modify -metadata, publish new versions, and add other owners.</li><li>rm (user, package): +metadata, publish new versions, and add other owners.</li> +<li>rm (user, package): Remove a user from the package owner list. This immediately revokes their -privileges.</li></ul> - +privileges.</li> +</ul> <p>Note that there is only one level of access. Either you can modify a package, or you can't. Future versions may contain more fine-grained access levels, but that is not implemented at this time.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../api/npm-publish.html">npm-publish(3)</a></li> +<li><a href="../misc/npm-registry.html">npm-registry(7)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../api/npm-publish.html">npm-publish(3)</a></li><li><a href="../misc/npm-registry.html">npm-registry(7)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -47,5 +47,5 @@ that is not implemented at this 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-owner — npm@1.4.9</p> +<p id="footer">npm-owner — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-pack.html b/deps/npm/html/doc/api/npm-pack.html index dfa62abd02..d08cbfae64 100644 --- a/deps/npm/html/doc/api/npm-pack.html +++ b/deps/npm/html/doc/api/npm-pack.html @@ -10,23 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-pack.html">npm-pack</a></h1> <p>Create a tarball from a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.pack([packages,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.pack([packages,] callback) +</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, or name), this command will fetch it to the cache, and then copy the tarball to the current working directory as <code><name>-<version>.tgz</code>, and then write the filenames out to stdout.</p> - <p>If the same package is specified multiple times, then the file will be overwritten the second time.</p> - <p>If no arguments are supplied, then npm packs the current package folder.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -38,5 +33,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@1.4.9</p> +<p id="footer">npm-pack — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-prefix.html b/deps/npm/html/doc/api/npm-prefix.html index 24725f0706..44a17f79cb 100644 --- a/deps/npm/html/doc/api/npm-prefix.html +++ b/deps/npm/html/doc/api/npm-prefix.html @@ -10,19 +10,14 @@ <div id="wrapper"> <h1><a href="../api/npm-prefix.html">npm-prefix</a></h1> <p>Display prefix</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.prefix(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.prefix(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the prefix to standard out.</p> - <p>'args' is never used and callback is never called with data. 'args' must be present or things will break.</p> - <p>This function is not useful programmatically</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -34,5 +29,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-prefix — npm@1.4.9</p> +<p id="footer">npm-prefix — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-prune.html b/deps/npm/html/doc/api/npm-prune.html index 9eb26c5fc5..0358f77a6b 100644 --- a/deps/npm/html/doc/api/npm-prune.html +++ b/deps/npm/html/doc/api/npm-prune.html @@ -10,21 +10,15 @@ <div id="wrapper"> <h1><a href="../api/npm-prune.html">npm-prune</a></h1> <p>Remove extraneous packages</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.prune([packages,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.prune([packages,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command removes "extraneous" packages.</p> - <p>The first parameter is optional, and it specifies packages to be removed.</p> - <p>No packages are specified, then all packages will be checked.</p> - <p>Extraneous packages are packages that are not listed on the parent package's dependencies list.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -36,5 +30,5 @@ package's dependencies list.</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-prune — npm@1.4.9</p> +<p id="footer">npm-prune — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-publish.html b/deps/npm/html/doc/api/npm-publish.html index bc13269845..e3e03960b1 100644 --- a/deps/npm/html/doc/api/npm-publish.html +++ b/deps/npm/html/doc/api/npm-publish.html @@ -10,30 +10,31 @@ <div id="wrapper"> <h1><a href="../api/npm-publish.html">npm-publish</a></h1> <p>Publish a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.publish([packages,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.publish([packages,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Publishes a package to the registry so that it can be installed by name. Possible values in the 'packages' array are:</p> - -<ul><li><p><code><folder></code>: -A folder containing a package.json file</p></li><li><p><code><tarball></code>: +<ul> +<li><p><code><folder></code>: +A folder containing a package.json file</p> +</li> +<li><p><code><tarball></code>: A url or file path to a gzipped tar archive containing a single folder -with a package.json file inside.</p></li></ul> - +with a package.json file inside.</p> +</li> +</ul> <p>If the package array is empty, npm will try to publish something in the current working directory.</p> - <p>This command could fails if one of the packages specified already exists in the registry. Overwrites when the "force" environment variable is set.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../misc/npm-registry.html">npm-registry(7)</a></li> +<li><a href="../cli/npm-adduser.html">npm-adduser(1)</a></li> +<li><a href="../api/npm-owner.html">npm-owner(3)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../misc/npm-registry.html">npm-registry(7)</a></li><li><a href="../cli/npm-adduser.html">npm-adduser(1)</a></li><li><a href="../api/npm-owner.html">npm-owner(3)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -45,5 +46,5 @@ the registry. Overwrites when the "force" environment variable is set <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@1.4.9</p> +<p id="footer">npm-publish — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-rebuild.html b/deps/npm/html/doc/api/npm-rebuild.html index 8debe23793..f37301f564 100644 --- a/deps/npm/html/doc/api/npm-rebuild.html +++ b/deps/npm/html/doc/api/npm-rebuild.html @@ -10,20 +10,15 @@ <div id="wrapper"> <h1><a href="../api/npm-rebuild.html">npm-rebuild</a></h1> <p>Rebuild a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.rebuild([packages,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.rebuild([packages,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This command runs the <code>npm build</code> command on each of the matched packages. This is useful when you install a new version of node, and must recompile all your C++ addons with the new binary. If no 'packages' parameter is specify, every package will be rebuilt.</p> - -<h2 id="CONFIGURATION">CONFIGURATION</h2> - +<h2 id="configuration">CONFIGURATION</h2> <p>See <code>npm help build</code></p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -35,5 +30,5 @@ the new binary. If no 'packages' parameter is specify, every package wil <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@1.4.9</p> +<p id="footer">npm-rebuild — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-repo.html b/deps/npm/html/doc/api/npm-repo.html index 1919ad405c..8af28e55c2 100644 --- a/deps/npm/html/doc/api/npm-repo.html +++ b/deps/npm/html/doc/api/npm-repo.html @@ -10,23 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-repo.html">npm-repo</a></h1> <p>Open package repository page in the browser</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.repo(package, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.repo(package, callback) +</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.</p> - <p>Like other commands, the first parameter is an array. This command only uses the first element, which is expected to be a package name with an optional version number.</p> - <p>This command will launch a browser, so this command may not be the most friendly for programmatic use.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -38,5 +33,5 @@ friendly for programmatic use.</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-repo — npm@1.4.9</p> +<p id="footer">npm-repo — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-restart.html b/deps/npm/html/doc/api/npm-restart.html index fd97a5d434..bd33c4458f 100644 --- a/deps/npm/html/doc/api/npm-restart.html +++ b/deps/npm/html/doc/api/npm-restart.html @@ -10,25 +10,21 @@ <div id="wrapper"> <h1><a href="../api/npm-restart.html">npm-restart</a></h1> <p>Start a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.restart(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.restart(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "restart" script, if one was provided. Otherwise it runs package's "stop" script, if one was provided, and then the "start" script.</p> - <p>If no version is specified, then it restarts the "active" version.</p> - <p>npm can run tests on multiple packages. Just specify multiple packages in the <code>packages</code> parameter.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../api/npm-start.html">npm-start(3)</a></li> +<li><a href="../api/npm-stop.html">npm-stop(3)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../api/npm-start.html">npm-start(3)</a></li><li><a href="../api/npm-stop.html">npm-stop(3)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -40,5 +36,5 @@ in the <code>packages</code> parameter.</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@1.4.9</p> +<p id="footer">npm-restart — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-root.html b/deps/npm/html/doc/api/npm-root.html index 720b215ae5..ef54abb66d 100644 --- a/deps/npm/html/doc/api/npm-root.html +++ b/deps/npm/html/doc/api/npm-root.html @@ -10,19 +10,14 @@ <div id="wrapper"> <h1><a href="../api/npm-root.html">npm-root</a></h1> <p>Display npm root</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.root(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.root(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the effective <code>node_modules</code> folder to standard out.</p> - <p>'args' is never used and callback is never called with data. 'args' must be present or things will break.</p> - <p>This function is not useful programmatically.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -34,5 +29,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@1.4.9</p> +<p id="footer">npm-root — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-run-script.html b/deps/npm/html/doc/api/npm-run-script.html index 3a85569d14..b1575d6992 100644 --- a/deps/npm/html/doc/api/npm-run-script.html +++ b/deps/npm/html/doc/api/npm-run-script.html @@ -10,27 +10,26 @@ <div id="wrapper"> <h1><a href="../api/npm-run-script.html">npm-run-script</a></h1> <p>Run arbitrary package scripts</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.run-script(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.run-script(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs an arbitrary command from a package's "scripts" object.</p> - <p>It is used by the test, start, restart, and stop commands, but can be called directly, as well.</p> - <p>The 'args' parameter is an array of strings. Behavior depends on the number of elements. If there is only one element, npm assumes that the element represents a command to be run on the local repository. If there is more than one element, then the first is assumed to be the package and the second is assumed to be the command to run. All other elements are ignored.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li><a href="../misc/npm-scripts.html">npm-scripts(7)</a></li> +<li><a href="../api/npm-test.html">npm-test(3)</a></li> +<li><a href="../api/npm-start.html">npm-start(3)</a></li> +<li><a href="../api/npm-restart.html">npm-restart(3)</a></li> +<li><a href="../api/npm-stop.html">npm-stop(3)</a></li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li><a href="../misc/npm-scripts.html">npm-scripts(7)</a></li><li><a href="../api/npm-test.html">npm-test(3)</a></li><li><a href="../api/npm-start.html">npm-start(3)</a></li><li><a href="../api/npm-restart.html">npm-restart(3)</a></li><li><a href="../api/npm-stop.html">npm-stop(3)</a></li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -42,5 +41,5 @@ assumed to be the command to run. All other elements are 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">npm-run-script — npm@1.4.9</p> +<p id="footer">npm-run-script — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-search.html b/deps/npm/html/doc/api/npm-search.html index 1eded8ed59..d13d836c97 100644 --- a/deps/npm/html/doc/api/npm-search.html +++ b/deps/npm/html/doc/api/npm-search.html @@ -10,30 +10,38 @@ <div id="wrapper"> <h1><a href="../api/npm-search.html">npm-search</a></h1> <p>Search for packages</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.search(searchTerms, [silent,] [staleness,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.search(searchTerms, [silent,] [staleness,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Search the registry for packages matching the search terms. The available parameters are:</p> - -<ul><li>searchTerms: -Array of search terms. These terms are case-insensitive.</li><li>silent: -If true, npm will not log anything to the console.</li><li>staleness: +<ul> +<li>searchTerms: +Array of search terms. These terms are case-insensitive.</li> +<li>silent: +If true, npm will not log anything to the console.</li> +<li>staleness: This is the threshold for stale packages. "Fresh" packages are not refreshed -from the registry. This value is measured in seconds.</li><li><p>callback: +from the registry. This value is measured in seconds.</li> +<li><p>callback: Returns an object where each key is the name of a package, and the value is information about that package along with a 'words' property, which is a space-delimited string of all of the interesting words in that package. -The only properties included are those that are searched, which generally include:</p><ul><li>name</li><li>description</li><li>maintainers</li><li>url</li><li>keywords</li></ul></li></ul> - +The only properties included are those that are searched, which generally include:</p> +<ul> +<li>name</li> +<li>description</li> +<li>maintainers</li> +<li>url</li> +<li>keywords</li> +</ul> +</li> +</ul> <p>A search on the registry excludes any result that does not match all of the search terms. It also removes any items from the results that contain an excluded term (the "searchexclude" config). The search is case insensitive and doesn't try to read your mind (it doesn't do any verb tense matching or the like).</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -45,5 +53,5 @@ 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-search — npm@1.4.9</p> +<p id="footer">npm-search — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-shrinkwrap.html b/deps/npm/html/doc/api/npm-shrinkwrap.html index 8a34fa5f31..659d1b392a 100644 --- a/deps/npm/html/doc/api/npm-shrinkwrap.html +++ b/deps/npm/html/doc/api/npm-shrinkwrap.html @@ -10,24 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-shrinkwrap.html">npm-shrinkwrap</a></h1> <p>programmatically generate package shrinkwrap file</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.shrinkwrap(args, [silent,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.shrinkwrap(args, [silent,] callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This acts much the same ways as shrinkwrapping on the command-line.</p> - <p>This command does not take any arguments, but 'args' must be defined. Beyond that, if any arguments are passed in, npm will politely warn that it does not take positional arguments.</p> - <p>If the 'silent' parameter is set to true, nothing will be output to the screen, but the shrinkwrap file will still be written.</p> - <p>Finally, 'callback' is a function that will be called when the shrinkwrap has been saved.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -39,5 +33,5 @@ been saved.</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-shrinkwrap — npm@1.4.9</p> +<p id="footer">npm-shrinkwrap — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-start.html b/deps/npm/html/doc/api/npm-start.html index 2487a7356a..2b2f41fd81 100644 --- a/deps/npm/html/doc/api/npm-start.html +++ b/deps/npm/html/doc/api/npm-start.html @@ -10,17 +10,13 @@ <div id="wrapper"> <h1><a href="../api/npm-start.html">npm-start</a></h1> <p>Start a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.start(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.start(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "start" script, if one was provided.</p> - <p>npm can run tests on multiple packages. Just specify multiple packages in the <code>packages</code> parameter.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -32,5 +28,5 @@ in the <code>packages</code> parameter.</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@1.4.9</p> +<p id="footer">npm-start — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-stop.html b/deps/npm/html/doc/api/npm-stop.html index efe89b327e..a7dfcedd4d 100644 --- a/deps/npm/html/doc/api/npm-stop.html +++ b/deps/npm/html/doc/api/npm-stop.html @@ -10,17 +10,13 @@ <div id="wrapper"> <h1><a href="../api/npm-stop.html">npm-stop</a></h1> <p>Stop a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.stop(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.stop(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "stop" script, if one was provided.</p> - <p>npm can run stop on multiple packages. Just specify multiple packages in the <code>packages</code> parameter.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -32,5 +28,5 @@ in the <code>packages</code> parameter.</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-stop — npm@1.4.9</p> +<p id="footer">npm-stop — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-submodule.html b/deps/npm/html/doc/api/npm-submodule.html index 2e9ff82ef4..ab98ab5bc7 100644 --- a/deps/npm/html/doc/api/npm-submodule.html +++ b/deps/npm/html/doc/api/npm-submodule.html @@ -10,31 +10,27 @@ <div id="wrapper"> <h1><a href="../api/npm-submodule.html">npm-submodule</a></h1> <p>Add a package as a git submodule</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.submodule(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.submodule(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>For each package specified, npm will check if it has a git repository url in its package.json description then add it as a git submodule at <code>node_modules/<pkg name></code>.</p> - <p>This is a convenience only. From then on, it's up to you to manage updates by using the appropriate git commands. npm will stubbornly refuse to update, modify, or remove anything with a <code>.git</code> subfolder in it.</p> - <p>This command also does not install missing dependencies, if the package does not include them in its git repository. If <code>npm ls</code> reports that things are missing, you can either install, link, or submodule them yourself, or you can do <code>npm explore <pkgname> -- npm install</code> to install the dependencies into the submodule folder.</p> +<h2 id="see-also">SEE ALSO</h2> +<ul> +<li>npm help json</li> +<li>git help submodule</li> +</ul> -<h2 id="SEE-ALSO">SEE ALSO</h2> - -<ul><li>npm help json</li><li>git help submodule</li></ul> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -46,5 +42,5 @@ dependencies into the submodule folder.</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-submodule — npm@1.4.9</p> +<p id="footer">npm-submodule — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-tag.html b/deps/npm/html/doc/api/npm-tag.html index 8855068be9..af49ab4556 100644 --- a/deps/npm/html/doc/api/npm-tag.html +++ b/deps/npm/html/doc/api/npm-tag.html @@ -10,27 +10,21 @@ <div id="wrapper"> <h1><a href="../api/npm-tag.html">npm-tag</a></h1> <p>Tag a published version</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.tag(package@version, tag, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.tag(package@version, tag, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Tags the specified version of the package with the specified tag, or the <code>--tag</code> config if not specified.</p> - <p>The 'package@version' is an array of strings, but only the first two elements are currently used.</p> - <p>The first element must be in the form package@version, where package is the package name and version is the version number (much like installing a specific version).</p> - <p>The second element is the name of the tag to tag this version with. If this parameter is missing or falsey (empty), the default froom the config will be used. For more information about how to set this config, check <code>man 3 npm-config</code> for programmatic usage or <code>man npm-config</code> for cli usage.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -42,5 +36,5 @@ used. For more information about how to set this config, check <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-tag — npm@1.4.9</p> +<p id="footer">npm-tag — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-test.html b/deps/npm/html/doc/api/npm-test.html index a185a379e3..548d979374 100644 --- a/deps/npm/html/doc/api/npm-test.html +++ b/deps/npm/html/doc/api/npm-test.html @@ -10,20 +10,15 @@ <div id="wrapper"> <h1><a href="../api/npm-test.html">npm-test</a></h1> <p>Test a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code> npm.commands.test(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code> npm.commands.test(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This runs a package's "test" script, if one was provided.</p> - <p>To run tests as a condition of installation, set the <code>npat</code> config to true.</p> - <p>npm can run tests on multiple packages. Just specify multiple packages in the <code>packages</code> parameter.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -35,5 +30,5 @@ in the <code>packages</code> parameter.</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-test — npm@1.4.9</p> +<p id="footer">npm-test — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-uninstall.html b/deps/npm/html/doc/api/npm-uninstall.html index 3a14ad08b8..77f6233a00 100644 --- a/deps/npm/html/doc/api/npm-uninstall.html +++ b/deps/npm/html/doc/api/npm-uninstall.html @@ -10,20 +10,15 @@ <div id="wrapper"> <h1><a href="../api/npm-uninstall.html">npm-uninstall</a></h1> <p>uninstall a package programmatically</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.uninstall(packages, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.uninstall(packages, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This acts much the same ways as uninstalling on the command-line.</p> - <p>The 'packages' parameter is an array of strings. Each element in the array is the name of a package to be uninstalled.</p> - <p>Finally, 'callback' is a function that will be called when all packages have been uninstalled or when an error has been encountered.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -35,5 +30,5 @@ uninstalled or when an error has been encountered.</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-uninstall — npm@1.4.9</p> +<p id="footer">npm-uninstall — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-unpublish.html b/deps/npm/html/doc/api/npm-unpublish.html index 3d3924c520..7b3c99df22 100644 --- a/deps/npm/html/doc/api/npm-unpublish.html +++ b/deps/npm/html/doc/api/npm-unpublish.html @@ -10,24 +10,18 @@ <div id="wrapper"> <h1><a href="../api/npm-unpublish.html">npm-unpublish</a></h1> <p>Remove a package from the registry</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.unpublish(package, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.unpublish(package, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>This removes a package version from the registry, deleting its entry and removing the tarball.</p> - <p>The package parameter must be defined.</p> - <p>Only the first element in the package parameter is used. If there is no first element, then npm assumes that the package at the current working directory is what is meant.</p> - <p>If no version is specified, or if all versions are removed then the root package entry is removed from the registry entirely.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -39,5 +33,5 @@ the root package entry is removed from the registry entirely.</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@1.4.9</p> +<p id="footer">npm-unpublish — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-update.html b/deps/npm/html/doc/api/npm-update.html index 60366fc1fe..f706f1e861 100644 --- a/deps/npm/html/doc/api/npm-update.html +++ b/deps/npm/html/doc/api/npm-update.html @@ -10,16 +10,12 @@ <div id="wrapper"> <h1><a href="../api/npm-update.html">npm-update</a></h1> <p>Update a package</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.update(packages, callback)</code></pre> - -<h1>DESCRIPTION</h1> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.update(packages, callback) +</code></pre><h1 id="description">DESCRIPTION</h1> <p>Updates a package, upgrading it to the latest version. It also installs any missing packages.</p> - <p>The 'packages' argument is an array of packages to update. The 'callback' parameter will be called when done or when an error occurs.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -31,5 +27,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-update — npm@1.4.9</p> +<p id="footer">npm-update — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-version.html b/deps/npm/html/doc/api/npm-version.html index b60668c947..ede9d6b37f 100644 --- a/deps/npm/html/doc/api/npm-version.html +++ b/deps/npm/html/doc/api/npm-version.html @@ -10,22 +10,17 @@ <div id="wrapper"> <h1><a href="../api/npm-version.html">npm-version</a></h1> <p>Bump a package version</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.version(newversion, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.version(newversion, callback) +</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 the package.json file.</p> - <p>If run in a git repo, it will also create a version commit and tag, and fail if the repo is not clean.</p> - <p>Like all other commands, this function takes a string array as its first parameter. The difference, however, is this function will fail if it does not have exactly one element. The only element should be a version number.</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -37,5 +32,5 @@ not have exactly one element. The only element should be a 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-version — npm@1.4.9</p> +<p id="footer">npm-version — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-view.html b/deps/npm/html/doc/api/npm-view.html index 68cc00da18..b4c54cf1fc 100644 --- a/deps/npm/html/doc/api/npm-view.html +++ b/deps/npm/html/doc/api/npm-view.html @@ -10,97 +10,66 @@ <div id="wrapper"> <h1><a href="../api/npm-view.html">npm-view</a></h1> <p>View registry info</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.view(args, [silent,] callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.view(args, [silent,] callback) +</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>The "args" parameter is an ordered list that closely resembles the command-line usage. The elements should be ordered such that the first element is the package and version (package@version). The version is optional. After that, the rest of the parameters are fields with optional subfields ("field.subfield") which can be used to get only the information desired from the registry.</p> - <p>The callback will be passed all of the data returned by the query.</p> - <p>For example, to get the package registry entry for the <code>connect</code> package, you can do this:</p> - -<pre><code>npm.commands.view(["connect"], callback)</code></pre> - -<p>If no version is specified, "latest" is assumed.</p> - +<pre><code>npm.commands.view(["connect"], callback) +</code></pre><p>If no version is specified, "latest" is assumed.</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.commands.view(["ronn@0.3.5", "dependencies"], callback)</code></pre> - -<p>You can view child field by separating them with a period. +<pre><code>npm.commands.view(["ronn@0.3.5", "dependencies"], callback) +</code></pre><p>You can view child field 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.commands.view(["npm", "repository.url"], callback)</code></pre> - -<p>For fields that are arrays, requesting a non-numeric field will return +<pre><code>npm.commands.view(["npm", "repository.url"], callback) +</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.commands.view(["express", "contributors.email"], callback)</code></pre> - -<p>You may also use numeric indices in square braces to specifically select +<pre><code>npm.commands.view(["express", "contributors.email"], callback) +</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.commands.view(["express", "contributors[0].email"], callback)</code></pre> - -<p>Multiple fields may be specified, and will be printed one after another. +<pre><code>npm.commands.view(["express", "contributors[0].email"], callback) +</code></pre><p>Multiple fields may be specified, and will be printed one after another. For exampls, to get all the contributor names and email addresses, you can do this:</p> - -<pre><code>npm.commands.view(["express", "contributors.name", "contributors.email"], callback)</code></pre> - -<p>"Person" fields are shown as a string if they would be shown as an +<pre><code>npm.commands.view(["express", "contributors.name", "contributors.email"], callback) +</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>npm help json</code> for more on this.)</p> - -<pre><code>npm.commands.view(["npm", "contributors"], callback)</code></pre> - -<p>If a version range is provided, then data will be printed for every +<pre><code>npm.commands.view(["npm", "contributors"], callback) +</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.commands.view(["yui3@'>0.5.4'", "dependencies.jsdom"], callback)</code></pre> - -<h2 id="OUTPUT">OUTPUT</h2> - +<pre><code>npm.commands.view(["yui3@'>0.5.4'", "dependencies.jsdom"], callback) +</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.</p> - <p>If the version range matches multiple versions, than each printed value will be prefixed with the version it applies to.</p> - <p>If multiple fields are requested, than each of them are prefixed with the field name.</p> - <p>Console output can be disabled by setting the 'silent' parameter to true.</p> - -<h2 id="RETURN-VALUE">RETURN VALUE</h2> - +<h2 id="return-value">RETURN VALUE</h2> <p>The data returned will be an object in this formation:</p> - <pre><code>{ <version>: { <field>: <value> , ... } -, ... }</code></pre> +, ... } +</code></pre><p>corresponding to the list of fields selected.</p> -<p>corresponding to the list of fields selected.</p> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -112,5 +81,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@1.4.9</p> +<p id="footer">npm-view — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm-whoami.html b/deps/npm/html/doc/api/npm-whoami.html index 2eb06fa97f..b6e17a6b51 100644 --- a/deps/npm/html/doc/api/npm-whoami.html +++ b/deps/npm/html/doc/api/npm-whoami.html @@ -10,19 +10,14 @@ <div id="wrapper"> <h1><a href="../api/npm-whoami.html">npm-whoami</a></h1> <p>Display npm username</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - -<pre><code>npm.commands.whoami(args, callback)</code></pre> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +<h2 id="synopsis">SYNOPSIS</h2> +<pre><code>npm.commands.whoami(args, callback) +</code></pre><h2 id="description">DESCRIPTION</h2> <p>Print the <code>username</code> config to standard output.</p> - <p>'args' is never used and callback is never called with data. 'args' must be present or things will break.</p> - <p>This function is not useful programmatically</p> + </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -34,5 +29,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@1.4.9</p> +<p id="footer">npm-whoami — npm@1.4.10</p> diff --git a/deps/npm/html/doc/api/npm.html b/deps/npm/html/doc/api/npm.html index 4b7edc2d27..2cc3b64482 100644 --- a/deps/npm/html/doc/api/npm.html +++ b/deps/npm/html/doc/api/npm.html @@ -10,9 +10,7 @@ <div id="wrapper"> <h1><a href="../api/npm.html">npm</a></h1> <p>node package manager</p> - -<h2 id="SYNOPSIS">SYNOPSIS</h2> - +<h2 id="synopsis">SYNOPSIS</h2> <pre><code>var npm = require("npm") npm.load([configObject, ]function (er, npm) { // use the npm object, now that it's loaded. @@ -23,18 +21,13 @@ npm.load([configObject, ]function (er, npm) { console.log("prefix = %s", npm.prefix) npm.commands.install(["package"], cb) -})</code></pre> - -<h2 id="VERSION">VERSION</h2> - -<p>1.4.9</p> - -<h2 id="DESCRIPTION">DESCRIPTION</h2> - +}) +</code></pre><h2 id="version">VERSION</h2> +<p>1.4.10</p> +<h2 id="description">DESCRIPTION</h2> <p>This is the API documentation for npm. To find documentation of the command line client, see <code><a href="../cli/npm.html">npm(1)</a></code>.</p> - <p>Prior to using npm's commands, <code>npm.load()</code> must be called. If you provide <code>configObject</code> as an object hash of top-level configs, they override the values stored in the various config @@ -42,58 +35,70 @@ locations. In the npm command line client, this set of configs is parsed from the command line options. Additional configuration params are loaded from two configuration files. See <code><a href="../cli/npm-config.html">npm-config(1)</a></code>, <code><a href="../misc/npm-config.html">npm-config(7)</a></code>, and <code><a href="../files/npmrc.html">npmrc(5)</a></code> for more information.</p> - <p>After that, each of the functions are accessible in the commands object: <code>npm.commands.<cmd></code>. See <code><a href="../misc/npm-index.html">npm-index(7)</a></code> for a list of all possible commands.</p> - <p>All commands on the command object take an <strong>array</strong> of positional argument <strong>strings</strong>. The last argument to any function is a callback. Some commands take other optional arguments.</p> - <p>Configs cannot currently be set on a per function basis, as each call to npm.config.set will change the value for <em>all</em> npm commands in that process.</p> - <p>To find API documentation for a specific command, run the <code>npm apihelp</code> command.</p> - -<h2 id="METHODS-AND-PROPERTIES">METHODS AND PROPERTIES</h2> - -<ul><li><p><code>npm.load(configs, cb)</code></p><p>Load the configuration params, and call the <code>cb</code> function once the -globalconfig and userconfig files have been loaded as well, or on -nextTick if they've already been loaded.</p></li><li><p><code>npm.config</code></p><p>An object for accessing npm configuration parameters.</p><ul><li><p><code>npm.config.get(key)</code></p></li><li><code>npm.config.set(key, val)</code></li><li><p><code>npm.config.del(key)</code></p></li></ul></li><li><p><code>npm.dir</code> or <code>npm.root</code></p><p>The <code>node_modules</code> directory where npm will operate.</p></li><li><p><code>npm.prefix</code></p><p>The prefix where npm is operating. (Most often the current working -directory.)</p></li><li><p><code>npm.cache</code></p><p>The place where npm keeps JSON and tarballs it fetches from the -registry (or uploads to the registry).</p></li><li><p><code>npm.tmp</code></p><p>npm's temporary working directory.</p></li><li><p><code>npm.deref</code></p><p>Get the "real" name for a command that has either an alias or -abbreviation.</p></li></ul> - -<h2 id="MAGIC">MAGIC</h2> - +<h2 id="methods-and-properties">METHODS AND PROPERTIES</h2> +<ul> +<li><p><code>npm.load(configs, cb)</code></p> +<p> Load the configuration params, and call the <code>cb</code> function once the + globalconfig and userconfig files have been loaded as well, or on + nextTick if they've already been loaded.</p> +</li> +<li><p><code>npm.config</code></p> +<p> An object for accessing npm configuration parameters.</p> +<ul> +<li><code>npm.config.get(key)</code></li> +<li><code>npm.config.set(key, val)</code></li> +<li><code>npm.config.del(key)</code></li> +</ul> +</li> +<li><p><code>npm.dir</code> or <code>npm.root</code></p> +<p> The <code>node_modules</code> directory where npm will operate.</p> +</li> +<li><p><code>npm.prefix</code></p> +<p> The prefix where npm is operating. (Most often the current working + directory.)</p> +</li> +<li><p><code>npm.cache</code></p> +<p> The place where npm keeps JSON and tarballs it fetches from the + registry (or uploads to the registry).</p> +</li> +<li><p><code>npm.tmp</code></p> +<p> npm's temporary working directory.</p> +</li> +<li><p><code>npm.deref</code></p> +<p> Get the "real" name for a command that has either an alias or + abbreviation.</p> +</li> +</ul> +<h2 id="magic">MAGIC</h2> <p>For each of the methods in the <code>npm.commands</code> hash, a method is added to the npm object, which takes a set of positional string arguments rather than an array and a callback.</p> - <p>If the last argument is a callback, then it will use the supplied callback. However, if no callback is provided, then it will print out the error or results.</p> - <p>For example, this would work in a node repl:</p> - <pre><code>> npm = require("npm") > npm.load() // wait a sec... -> npm.install("dnode", "express")</code></pre> - -<p>Note that that <em>won't</em> work in a node program, since the <code>install</code> +> npm.install("dnode", "express") +</code></pre><p>Note that that <em>won't</em> work in a node program, since the <code>install</code> method will get called before the configuration load is completed.</p> - -<h2 id="ABBREVS">ABBREVS</h2> - +<h2 id="abbrevs">ABBREVS</h2> <p>In order to support <code>npm ins foo</code> instead of <code>npm install foo</code>, the <code>npm.commands</code> object has a set of abbreviations as well as the full method names. Use the <code>npm.deref</code> method to find the real name.</p> - <p>For example:</p> - -<pre><code>var cmd = npm.deref("unp") // cmd === "unpublish"</code></pre> +<pre><code>var cmd = npm.deref("unp") // cmd === "unpublish" +</code></pre> </div> <table border=0 cellspacing=0 cellpadding=0 id=npmlogo> @@ -105,5 +110,5 @@ method names. Use the <code>npm.deref</code> method to find the real 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 — npm@1.4.9</p> +<p id="footer">npm — npm@1.4.10</p> |