diff options
author | isaacs <i@izs.me> | 2013-02-15 10:49:16 -0800 |
---|---|---|
committer | isaacs <i@izs.me> | 2013-02-15 10:49:30 -0800 |
commit | 73be4608d9d7679a1b0233f64c7b60c329ccd235 (patch) | |
tree | e9c9af7a79b4156e7f6dc56b3150eadad24ca0b8 /deps/npm/man/man1 | |
parent | 987338fe31b39b7f57a8f5645593425722ba40af (diff) | |
download | node-new-73be4608d9d7679a1b0233f64c7b60c329ccd235.tar.gz |
npm: Upgrade to v1.2.11
Diffstat (limited to 'deps/npm/man/man1')
-rw-r--r-- | deps/npm/man/man1/config.1 | 13 | ||||
-rw-r--r-- | deps/npm/man/man1/faq.1 | 50 | ||||
-rw-r--r-- | deps/npm/man/man1/index.1 | 3 | ||||
-rw-r--r-- | deps/npm/man/man1/ls.1 | 2 | ||||
-rw-r--r-- | deps/npm/man/man1/npm.1 | 2 | ||||
-rw-r--r-- | deps/npm/man/man1/stars.1 | 40 | ||||
-rw-r--r-- | deps/npm/man/man1/update.1 | 6 | ||||
-rw-r--r-- | deps/npm/man/man1/version.1 | 16 |
8 files changed, 127 insertions, 5 deletions
diff --git a/deps/npm/man/man1/config.1 b/deps/npm/man/man1/config.1 index 0269570bc3..df6167b9e3 100644 --- a/deps/npm/man/man1/config.1 +++ b/deps/npm/man/man1/config.1 @@ -40,10 +40,21 @@ work the same\. . .P This file is an ini\-file formatted list of \fBkey = value\fR parameters\. +Environment variables can be replaced using \fB${VARIABLE_NAME}\fR\|\. For example: +. +.IP "" 4 +. +.nf +prefix = ${HOME}/\.npm\-packages +. +.fi +. +.IP "" 0 . .SS "Global config file" \fB$PREFIX/etc/npmrc\fR (or the \fBglobalconfig\fR param, if set above): -This file is an ini\-file formatted list of \fBkey = value\fR parameters +This file is an ini\-file formatted list of \fBkey = value\fR parameters\. +Environment variables can be replaced as above\. . .SS "Built\-in config file" \fBpath/to/npm/itself/npmrc\fR diff --git a/deps/npm/man/man1/faq.1 b/deps/npm/man/man1/faq.1 index 256e0ba41d..bc31a415ef 100644 --- a/deps/npm/man/man1/faq.1 +++ b/deps/npm/man/man1/faq.1 @@ -89,6 +89,56 @@ Write your own package manager, then\. It\'s not that hard\. .P npm will not help you do something that is known to be a bad idea\. . +.SH "<code>"node_modules"</code>" +No\. This will never happen\. This question comes up sometimes, +because it seems silly from the outside that npm couldn\'t just be +configured to put stuff somewhere else, and then npm could load them +from there\. It\'s an arbitrary spelling choice, right? What\'s the bg +deal? +. +.P +At the time of this writing, the string \fB\'node_modules\'\fR appears 151 +times in 53 separate files in npm and node core (excluding tests and +documentation)\. +. +.P +Some of these references are in node\'s built\-in module loader\. Since +npm is not involved \fBat all\fR at run\-time, node itself would have to +be configured to know where you\'ve decided to stick stuff\. Complexity +hurdle #1\. Since the Node module system is locked, this cannot be +changed, and is enough to kill this request\. But I\'ll continue, in +deference to your deity\'s delicate feelings regarding spelling\. +. +.P +Many of the others are in dependencies that npm uses, which are not +necessarily tightly coupled to npm (in the sense that they do not read +npm\'s configuration files, etc\.) Each of these would have to be +configured to take the name of the \fBnode_modules\fR folder as a +parameter\. Complexity hurdle #2\. +. +.P +Furthermore, npm has the ability to "bundle" dependencies by adding +the dep names to the \fB"bundledDependencies"\fR list in package\.json, +which causes the folder to be included in the package tarball\. What +if the author of a module bundles its dependencies, and they use a +different spelling for \fBnode_modules\fR? npm would have to rename the +folder at publish time, and then be smart enough to unpack it using +your locally configured name\. Complexity hurdle #3\. +. +.P +Furthermore, what happens when you \fIchange\fR this name? Fine, it\'s +easy enough the first time, just rename the \fBnode_modules\fR folders to \fB\|\./blergyblerp/\fR or whatever name you choose\. But what about when you +change it again? npm doesn\'t currently track any state about past +configuration settings, so this would be rather difficult to do +properly\. It would have to track every previous value for this +config, and always accept any of them, or else yesterday\'s install may +be broken tomorrow\. Complexity hurdle #5\. +. +.P +Never going to happen\. The folder is named \fBnode_modules\fR\|\. It is +written indelibly in the Node Way, handed down from the ancient times +of Node 0\.3\. +. .SH "Should I check my " Mikeal Rogers answered this question very well: . diff --git a/deps/npm/man/man1/index.1 b/deps/npm/man/man1/index.1 index 2a6bcfe97c..ed6f1d92ce 100644 --- a/deps/npm/man/man1/index.1 +++ b/deps/npm/man/man1/index.1 @@ -147,6 +147,9 @@ .SH "npm help star" Mark your favorite packages . +.SH "npm help stars" + View packages marked as favorites +. .SH "npm help start" Start a package . diff --git a/deps/npm/man/man1/ls.1 b/deps/npm/man/man1/ls.1 index 1e224cde53..fadb701f25 100644 --- a/deps/npm/man/man1/ls.1 +++ b/deps/npm/man/man1/ls.1 @@ -29,7 +29,7 @@ For example, running \fBnpm ls promzard\fR in npm\'s source tree will show: .IP "" 4 . .nf -npm@1.2.10 /path/to/npm +npm@1.2.11 /path/to/npm └─┬ init\-package\-json@0\.0\.4 └── promzard@0\.1\.5 . diff --git a/deps/npm/man/man1/npm.1 b/deps/npm/man/man1/npm.1 index dd7de70828..b0bc36d8f3 100644 --- a/deps/npm/man/man1/npm.1 +++ b/deps/npm/man/man1/npm.1 @@ -14,7 +14,7 @@ npm <command> [args] .fi . .SH "VERSION" -1.2.10 +1.2.11 . .SH "DESCRIPTION" npm is the package manager for the Node JavaScript platform\. It puts diff --git a/deps/npm/man/man1/stars.1 b/deps/npm/man/man1/stars.1 new file mode 100644 index 0000000000..fe0095d5b9 --- /dev/null +++ b/deps/npm/man/man1/stars.1 @@ -0,0 +1,40 @@ +.\" Generated with Ronnjs 0.3.8 +.\" http://github.com/kapouer/ronnjs/ +. +.TH "NPM\-STARS" "1" "February 2013" "" "" +. +.SH "NAME" +\fBnpm-stars\fR \-\- View packages marked as favorites +. +.SH "SYNOPSIS" +. +.nf +npm stars +npm stars [username] +. +.fi +. +.SH "DESCRIPTION" +If you have starred a lot of neat things and want to find them again +quickly this command lets you do just that\. +. +.P +You may also want to see your friend\'s favorite packages, in this case +you will most certainly enjoy this command\. +. +.SH "SEE ALSO" +. +.IP "\(bu" 4 +npm help star +. +.IP "\(bu" 4 +npm help view +. +.IP "\(bu" 4 +npm help whoami +. +.IP "\(bu" 4 +npm help adduser +. +.IP "" 0 + diff --git a/deps/npm/man/man1/update.1 b/deps/npm/man/man1/update.1 index 58a073b482..e935863cbd 100644 --- a/deps/npm/man/man1/update.1 +++ b/deps/npm/man/man1/update.1 @@ -9,7 +9,7 @@ .SH "SYNOPSIS" . .nf -npm update [<name> [<name> \.\.\.]] +npm update [\-g] [<name> [<name> \.\.\.]] . .fi . @@ -20,6 +20,10 @@ This command will update all the packages listed to the latest version .P It will also install missing packages\. . +.P +If the \fB\-g\fR flag is specified, this command will update globally installed packages\. +If no package name is specified, all packages in the specified location (global or local) will be updated\. +. .SH "SEE ALSO" . .IP "\(bu" 4 diff --git a/deps/npm/man/man1/version.1 b/deps/npm/man/man1/version.1 index 227aadebf3..85dd3846cf 100644 --- a/deps/npm/man/man1/version.1 +++ b/deps/npm/man/man1/version.1 @@ -44,7 +44,21 @@ npm version patch \-m "Upgrade to %s for reasons" .P If the \fBsign\-git\-tag\fR config is set, then the tag will be signed using the \fB\-s\fR flag to git\. Note that you must have a default GPG key set up -in your git config for this to work properly\. +in your git config for this to work properly\. For example: +. +.IP "" 4 +. +.nf +$ npm config set sign\-git\-tag true +$ npm version patch +You need a passphrase to unlock the secret key for +user: "isaacs (http://blog\.izs\.me/) <i@izs\.me>" +2048\-bit RSA key, ID 6C481CF6, created 2010\-08\-31 +Enter passphrase: +. +.fi +. +.IP "" 0 . .SH "SEE ALSO" . |