summaryrefslogtreecommitdiff
path: root/deps/npm/doc
diff options
context:
space:
mode:
authorisaacs <i@izs.me>2013-05-14 14:37:59 -0700
committerisaacs <i@izs.me>2013-05-14 14:37:59 -0700
commitf7b10f5445248981a39f0f82e10fca7234fca08a (patch)
tree839a30d65dcdc93e3e7ddaebe2666eb1c27fb306 /deps/npm/doc
parentca38def146c2255503103159677df40c169ccefa (diff)
downloadnode-new-f7b10f5445248981a39f0f82e10fca7234fca08a.tar.gz
npm: Upgrade to 1.2.21
Diffstat (limited to 'deps/npm/doc')
-rw-r--r--deps/npm/doc/cli/bugs.md2
-rw-r--r--deps/npm/doc/cli/config.md2
-rw-r--r--deps/npm/doc/cli/docs.md2
-rw-r--r--deps/npm/doc/cli/faq.md15
-rw-r--r--deps/npm/doc/cli/folders.md20
-rw-r--r--deps/npm/doc/cli/link.md3
-rw-r--r--deps/npm/doc/cli/shrinkwrap.md3
7 files changed, 29 insertions, 18 deletions
diff --git a/deps/npm/doc/cli/bugs.md b/deps/npm/doc/cli/bugs.md
index 2e57cc891b..45ee84b58f 100644
--- a/deps/npm/doc/cli/bugs.md
+++ b/deps/npm/doc/cli/bugs.md
@@ -15,7 +15,7 @@ config param.
### browser
-* Default: OS X: `"open"`, others: `"google-chrome"`
+* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
* Type: String
The browser that is called by the `npm bugs` command to open websites.
diff --git a/deps/npm/doc/cli/config.md b/deps/npm/doc/cli/config.md
index e48957ba82..fa3e7bcc27 100644
--- a/deps/npm/doc/cli/config.md
+++ b/deps/npm/doc/cli/config.md
@@ -185,7 +185,7 @@ ostensibly Unix systems.
### browser
-* Default: OS X: `"open"`, others: `"google-chrome"`
+* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
* Type: String
The browser that is called by the `npm docs` command to open websites.
diff --git a/deps/npm/doc/cli/docs.md b/deps/npm/doc/cli/docs.md
index 26b2455dd8..28fa49193b 100644
--- a/deps/npm/doc/cli/docs.md
+++ b/deps/npm/doc/cli/docs.md
@@ -16,7 +16,7 @@ config param.
### browser
-* Default: OS X: `"open"`, others: `"google-chrome"`
+* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
* Type: String
The browser that is called by the `npm docs` command to open websites.
diff --git a/deps/npm/doc/cli/faq.md b/deps/npm/doc/cli/faq.md
index 518fbef120..05b2cd98ec 100644
--- a/deps/npm/doc/cli/faq.md
+++ b/deps/npm/doc/cli/faq.md
@@ -221,11 +221,18 @@ an argument to `git checkout`. The default is `master`.
## How do I install node with npm?
-You don't. Try one of these:
+You don't. Try one of these node version managers:
-* <https://github.com/isaacs/nave>
-* <https://github.com/visionmedia/n>
-* <https://github.com/creationix/nvm>
+Unix:
+
+* <http://github.com/isaacs/nave>
+* <http://github.com/visionmedia/n>
+* <http://github.com/creationix/nvm>
+
+Windows:
+
+* <http://github.com/marcelklehr/nodist>
+* <https://github.com/hakobera/nvmw>
## How can I use npm for development?
diff --git a/deps/npm/doc/cli/folders.md b/deps/npm/doc/cli/folders.md
index 20358612ad..04fc13cfb1 100644
--- a/deps/npm/doc/cli/folders.md
+++ b/deps/npm/doc/cli/folders.md
@@ -157,21 +157,21 @@ In this case, we might expect a folder structure like this:
+-- node_modules
+-- blerg (1.2.5) <---[A]
+-- bar (1.2.3) <---[B]
- | +-- node_modules
- | | `-- baz (2.0.2) <---[C]
- | | `-- node_modules
- | | `-- quux (3.2.0)
- | `-- asdf (2.3.4)
+ | `-- node_modules
+ | +-- baz (2.0.2) <---[C]
+ | | `-- node_modules
+ | | `-- quux (3.2.0)
+ | `-- asdf (2.3.4)
`-- baz (1.2.3) <---[D]
`-- node_modules
`-- quux (3.2.0) <---[E]
-Since foo depends directly on bar@1.2.3 and baz@1.2.3, those are
+Since foo depends directly on `bar@1.2.3` and `baz@1.2.3`, those are
installed in foo's `node_modules` folder.
Even though the latest copy of blerg is 1.3.7, foo has a specific
dependency on version 1.2.5. So, that gets installed at [A]. Since the
-parent installation of blerg satisfie's bar's dependency on blerg@1.x,
+parent installation of blerg satisfies bar's dependency on `blerg@1.x`,
it does not install another copy under [B].
Bar [B] also has dependencies on baz and asdf, so those are installed in
@@ -179,11 +179,11 @@ bar's `node_modules` folder. Because it depends on `baz@2.x`, it cannot
re-use the `baz@1.2.3` installed in the parent `node_modules` folder [D],
and must install its own copy [C].
-Underneath bar, the `baz->quux->bar` dependency creates a cycle.
-However, because `bar` is already in `quux`'s ancestry [B], it does not
+Underneath bar, the `baz -> quux -> bar` dependency creates a cycle.
+However, because bar is already in quux's ancestry [B], it does not
unpack another copy of bar into that folder.
-Underneath `foo->baz` [D], quux's [E] folder tree is empty, because its
+Underneath `foo -> baz` [D], quux's [E] folder tree is empty, because its
dependency on bar is satisfied by the parent folder copy installed at [B].
For a graphical breakdown of what is installed where, use `npm ls`.
diff --git a/deps/npm/doc/cli/link.md b/deps/npm/doc/cli/link.md
index dd54792e29..4e4ef799b3 100644
--- a/deps/npm/doc/cli/link.md
+++ b/deps/npm/doc/cli/link.md
@@ -16,6 +16,9 @@ symbolic link from `prefix/package-name` to the current folder.
Next, in some other location, `npm link package-name` will create a
symlink from the local `node_modules` folder to the global symlink.
+Note that `package-name` is taken from `package.json` ,
+not from directory name.
+
When creating tarballs for `npm publish`, the linked packages are
"snapshotted" to their current state by resolving the symbolic links.
diff --git a/deps/npm/doc/cli/shrinkwrap.md b/deps/npm/doc/cli/shrinkwrap.md
index 3b60b13f7f..9af16f7075 100644
--- a/deps/npm/doc/cli/shrinkwrap.md
+++ b/deps/npm/doc/cli/shrinkwrap.md
@@ -9,7 +9,8 @@ npm-shrinkwrap(1) -- Lock down dependency versions
This command locks down the versions of a package's dependencies so that you can
control exactly which versions of each dependency will be used when your package
-is installed.
+is installed. The "package.json" file is still required if you want to use "npm
+install".
By default, "npm install" recursively installs the target's dependencies (as
specified in package.json), choosing the latest available version that satisfies