diff options
author | isaacs <i@izs.me> | 2010-05-03 23:30:30 +0400 |
---|---|---|
committer | isaacs <i@izs.me> | 2010-05-03 23:30:30 +0400 |
commit | b70b2a09fa76f1cc3e3f9da7dd4f48ac073d6d0a (patch) | |
tree | a1e40a1473c3b5db3efea8ad338c966fac605400 /man/config.1 | |
parent | a3dec1abdf971e83377ff167382c56fe26f6c8d6 (diff) |
Add built documentation to project, so that the install doesn't require ronn
Diffstat (limited to 'man/config.1')
-rw-r--r-- | man/config.1 | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/man/config.1 b/man/config.1 new file mode 100644 index 000000000..ec261b635 --- /dev/null +++ b/man/config.1 @@ -0,0 +1,107 @@ +.\" generated with Ronn/v0.4.1 +.\" http://github.com/rtomayko/ronn/ +. +.TH "NPM\-CONFIG" "1" "April 2010" "" "" +. +.SH "NAME" +\fBnpm\-config\fR \-\- Manage the npm configuration file +. +.SH "SYNOPSIS" +. +.nf +npm config set <key> <value> +npm config get <key> +npm config delete <key> +npm config list +. +.fi +. +.SH "DESCRIPTION" +The config command is a way to interact with the \fB.npmrc\fR file. This file is a +JSON encoded list of values that npm is concerned with. The first time you run +npm, it will create a conf file filled with default values. +. +.P +On exit, the current state of the config is always saved, so that any changes +will be recorded. You may safely modify the file (as long as it's still +parseable JSON), but it is safer to use the npm config commands. +. +.SH "Sub\-commands" +Config supports the following sub\-commands: +. +.SS "set" +. +.nf +npm config set key value +. +.fi +. +.P +Sets the config key to the value. +. +.SS "get" +. +.nf +npm config get key +. +.fi +. +.P +Echo the config value to stdout. (NOTE: All the other npm logging is done to +stderr, so pipes should work properly, and you can do \fBnpm get key 2>/dev/null\fR +to print out JUST the config value.) +. +.SS "list" +. +.nf +npm config list +. +.fi +. +.P +Show all the config settings. +. +.P +\fBFIXME\fR: Prints to stderr, but should really be stdout, since the log is what +you're after. +. +.SS "delete" +. +.nf +npm config delete key +. +.fi +. +.P +Deletes the key from the configuration file. +. +.SH "Config File Settings" +. +.SS "auto\-activate" +Default: true +. +.P +Automatically activate a package after installation, if there is not an active +version already. Set to "always" to always activate when installing. +. +.SS "root" +Default: ~/.node_libraries +. +.P +The root folder where packages are installed and npm keeps its data. +. +.SS "registry" +Default: http://registry.npmjs.org/ +. +.P +The base URL of the npm package registry. +. +.SS "auth" +A base\-64 encoded "user:pass" pair. +. +.P +\fBFIXME\fR: This is not encoded in any kind of security sense. It's just base\-64 +encoded strictly so that it can be sent along the wire with HTTP Basic +authentication. An upcoming version of npm will encrypt this and save it back +to the registry as \fBauth\-crypt\fR, which will be quite a bit more secure. Until +then, use a unique password that you don't mind being compromised. |