Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/npm/cli.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorisaacs <i@izs.me>2010-05-03 23:30:30 +0400
committerisaacs <i@izs.me>2010-05-03 23:30:30 +0400
commitb70b2a09fa76f1cc3e3f9da7dd4f48ac073d6d0a (patch)
treea1e40a1473c3b5db3efea8ad338c966fac605400 /man/config.1
parenta3dec1abdf971e83377ff167382c56fe26f6c8d6 (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.1107
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.