npm 1.1.0-alpha-5

Fix #2186 First part of #2207
nodejs · Dec 1, 2011 · 6176461 · 6176461
1 parent d5feb1c
commit 6176461
Show file tree

Hide file tree

Showing 253 changed files with 724 additions and 968 deletions.
diff --git a/deps/npm/.gitmodules b/deps/npm/.gitmodules
@@ -33,7 +33,7 @@
 	url = https://github.com/isaacs/node-which.git
 [submodule "node_modules/request"]
 	path = node_modules/request
-	url = https://github.com/isaacs/request.git
+	url = https://github.com/mikeal/request.git
 [submodule "node_modules/tar"]
 	path = node_modules/tar
 	url = git://github.com/isaacs/node-tar.git

diff --git a/deps/npm/.npmignore b/deps/npm/.npmignore
@@ -9,3 +9,4 @@ node_modules/ronn
 node_modules/.bin
 npm-debug.log
 ./npmrc
+.gitignore
diff --git a/deps/npm/CHANGES b/deps/npm/CHANGES
diff --git a/deps/npm/README.md b/deps/npm/README.md
@@ -9,91 +9,75 @@ Much more info available via `npm help` once it's installed.
 
 ## IMPORTANT
 
-**You need node v0.4 or higher to run this program.**
+**You need node v0.6 or higher to run this program.**
 
 To install an old **and unsupported** version of npm that works on node 0.3
 and prior, clone the git repo and dig through the old tags and branches.
 
-## Simple Install (Unix only, sorry)
+## Super Easy Install
 
-To install npm with one command, do this:
-
-    curl http://npmjs.org/install.sh | sh
+npm comes with node now.
 
-To skip the npm 0.x cleanup, do this:
-
-    curl http://npmjs.org/install.sh | clean=no sh
+### Windows Computers
 
-To say "yes" to the 0.x cleanup, but skip the prompt:
+Get the MSI.  npm is in it.
 
-    curl http://npmjs.org/install.sh | clean=yes sh
+### Apple Macintosh Computers
 
-If you get permission errors, see the section below, entitled
-"Permission Errors on Installation".
+Get the pkg.  npm is in it.
 
-## Installing on Windows -- Experimental
+### Other Sorts of Unices
 
-Yes, this sucks.  A convenient one-liner is coming soon.
+Run `make install`.  npm will be installed with node.
 
-### Step 1: Drop the node.exe somewhere
+If you want a more fancy pants install (a different version, customized
+paths, etc.) then read on.
 
-You will probably need the latest version of node, **at least** version
-`0.5.8` or higher.  You can get it from
-<http://nodejs.org/dist/v0.5.8/node.exe>.
+## Fancy Install (Unix)
 
-### Step 2 (optional): Update the %PATH% environment variable
+To install npm with one command, do this:
 
-Update your `%PATH%` environment variable in System Properties:
-Advanced: Environment, so that it includes the `bin` folder you chose.
-The entries are separated by semicolons.
+    curl http://npmjs.org/install.sh | sh
 
-You *may* be able to do this from the command line using `set` and
-`setx`.  `cd` into the `bin` folder you created in step 1, and do this:
+To skip the npm 0.x cleanup, do this:
 
-    set path=%PATH%;%CD%
-    setx path "%PATH%"
+    curl http://npmjs.org/install.sh | clean=no sh
 
-This will have the added advantage that you'll be able to simply type
-`npm` or `node` in any project folder to access those commands.
+To say "yes" to the 0.x cleanup, but skip the prompt:
 
-If you decide not to update the PATH, and put the node.exe file in
-`C:\node\node.exe`, then the npm executable will end up `C:\node\npm.cmd`,
-and you'll have to type `C:\node\npm <command>` to use it.
+    curl http://npmjs.org/install.sh | clean=yes sh
 
-### Step 3: Install git
+If you get permission errors, you'll need to **run** the script as root.
+(Note, just putting `sudo` in front of the `curl` will **fetch** the script
+as root.)
 
-If you don't already have git,
-[install it](https://git.wiki.kernel.org/index.php/MSysGit:InstallMSysGit).
+### Slightly Fancier
 
-Run `git --version` to make sure that it's at least version 1.7.6.
+You can set any npm configuration params with that script:
 
-### Step 4: install npm
+    curl http://npmjs.org/install.sh | npm_config_prefix=/some/path sh
 
-Lastly, **after** node.exe, git, and your %PATH% have *all* been set up
-properly, install npm itself:
+Or, you can run it in uber-debuggery mode:
 
-    git config --system http.sslcainfo /bin/curl-ca-bundle.crt
-    git clone --recursive git://github.com/isaacs/npm.git
-    cd npm
-    node cli.js install npm -gf
+    curl http://npmjs.org/install.sh | npm_debug=1 sh
 
-## Permission Errors (`EACCES` or `EACCESS`) on Installation
+### Even Fancier
 
-On Windows, you may need to run the command prompt in elevated
-permission mode.  (Right-click on cmd.exe, Run as Administrator.)
+Get the code with git.  Use `make` to build the docs and do other stuff.
+If you plan on hacking on npm, `make link` is your friend.
 
-On Unix, you may need to run as root, or use `sudo`.
+If you've got the npm source code, you can also semi-permanently set
+arbitrary config keys using the `./configure --key=val ...`, and then
+run npm commands by doing `node cli.js <cmd> <args>`.  (This is helpful
+for testing, or running stuff without actually installing npm itself.)
 
-**Note**: You would need to `sudo` the `sh`, **not** the `curl`.  Fetching
-stuff from the internet typically doesn't require elevated permissions.
-Running it might.
+## Fancy Windows Install
 
-I highly recommend that you first download the file, and make sure that
-it is what you expect, and *then* run it.
+You can download a zip file from <http://npmjs.org/dist/>, and unpack it
+in the same folder where node.exe lives.
 
-    curl -O http://npmjs.org/install.sh
-    # inspect file..
-    sudo sh install.sh
+If that's not fancy enough for you, then you can fetch the code with
+git, and mess with it directly.
 
 ## Installing on Cygwin
 
@@ -116,12 +100,6 @@ terminal, then you've already got the code.  Just do:
 
 and npm will install itself.
 
-If you don't have make, and don't have curl or git, and ALL you have is
-this code and node, you can probably do this:
-
-    git submodule update --init --recursive
-    sudo node ./cli.js install -g
-
 Note that github tarballs **do not contain submodules**, so
 those won't work.  You'll have to also fetch the appropriate submodules
 listed in the .gitmodules file.
@@ -218,8 +196,7 @@ help config` to learn about all the options you can set there.
 ## More Docs
 
 Check out the [docs](http://npmjs.org/doc/),
-especially the
-[faq](http://npmjs.org/doc/faq.html).
+especially the [faq](http://npmjs.org/doc/faq.html).
 
 You can use the `npm help` command to read any of them.
 
@@ -266,6 +243,21 @@ process for published modules.
 
 If this concerns you, inspect the source before using packages.
 
+## BUGS
+
+When you find issues, please report them:
+
+* web:
+  <http://github.com/isaacs/npm/issues>
+* email:
+  <npm-@googlegroups.com>
+
+Be sure to include *all* of the output from the npm command that didn't work
+as expected.  The `npm-debug.log` file is also helpful to provide.
+
+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.
+
 ## SEE ALSO
 
 * npm(1)

diff --git a/deps/npm/doc/api/author.md b/deps/npm/doc/api/author.md
diff --git a/deps/npm/doc/api/find.md b/deps/npm/doc/api/find.md
diff --git a/deps/npm/doc/api/get.md b/deps/npm/doc/api/get.md
diff --git a/deps/npm/doc/api/home.md b/deps/npm/doc/api/home.md
diff --git a/deps/npm/doc/api/list.md b/deps/npm/doc/api/list.md
diff --git a/deps/npm/doc/api/ln.md b/deps/npm/doc/api/ln.md
diff --git a/deps/npm/doc/api/rm.md b/deps/npm/doc/api/rm.md
diff --git a/deps/npm/doc/api/set.md b/deps/npm/doc/api/set.md
diff --git a/deps/npm/doc/cli/author.md b/deps/npm/doc/cli/author.md
diff --git a/deps/npm/doc/cli/config.md b/deps/npm/doc/cli/config.md
@@ -212,7 +212,7 @@ See also the `strict-ssl` config.
 
 ### cache
 
-* Default: Windows: `~/npm-cache`, Posix: `~/.npm`
+* Default: Windows: `%APPDATA%\npm-cache`, Posix: `~/.npm`
 * Type: path
 
 The location of npm's cache directory.  See `npm-cache(1)`
@@ -474,6 +474,18 @@ Set to true to run in "production" mode.
    local `npm install` without any arguments.
 2. Set the NODE_ENV="production" for lifecycle scripts.
 
+### proprietary-attribs
+
+* Default: true
+* Type: Boolean
+
+Whether or not to include proprietary extended attributes in the
+tarballs created by npm.
+
+Unless you are expecting to unpack package tarballs with something other
+than npm -- particularly a very outdated tar implementation -- leave
+this as true.
+
 ### proxy
 
 * Default: `HTTP_PROXY` or `http_proxy` environment variable, or null

diff --git a/deps/npm/doc/cli/find.md b/deps/npm/doc/cli/find.md
diff --git a/deps/npm/doc/cli/get.md b/deps/npm/doc/cli/get.md
diff --git a/deps/npm/doc/cli/global.md b/deps/npm/doc/cli/global.md
diff --git a/deps/npm/doc/cli/home.md b/deps/npm/doc/cli/home.md
diff --git a/deps/npm/doc/cli/ln.md b/deps/npm/doc/cli/ln.md
diff --git a/deps/npm/doc/cli/ls.md b/deps/npm/doc/cli/ls.md
diff --git a/deps/npm/doc/cli/registry.md b/deps/npm/doc/cli/registry.md
@@ -13,9 +13,9 @@ account information.
 
 The official public npm registry is at <http://registry.npmjs.org/>.  It
 is powered by a CouchDB database at
-<http://isaacs.couchone.com/registry>.  The code for the couchapp is
+<http://isaacs.iriscouch.com/registry>.  The code for the couchapp is
 available at <http://github.com/isaacs/npmjs.org>.  npm user accounts
-are CouchDB users, stored in the <http://isaacs.couchone.com/_users>
+are CouchDB users, stored in the <http://isaacs.iriscouch.com/_users>
 database.
 
 The registry URL is supplied by the `registry` config parameter.  See

diff --git a/deps/npm/doc/cli/rm.md b/deps/npm/doc/cli/rm.md
diff --git a/deps/npm/doc/cli/set.md b/deps/npm/doc/cli/set.md
diff --git a/deps/npm/html/api/author.html b/deps/npm/html/api/author.html
@@ -34,7 +34,7 @@ <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <ul><li><a href="../api/publish.html">publish(3)</a></li><li><a href="../doc/registry.html">registry(1)</a></li></ul>
 </div>
-<p id="footer">author &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">author &mdash; npm@1.1.0-alpha-3</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/bin.html b/deps/npm/html/api/bin.html
@@ -19,7 +19,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 <p>This function should not be used programmatically.  Instead, just refer
 to the <code>npm.bin</code> member.</p>
 </div>
-<p id="footer">bin &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">bin &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/bugs.html b/deps/npm/html/api/bugs.html
@@ -25,7 +25,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 <p>This command will launch a browser, so this command may not be the most
 friendly for programmatic use.</p>
 </div>
-<p id="footer">bugs &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">bugs &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/commands.html b/deps/npm/html/api/commands.html
@@ -28,7 +28,7 @@ <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <ul><li><a href="../doc/index.html">index(1)</a></li></ul>
 </div>
-<p id="footer">commands &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">commands &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/config.html b/deps/npm/html/api/config.html
@@ -33,7 +33,7 @@ <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <ul><li><a href="../api/npm.html">npm(3)</a></li></ul>
 </div>
-<p id="footer">config &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">config &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/deprecate.html b/deps/npm/html/api/deprecate.html
@@ -30,7 +30,7 @@ <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <ul><li><a href="../api/publish.html">publish(3)</a></li><li><a href="../api/unpublish.html">unpublish(3)</a></li><li><a href="../doc/registry.html">registry(1)</a></li></ul>
 </div>
-<p id="footer">deprecate &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">deprecate &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/docs.html b/deps/npm/html/api/docs.html
@@ -25,7 +25,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 <p>This command will launch a browser, so this command may not be the most
 friendly for programmatic use.</p>
 </div>
-<p id="footer">docs &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">docs &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/edit.html b/deps/npm/html/api/edit.html
@@ -30,7 +30,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 <p>Since this command opens an editor in a new process, be careful about where
 and how this is used.</p>
 </div>
-<p id="footer">edit &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">edit &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/explore.html b/deps/npm/html/api/explore.html
@@ -24,7 +24,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 
 <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>
-<p id="footer">explore &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">explore &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/find.html b/deps/npm/html/api/find.html
@@ -53,7 +53,7 @@ <h3 id="global">global</h3>
 This means that if a submodule a same dependency as a parent module, then the
 dependency will only be output once.</p>
 </div>
-<p id="footer">find &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">find &mdash; npm@1.1.0-alpha-3</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/get.html b/deps/npm/html/api/get.html
@@ -33,7 +33,7 @@ <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <ul><li><a href="../api/npm.html">npm(3)</a></li></ul>
 </div>
-<p id="footer">get &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">get &mdash; npm@1.1.0-alpha-3</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/help-search.html b/deps/npm/html/api/help-search.html
@@ -32,7 +32,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 
 <p>The silent parameter is not neccessary not used, but it may in the future.</p>
 </div>
-<p id="footer">help-search &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">help-search &mdash; npm@1.1.0-alpha-5</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")

diff --git a/deps/npm/html/api/home.html b/deps/npm/html/api/home.html
@@ -25,7 +25,7 @@ <h2 id="DESCRIPTION">DESCRIPTION</h2>
 <p>This command will launch a browser, so this command may not be the most
 friendly for programmatic use.</p>
 </div>
-<p id="footer">home &mdash; npm@1.1.0-alpha-2</p>
+<p id="footer">home &mdash; npm@1.1.0-alpha-3</p>
 <script>
 ;(function () {
 var wrapper = document.getElementById("wrapper")