summaryrefslogtreecommitdiff
path: root/deps/npm/man/man7/npm-config.7
diff options
context:
space:
mode:
Diffstat (limited to 'deps/npm/man/man7/npm-config.7')
-rw-r--r--deps/npm/man/man7/npm-config.728
1 files changed, 22 insertions, 6 deletions
diff --git a/deps/npm/man/man7/npm-config.7 b/deps/npm/man/man7/npm-config.7
index 7af1f90f7c..07ab671f40 100644
--- a/deps/npm/man/man7/npm-config.7
+++ b/deps/npm/man/man7/npm-config.7
@@ -1,4 +1,4 @@
-.TH "NPM\-CONFIG" "7" "June 2017" "" ""
+.TH "NPM\-CONFIG" "7" "July 2017" "" ""
.SH "NAME"
\fBnpm-config\fR \- More than you probably want to know about npm configuration
.SH DESCRIPTION
@@ -8,8 +8,14 @@ npm gets its configuration values from the following sources, sorted by priority
.P
Putting \fB\-\-foo bar\fP on the command line sets the \fBfoo\fP configuration
parameter to \fB"bar"\fP\|\. A \fB\-\-\fP argument tells the cli parser to stop
-reading flags\. A \fB\-\-flag\fP parameter that is at the \fIend\fR of the
-command will be given the value of \fBtrue\fP\|\.
+reading flags\. Using \fB\-\-flag\fP without specifying any value will set
+the value to \fBtrue\fP\|\.
+.P
+Example: \fB\-\-flag1 \-\-flag2\fP will set both configuration parameters
+to \fBtrue\fP, while \fB\-\-flag1 \-\-flag2 bar\fP will set \fBflag1\fP to \fBtrue\fP,
+and \fBflag2\fP to \fBbar\fP\|\. Finally, \fB\-\-flag1 \-\-flag2 \-\- bar\fP will set
+both configuration parameters to \fBtrue\fP, and the \fBbar\fP is taken
+as a command argument\.
.SS Environment Variables
.P
Any environment variables that start with \fBnpm_config_\fP will be
@@ -19,7 +25,7 @@ configuration parameter to \fBbar\fP\|\. Any environment configurations that
are not given a value will be given the value of \fBtrue\fP\|\. Config
values are case\-insensitive, so \fBNPM_CONFIG_FOO=bar\fP will work the
same\. However, please note that inside npm\-scripts \fI/misc/scripts\fR
-npm will set it's own environment variables and Node will prefer
+npm will set its own environment variables and Node will prefer
those lowercase versions over any uppercase ones that you might set\.
For details see this issue \fIhttps://github\.com/npm/npm/issues/14528\fR\|\.
.SS npmrc Files
@@ -30,10 +36,10 @@ The four relevant files are:
per\-project configuration file (\fB/path/to/my/project/\.npmrc\fP)
.IP \(bu 2
per\-user configuration file (defaults to \fB$HOME/\.npmrc\fP; configurable via CLI
-option \fB\-\-userconfig\fP or environment variable \fB$NPM_CONF_USERCONFIG\fP)
+option \fB\-\-userconfig\fP or environment variable \fB$NPM_CONFIG_USERCONFIG\fP)
.IP \(bu 2
global configuration file (defaults to \fB$PREFIX/etc/npmrc\fP; configurable via
-CLI option \fB\-\-globalconfig\fP or environment variable \fB$NPM_CONF_GLOBALCONFIG\fP)
+CLI option \fB\-\-globalconfig\fP or environment variable \fB$NPM_CONFIG_GLOBALCONFIG\fP)
.IP \(bu 2
npm's built\-in configuration file (\fB/path/to/npm/npmrc\fP)
@@ -1209,6 +1215,16 @@ in to a private registry for the first time:
\fBnpm login \-\-scope=@organization \-\-registry=registry\.organization\.com\fP, which
will cause \fB@organization\fP to be mapped to the registry for future installation
of packages specified according to the pattern \fB@organization/package\fP\|\.
+.SS script\-shell
+.RS 0
+.IP \(bu 2
+Default: \fBnull\fP
+.IP \(bu 2
+Type: path
+
+.RE
+.P
+The shell to use for scripts run with the \fBnpm run\fP command\.
.SS scripts\-prepend\-node\-path
.RS 0
.IP \(bu 2