summaryrefslogtreecommitdiff
path: root/deps/npm/doc
diff options
context:
space:
mode:
authorisaacs <i@izs.me>2012-03-02 09:31:24 -0800
committerisaacs <i@izs.me>2012-03-02 09:31:46 -0800
commit054127112ce335ceb4477a481e99e3fb2176b457 (patch)
tree22c5386ce5538f3db7996a6e71d30264617a66b8 /deps/npm/doc
parentedea94c332f07ed81ea7de9b93bbcec806c81544 (diff)
downloadnode-054127112ce335ceb4477a481e99e3fb2176b457.tar.gz
Upgrade npm to 1.1.3
* Update request to support HTTPS-over-HTTP proxy tunneling * Throw on undefined envs in config settings * Update which to 1.0.5 * Fix windows UNC busyloop in findPrefix * Bundle nested bundleDependencies properly * Alias adduser to add-user * Doc updates (Christian Howe, Henrik Hodne, Andrew Lunny) * ignore logfd/outfd streams in makeEnv() (Rod Vagg) * shrinkwrap: Behave properly with url-installed deps * install: Support --save with url install targets * Support installing naked tars or single-file modules from urls etc. * init: Don't add engines section * Don't run make clean on rebuild * Added missing unicode replacement (atomizer)
Diffstat (limited to 'deps/npm/doc')
-rw-r--r--deps/npm/doc/cli/changelog.md44
-rw-r--r--deps/npm/doc/cli/coding-style.md4
-rw-r--r--deps/npm/doc/cli/developers.md11
-rw-r--r--deps/npm/doc/cli/json.md13
-rw-r--r--deps/npm/doc/cli/scripts.md14
5 files changed, 84 insertions, 2 deletions
diff --git a/deps/npm/doc/cli/changelog.md b/deps/npm/doc/cli/changelog.md
index 0115405ca..7c3a124c4 100644
--- a/deps/npm/doc/cli/changelog.md
+++ b/deps/npm/doc/cli/changelog.md
@@ -3,6 +3,50 @@ npm-changelog(1) -- Changes
## HISTORY
+### 1.1.3
+
+* Update request to support HTTPS-over-HTTP proxy tunneling
+* Throw on undefined envs in config settings
+* Update which to 1.0.5
+* Fix windows UNC busyloop in findPrefix
+* Bundle nested bundleDependencies properly
+* Alias adduser to add-user
+* Doc updates (Christian Howe, Henrik Hodne, Andrew Lunny)
+* ignore logfd/outfd streams in makeEnv() (Rod Vagg)
+* shrinkwrap: Behave properly with url-installed deps
+* install: Support --save with url install targets
+* Support installing naked tars or single-file modules from urls etc.
+* init: Don't add engines section
+* Don't run make clean on rebuild
+* Added missing unicode replacement (atomizer)
+
+### 1.1.2
+
+Dave Pacheco (2):
+ add "npm shrinkwrap"
+
+Martin Cooper (1):
+ Fix #1753 Make a copy of the cached objects we'll modify.
+
+Tim Oxley (1):
+ correctly remove readme from default npm view command.
+
+Tyler Green (1):
+ fix #2187 set terminal columns to Infinity if 0
+
+isaacs (19):
+ update minimatch
+ update request
+ Experimental: single-file modules
+ Fix #2172 Don't remove global mans uninstalling local pkgs
+ Add --versions flag to show the version of node as well
+ Support --json flag for ls output
+ update request to 2.9.151
+
+### 1.1
+* Replace system tar dependency with a JS tar
+* Continue to refine
+
### 1.0
* Greatly simplified folder structure
* Install locally (bundle by default)
diff --git a/deps/npm/doc/cli/coding-style.md b/deps/npm/doc/cli/coding-style.md
index 5315c575c..42ac1d785 100644
--- a/deps/npm/doc/cli/coding-style.md
+++ b/deps/npm/doc/cli/coding-style.md
@@ -59,8 +59,8 @@ Don't use them except in four situations:
* `for (;;)` loops. They're actually required.
* null loops like: `while (something) ;` (But you'd better have a good
reason for doing that.)
-* case "foo": doSomething(); break
-* In front of a leading ( or [ at the start of the line.
+* `case "foo": doSomething(); break`
+* In front of a leading `(` or `[` at the start of the line.
This prevents the expression from being interpreted
as a function call or property access, respectively.
diff --git a/deps/npm/doc/cli/developers.md b/deps/npm/doc/cli/developers.md
index 9123f35a3..7ab905bfa 100644
--- a/deps/npm/doc/cli/developers.md
+++ b/deps/npm/doc/cli/developers.md
@@ -27,12 +27,23 @@ A package is:
* d) a `<name>@<version>` that is published on the registry with (c)
* e) a `<name>@<tag>` that points to (d)
* f) a `<name>` that has a "latest" tag satisfying (e)
+* g) a `git` url that, when cloned, results in (a).
Even if you never publish your package, you can still get a lot of
benefits of using npm if you just want to write a node program (a), and
perhaps if you also want to be able to easily install it elsewhere
after packing it up into a tarball (b).
+Git urls can be of the form:
+
+ git://github.com/user/project.git#commit-ish
+ git+ssh://user@hostname:project.git#commit-ish
+ git+http://user@hostname/project/blah.git#commit-ish
+ git+https://user@hostname/project/blah.git#commit-ish
+
+The `commit-ish` can be any tag, sha, or branch which can be supplied as
+an argument to `git checkout`. The default is `master`.
+
## The package.json File
You need to have a `package.json` file in the root of your project to do
diff --git a/deps/npm/doc/cli/json.md b/deps/npm/doc/cli/json.md
index 5f6e7ef62..0ded87894 100644
--- a/deps/npm/doc/cli/json.md
+++ b/deps/npm/doc/cli/json.md
@@ -332,6 +332,7 @@ is a semver compatible version identifier.
* `""` (just an empty string) Same as `*`
* `version1 - version2` Same as `>=version1 <=version2`.
* `range1 || range2` Passes if either range1 or range2 are satisfied.
+* `git...` See 'Git URLs as Dependencies' below
For example, these are all valid:
@@ -387,6 +388,18 @@ of a version range.
This tarball will be downloaded and installed locally to your package at
install time.
+### Git URLs as Dependencies
+
+Git urls can be of the form:
+
+ git://github.com/user/project.git#commit-ish
+ git+ssh://user@hostname:project.git#commit-ish
+ git+http://user@hostname/project/blah.git#commit-ish
+ git+https://user@hostname/project/blah.git#commit-ish
+
+The `commit-ish` can be any tag, sha, or branch which can be supplied as
+an argument to `git checkout`. The default is `master`.
+
## devDependencies
If someone is planning on downloading and using your module in their
diff --git a/deps/npm/doc/cli/scripts.md b/deps/npm/doc/cli/scripts.md
index 64b3ec41a..3d33a8391 100644
--- a/deps/npm/doc/cli/scripts.md
+++ b/deps/npm/doc/cli/scripts.md
@@ -62,6 +62,20 @@ Package scripts run in an environment where many pieces of information are
made available regarding the setup of npm and the current state of the
process.
+
+### path
+
+If you depend on modules that define executable scripts, like test suites,
+then those executables will be added to the `PATH` for executing the scripts.
+So, if your package.json has this:
+
+ { "name" : "foo"
+ , "dependencies" : { "bar" : "0.1.x" }
+ , "scripts": { "start" : "bar ./test" } }
+
+then you could run `npm start` to execute the `bar` script, which is exported
+into the `node_modules/.bin` directory on `npm install`.
+
### package.json vars
The package.json fields are tacked onto the `npm_package_` prefix. So, for