doc: organize into sections

95 files changed, 882 insertions, 80 deletions

diff --git a/doc/api/bin.md b/doc/api/npm-bin.md
index f3dc48286..f3dc48286 100644
--- a/doc/api/bin.md
+++ b/doc/api/npm-bin.md
diff --git a/doc/api/bugs.md b/doc/api/npm-bugs.md
index cc4db8f9e..cc4db8f9e 100644
--- a/doc/api/bugs.md
+++ b/doc/api/npm-bugs.md
diff --git a/doc/api/commands.md b/doc/api/npm-commands.md
index eb7545639..eb7545639 100644
--- a/doc/api/commands.md
+++ b/doc/api/npm-commands.md
diff --git a/doc/api/config.md b/doc/api/npm-config.md
index 7ae227428..7ae227428 100644
--- a/doc/api/config.md
+++ b/doc/api/npm-config.md
diff --git a/doc/api/deprecate.md b/doc/api/npm-deprecate.md
index 0608d3864..0608d3864 100644
--- a/doc/api/deprecate.md
+++ b/doc/api/npm-deprecate.md
diff --git a/doc/api/docs.md b/doc/api/npm-docs.md
index 2c5fc5e63..2c5fc5e63 100644
--- a/doc/api/docs.md
+++ b/doc/api/npm-docs.md
diff --git a/doc/api/edit.md b/doc/api/npm-edit.md
index b13fbb857..b13fbb857 100644
--- a/doc/api/edit.md
+++ b/doc/api/npm-edit.md
diff --git a/doc/api/explore.md b/doc/api/npm-explore.md
index a239f3df3..a239f3df3 100644
--- a/doc/api/explore.md
+++ b/doc/api/npm-explore.md
diff --git a/doc/api/help-search.md b/doc/api/npm-help-search.md
index 5c00cfc17..5c00cfc17 100644
--- a/doc/api/help-search.md
+++ b/doc/api/npm-help-search.md
diff --git a/doc/api/init.md b/doc/api/npm-init.md
index 5afc11b3b..5afc11b3b 100644
--- a/doc/api/init.md
+++ b/doc/api/npm-init.md
diff --git a/doc/api/install.md b/doc/api/npm-install.md
index 12f665a76..12f665a76 100644
--- a/doc/api/install.md
+++ b/doc/api/npm-install.md
diff --git a/doc/api/link.md b/doc/api/npm-link.md
index ad8cefcab..ad8cefcab 100644
--- a/doc/api/link.md
+++ b/doc/api/npm-link.md
diff --git a/doc/api/load.md b/doc/api/npm-load.md
index a95a6b295..a95a6b295 100644
--- a/doc/api/load.md
+++ b/doc/api/npm-load.md
diff --git a/doc/api/ls.md b/doc/api/npm-ls.md
index ed890ff14..ed890ff14 100644
--- a/doc/api/ls.md
+++ b/doc/api/npm-ls.md
diff --git a/doc/api/outdated.md b/doc/api/npm-outdated.md
index 89f4cf6fa..89f4cf6fa 100644
--- a/doc/api/outdated.md
+++ b/doc/api/npm-outdated.md
diff --git a/doc/api/owner.md b/doc/api/npm-owner.md
index de203c072..de203c072 100644
--- a/doc/api/owner.md
+++ b/doc/api/npm-owner.md
diff --git a/doc/api/pack.md b/doc/api/npm-pack.md
index cb339c0c4..cb339c0c4 100644
--- a/doc/api/pack.md
+++ b/doc/api/npm-pack.md
diff --git a/doc/api/prefix.md b/doc/api/npm-prefix.md
index 806dd4b6c..806dd4b6c 100644
--- a/doc/api/prefix.md
+++ b/doc/api/npm-prefix.md
diff --git a/doc/api/prune.md b/doc/api/npm-prune.md
index 2a4f17748..2a4f17748 100644
--- a/doc/api/prune.md
+++ b/doc/api/npm-prune.md
diff --git a/doc/api/publish.md b/doc/api/npm-publish.md
index a743303f8..a743303f8 100644
--- a/doc/api/publish.md
+++ b/doc/api/npm-publish.md
diff --git a/doc/api/rebuild.md b/doc/api/npm-rebuild.md
index 8b8989806..8b8989806 100644
--- a/doc/api/rebuild.md
+++ b/doc/api/npm-rebuild.md
diff --git a/doc/api/restart.md b/doc/api/npm-restart.md
index c40704438..c40704438 100644
--- a/doc/api/restart.md
+++ b/doc/api/npm-restart.md
diff --git a/doc/api/root.md b/doc/api/npm-root.md
index 1c3ab5640..1c3ab5640 100644
--- a/doc/api/root.md
+++ b/doc/api/npm-root.md
diff --git a/doc/api/run-script.md b/doc/api/npm-run-script.md
index f15900ecb..f15900ecb 100644
--- a/doc/api/run-script.md
+++ b/doc/api/npm-run-script.md
diff --git a/doc/api/search.md b/doc/api/npm-search.md
index 30651d76a..30651d76a 100644
--- a/doc/api/search.md
+++ b/doc/api/npm-search.md
diff --git a/doc/api/shrinkwrap.md b/doc/api/npm-shrinkwrap.md
index 6584d6a0d..6584d6a0d 100644
--- a/doc/api/shrinkwrap.md
+++ b/doc/api/npm-shrinkwrap.md
diff --git a/doc/api/start.md b/doc/api/npm-start.md
index 74491146a..74491146a 100644
--- a/doc/api/start.md
+++ b/doc/api/npm-start.md
diff --git a/doc/api/stop.md b/doc/api/npm-stop.md
index 0f8333d35..0f8333d35 100644
--- a/doc/api/stop.md
+++ b/doc/api/npm-stop.md
diff --git a/doc/api/submodule.md b/doc/api/npm-submodule.md
index 2d8bafaa3..2d8bafaa3 100644
--- a/doc/api/submodule.md
+++ b/doc/api/npm-submodule.md
diff --git a/doc/api/tag.md b/doc/api/npm-tag.md
index b5a3d7faa..b5a3d7faa 100644
--- a/doc/api/tag.md
+++ b/doc/api/npm-tag.md
diff --git a/doc/api/test.md b/doc/api/npm-test.md
index bc48dcc35..bc48dcc35 100644
--- a/doc/api/test.md
+++ b/doc/api/npm-test.md
diff --git a/doc/api/uninstall.md b/doc/api/npm-uninstall.md
index 4505295b3..4505295b3 100644
--- a/doc/api/uninstall.md
+++ b/doc/api/npm-uninstall.md
diff --git a/doc/api/unpublish.md b/doc/api/npm-unpublish.md
index 6cbc5c1f3..6cbc5c1f3 100644
--- a/doc/api/unpublish.md
+++ b/doc/api/npm-unpublish.md
diff --git a/doc/api/update.md b/doc/api/npm-update.md
index bf02fd3c8..bf02fd3c8 100644
--- a/doc/api/update.md
+++ b/doc/api/npm-update.md
diff --git a/doc/api/version.md b/doc/api/npm-version.md
index bd40102c4..bd40102c4 100644
--- a/doc/api/version.md
+++ b/doc/api/npm-version.md
diff --git a/doc/api/view.md b/doc/api/npm-view.md
index fd0076c96..fd0076c96 100644
--- a/doc/api/view.md
+++ b/doc/api/npm-view.md
diff --git a/doc/api/whoami.md b/doc/api/npm-whoami.md
index 598a1ab1a..598a1ab1a 100644
--- a/doc/api/whoami.md
+++ b/doc/api/npm-whoami.md
diff --git a/doc/cli/changelog.md b/doc/cli/changelog.md
deleted file mode 100644
index 64feeacda..000000000
--- a/doc/cli/changelog.md
+++ /dev/null
@@ -1,80 +0,0 @@
-npm-changelog(1) -- Changes
-===========================
-
-## HISTORY
-
-### 1.1.3, 1.1.4
-
-* Update request to support HTTPS-over-HTTP proxy tunneling
-* Throw on undefined envs in config settings
-* Update which to 1.0.5
-* Fix windows UNC busyloop in findPrefix
-* Bundle nested bundleDependencies properly
-* Alias adduser to add-user
-* Doc updates  (Christian Howe, Henrik Hodne, Andrew Lunny)
-* ignore logfd/outfd streams in makeEnv() (Rod Vagg)
-* shrinkwrap: Behave properly with url-installed deps
-* install: Support --save with url install targets
-* Support installing naked tars or single-file modules from urls etc.
-* init: Don't add engines section
-* Don't run make clean on rebuild
-* Added missing unicode replacement (atomizer)
-
-### 1.1.2
-
-Dave Pacheco (2):
-      add "npm shrinkwrap"
-
-Martin Cooper (1):
-      Fix #1753 Make a copy of the cached objects we'll modify.
-
-Tim Oxley (1):
-      correctly remove readme from default npm view command.
-
-Tyler Green (1):
-      fix #2187 set terminal columns to Infinity if 0
-
-isaacs (19):
-      update minimatch
-      update request
-      Experimental: single-file modules
-      Fix #2172 Don't remove global mans uninstalling local pkgs
-      Add --versions flag to show the version of node as well
-      Support --json flag for ls output
-      update request to 2.9.151
-
-### 1.1  
-* Replace system tar dependency with a JS tar
-* Continue to refine
-
-### 1.0  
-* Greatly simplified folder structure 
-* Install locally (bundle by default) 
-* Drastic rearchitecture
-
-### 0.3  
-* More correct permission/uid handling when running as root  
-* Require node 0.4.0  
-* Reduce featureset  
-* Packages without "main" modules don't export modules
-* Remove support for invalid JSON (since node doesn't support it)
-
-### 0.2  
-* First allegedly "stable" release
-* Most functionality implemented 
-* Used shim files and `name@version` symlinks
-* Feature explosion
-* Kind of a mess
-
-### 0.1  
-* push to beta, and announce  
-* Solaris and Cygwin support
-
-### 0.0  
-* Lots of sketches and false starts; abandoned a few times
-* Core functionality established
-
-## SEE ALSO
-
-* npm(1)
-* npm-faq(1)
diff --git a/doc/cli/adduser.md b/doc/cli/npm-adduser.md
index 51aa6f6a3..51aa6f6a3 100644
--- a/doc/cli/adduser.md
+++ b/doc/cli/npm-adduser.md
diff --git a/doc/cli/bin.md b/doc/cli/npm-bin.md
index 2c2e7c477..2c2e7c477 100644
--- a/doc/cli/bin.md
+++ b/doc/cli/npm-bin.md
diff --git a/doc/cli/bugs.md b/doc/cli/npm-bugs.md
index 45ee84b58..45ee84b58 100644
--- a/doc/cli/bugs.md
+++ b/doc/cli/npm-bugs.md
diff --git a/doc/cli/build.md b/doc/cli/npm-build.md
index 978f4a6d6..978f4a6d6 100644
--- a/doc/cli/build.md
+++ b/doc/cli/npm-build.md
diff --git a/doc/cli/bundle.md b/doc/cli/npm-bundle.md
index 69b3d83e4..69b3d83e4 100644
--- a/doc/cli/bundle.md
+++ b/doc/cli/npm-bundle.md
diff --git a/doc/cli/cache.md b/doc/cli/npm-cache.md
index 1fa128ad4..1fa128ad4 100644
--- a/doc/cli/cache.md
+++ b/doc/cli/npm-cache.md
diff --git a/doc/cli/completion.md b/doc/cli/npm-completion.md
index 48bc50fd8..48bc50fd8 100644
--- a/doc/cli/completion.md
+++ b/doc/cli/npm-completion.md
diff --git a/doc/cli/config.md b/doc/cli/npm-config.md
index 54133bec3..54133bec3 100644
--- a/doc/cli/config.md
+++ b/doc/cli/npm-config.md
diff --git a/doc/cli/dedupe.md b/doc/cli/npm-dedupe.md
index 220329acb..220329acb 100644
--- a/doc/cli/dedupe.md
+++ b/doc/cli/npm-dedupe.md
diff --git a/doc/cli/deprecate.md b/doc/cli/npm-deprecate.md
index c45245f09..c45245f09 100644
--- a/doc/cli/deprecate.md
+++ b/doc/cli/npm-deprecate.md
diff --git a/doc/cli/docs.md b/doc/cli/npm-docs.md
index 28fa49193..28fa49193 100644
--- a/doc/cli/docs.md
+++ b/doc/cli/npm-docs.md
diff --git a/doc/cli/edit.md b/doc/cli/npm-edit.md
index 9eaccfc54..9eaccfc54 100644
--- a/doc/cli/edit.md
+++ b/doc/cli/npm-edit.md
diff --git a/doc/cli/explore.md b/doc/cli/npm-explore.md
index 00701b392..00701b392 100644
--- a/doc/cli/explore.md
+++ b/doc/cli/npm-explore.md
diff --git a/doc/cli/help-search.md b/doc/cli/npm-help-search.md
index 9c16901eb..9c16901eb 100644
--- a/doc/cli/help-search.md
+++ b/doc/cli/npm-help-search.md
diff --git a/doc/cli/help.md b/doc/cli/npm-help.md
index b51b0f164..b51b0f164 100644
--- a/doc/cli/help.md
+++ b/doc/cli/npm-help.md
diff --git a/doc/cli/init.md b/doc/cli/npm-init.md
index d036f924d..d036f924d 100644
--- a/doc/cli/init.md
+++ b/doc/cli/npm-init.md
diff --git a/doc/cli/install.md b/doc/cli/npm-install.md
index 44885f318..44885f318 100644
--- a/doc/cli/install.md
+++ b/doc/cli/npm-install.md
diff --git a/doc/cli/link.md b/doc/cli/npm-link.md
index 4e4ef799b..4e4ef799b 100644
--- a/doc/cli/link.md
+++ b/doc/cli/npm-link.md
diff --git a/doc/cli/ls.md b/doc/cli/npm-ls.md
index 9b69b8585..9b69b8585 100644
--- a/doc/cli/ls.md
+++ b/doc/cli/npm-ls.md
diff --git a/doc/cli/outdated.md b/doc/cli/npm-outdated.md
index 78df4a8b3..78df4a8b3 100644
--- a/doc/cli/outdated.md
+++ b/doc/cli/npm-outdated.md
diff --git a/doc/cli/owner.md b/doc/cli/npm-owner.md
index 902e083fc..902e083fc 100644
--- a/doc/cli/owner.md
+++ b/doc/cli/npm-owner.md
diff --git a/doc/cli/pack.md b/doc/cli/npm-pack.md
index 98d8c81c5..98d8c81c5 100644
--- a/doc/cli/pack.md
+++ b/doc/cli/npm-pack.md
diff --git a/doc/cli/prefix.md b/doc/cli/npm-prefix.md
index f6247cab1..f6247cab1 100644
--- a/doc/cli/prefix.md
+++ b/doc/cli/npm-prefix.md
diff --git a/doc/cli/prune.md b/doc/cli/npm-prune.md
index 8c4b957e6..8c4b957e6 100644
--- a/doc/cli/prune.md
+++ b/doc/cli/npm-prune.md
diff --git a/doc/cli/publish.md b/doc/cli/npm-publish.md
index 621932f07..621932f07 100644
--- a/doc/cli/publish.md
+++ b/doc/cli/npm-publish.md
diff --git a/doc/cli/rebuild.md b/doc/cli/npm-rebuild.md
index 6985a7bdd..6985a7bdd 100644
--- a/doc/cli/rebuild.md
+++ b/doc/cli/npm-rebuild.md
diff --git a/doc/cli/restart.md b/doc/cli/npm-restart.md
index 6139dbeef..6139dbeef 100644
--- a/doc/cli/restart.md
+++ b/doc/cli/npm-restart.md
diff --git a/doc/cli/rm.md b/doc/cli/npm-rm.md
index f7f743fae..f7f743fae 100644
--- a/doc/cli/rm.md
+++ b/doc/cli/npm-rm.md
diff --git a/doc/cli/root.md b/doc/cli/npm-root.md
index 3e4199541..3e4199541 100644
--- a/doc/cli/root.md
+++ b/doc/cli/npm-root.md
diff --git a/doc/cli/run-script.md b/doc/cli/npm-run-script.md
index 41ef5e787..41ef5e787 100644
--- a/doc/cli/run-script.md
+++ b/doc/cli/npm-run-script.md
diff --git a/doc/cli/search.md b/doc/cli/npm-search.md
index e9e408c67..e9e408c67 100644
--- a/doc/cli/search.md
+++ b/doc/cli/npm-search.md
diff --git a/doc/cli/shrinkwrap.md b/doc/cli/npm-shrinkwrap.md
index f0b83d50d..f0b83d50d 100644
--- a/doc/cli/shrinkwrap.md
+++ b/doc/cli/npm-shrinkwrap.md
diff --git a/doc/cli/star.md b/doc/cli/npm-star.md
index 5c076b3c3..5c076b3c3 100644
--- a/doc/cli/star.md
+++ b/doc/cli/npm-star.md
diff --git a/doc/cli/stars.md b/doc/cli/npm-stars.md
index 7c28f5b2a..7c28f5b2a 100644
--- a/doc/cli/stars.md
+++ b/doc/cli/npm-stars.md
diff --git a/doc/cli/start.md b/doc/cli/npm-start.md
index cc897bbc0..cc897bbc0 100644
--- a/doc/cli/start.md
+++ b/doc/cli/npm-start.md
diff --git a/doc/cli/stop.md b/doc/cli/npm-stop.md
index 1ab3e9975..1ab3e9975 100644
--- a/doc/cli/stop.md
+++ b/doc/cli/npm-stop.md
diff --git a/doc/cli/submodule.md b/doc/cli/npm-submodule.md
index 13ab1edd9..13ab1edd9 100644
--- a/doc/cli/submodule.md
+++ b/doc/cli/npm-submodule.md
diff --git a/doc/cli/tag.md b/doc/cli/npm-tag.md
index 2f1ca4373..2f1ca4373 100644
--- a/doc/cli/tag.md
+++ b/doc/cli/npm-tag.md
diff --git a/doc/cli/test.md b/doc/cli/npm-test.md
index bc634efbf..bc634efbf 100644
--- a/doc/cli/test.md
+++ b/doc/cli/npm-test.md
diff --git a/doc/cli/uninstall.md b/doc/cli/npm-uninstall.md
index f7f743fae..f7f743fae 100644
--- a/doc/cli/uninstall.md
+++ b/doc/cli/npm-uninstall.md
diff --git a/doc/cli/unpublish.md b/doc/cli/npm-unpublish.md
index 0f4446c4e..0f4446c4e 100644
--- a/doc/cli/unpublish.md
+++ b/doc/cli/npm-unpublish.md
diff --git a/doc/cli/update.md b/doc/cli/npm-update.md
index 302e2efff..302e2efff 100644
--- a/doc/cli/update.md
+++ b/doc/cli/npm-update.md
diff --git a/doc/cli/version.md b/doc/cli/npm-version.md
index 74d938d6b..74d938d6b 100644
--- a/doc/cli/version.md
+++ b/doc/cli/npm-version.md
diff --git a/doc/cli/view.md b/doc/cli/npm-view.md
index 07836a5ef..07836a5ef 100644
--- a/doc/cli/view.md
+++ b/doc/cli/npm-view.md
diff --git a/doc/cli/whoami.md b/doc/cli/npm-whoami.md
index 7c39b1624..7c39b1624 100644
--- a/doc/cli/whoami.md
+++ b/doc/cli/npm-whoami.md
diff --git a/doc/cli/folders.md b/doc/files/npm-folders.md
index 04fc13cfb..04fc13cfb 100644
--- a/doc/cli/folders.md
+++ b/doc/files/npm-folders.md
diff --git a/doc/cli/global.md b/doc/files/npm-global.md
index 20358612a..20358612a 100644
--- a/doc/cli/global.md
+++ b/doc/files/npm-global.md
diff --git a/doc/cli/scripts.md b/doc/files/npm-scripts.md
index 0eba5f7b1..0eba5f7b1 100644
--- a/doc/cli/scripts.md
+++ b/doc/files/npm-scripts.md
diff --git a/doc/files/npmrc.md b/doc/files/npmrc.md
new file mode 100644
index 000000000..54133bec3
--- /dev/null
+++ b/doc/files/npmrc.md
@@ -0,0 +1,882 @@
+npm-config(1) -- Manage the npm configuration file
+==================================================
+
+## SYNOPSIS
+
+    npm config set <key> <value> [--global]
+    npm config get <key>
+    npm config delete <key>
+    npm config list
+    npm config edit
+    npm get <key>
+    npm set <key> <value> [--global]
+
+## DESCRIPTION
+
+npm gets its configuration values from 6 sources, in this priority:
+
+### Command Line Flags
+
+Putting `--foo bar` on the command line sets the
+`foo` configuration parameter to `"bar"`.  A `--` argument tells the cli
+parser to stop reading flags.  A `--flag` parameter that is at the *end* of
+the command will be given the value of `true`.
+
+### Environment Variables
+
+Any environment variables that start with `npm_config_` will be interpreted
+as a configuration parameter.  For example, putting `npm_config_foo=bar` in
+your environment will set the `foo` configuration parameter to `bar`.  Any
+environment configurations that are not given a value will be given the value
+of `true`.  Config values are case-insensitive, so `NPM_CONFIG_FOO=bar` will
+work the same.
+
+### Per-user config file
+
+`$HOME/.npmrc` (or the `userconfig` param, if set above)
+
+This file is an ini-file formatted list of `key = value` parameters.
+Environment variables can be replaced using `${VARIABLE_NAME}`. For example:
+
+    prefix = ${HOME}/.npm-packages
+
+### Global config file
+
+`$PREFIX/etc/npmrc` (or the `globalconfig` param, if set above):
+This file is an ini-file formatted list of `key = value` parameters.
+Environment variables can be replaced as above.
+
+### Built-in config file
+
+`path/to/npm/itself/npmrc`
+
+This is an unchangeable "builtin"
+configuration file that npm keeps consistent across updates.  Set
+fields in here using the `./configure` script that comes with npm.
+This is primarily for distribution maintainers to override default
+configs in a standard and consistent manner.
+
+### Default Configs
+
+A set of configuration parameters that are internal to npm, and are
+defaults if nothing else is specified.
+
+## Sub-commands
+
+Config supports the following sub-commands:
+
+### set
+
+    npm config set key value
+
+Sets the config key to the value.
+
+If value is omitted, then it sets it to "true".
+
+### get
+
+    npm config get key
+
+Echo the config value to stdout.
+
+### list
+
+    npm config list
+
+Show all the config settings.
+
+### delete
+
+    npm config delete key
+
+Deletes the key from all configuration files.
+
+### edit
+
+    npm config edit
+
+Opens the config file in an editor.  Use the `--global` flag to edit the
+global config.
+
+## Shorthands and Other CLI Niceties
+
+The following shorthands are parsed on the command-line:
+
+* `-v`: `--version`
+* `-h`, `-?`, `--help`, `-H`: `--usage`
+* `-s`, `--silent`: `--loglevel silent`
+* `-q`, `--quiet`: `--loglevel warn`
+* `-d`: `--loglevel info`
+* `-dd`, `--verbose`: `--loglevel verbose`
+* `-ddd`: `--loglevel silly`
+* `-g`: `--global`
+* `-l`: `--long`
+* `-m`: `--message`
+* `-p`, `--porcelain`: `--parseable`
+* `-reg`: `--registry`
+* `-v`: `--version`
+* `-f`: `--force`
+* `-desc`: `--description`
+* `-S`: `--save`
+* `-D`: `--save-dev`
+* `-O`: `--save-optional`
+* `-B`: `--save-bundle`
+* `-y`: `--yes`
+* `-n`: `--yes false`
+* `ll` and `la` commands: `ls --long`
+
+If the specified configuration param resolves unambiguously to a known
+configuration parameter, then it is expanded to that configuration
+parameter.  For example:
+
+    npm ls --par
+    # same as:
+    npm ls --parseable
+
+If multiple single-character shorthands are strung together, and the
+resulting combination is unambiguously not some other configuration
+param, then it is expanded to its various component pieces.  For
+example:
+
+    npm ls -gpld
+    # same as:
+    npm ls --global --parseable --long --loglevel info
+
+## Per-Package Config Settings
+
+When running scripts (see `npm-scripts(1)`)
+the package.json "config" keys are overwritten in the environment if
+there is a config param of `<name>[@<version>]:<key>`.  For example, if
+the package.json has this:
+
+    { "name" : "foo"
+    , "config" : { "port" : "8080" }
+    , "scripts" : { "start" : "node server.js" } }
+
+and the server.js is this:
+
+    http.createServer(...).listen(process.env.npm_package_config_port)
+
+then the user could change the behavior by doing:
+
+    npm config set foo:port 80
+
+## Config Settings
+
+### always-auth
+
+* Default: false
+* Type: Boolean
+
+Force npm to always require authentication when accessing the registry,
+even for `GET` requests.
+
+### bin-links
+
+* Default: `true`
+* Type: Boolean
+
+Tells npm to create symlinks (or `.cmd` shims on Windows) for package
+executables.
+
+Set to false to have it not do this.  This can be used to work around
+the fact that some file systems don't support symlinks, even on
+ostensibly Unix systems.
+
+### browser
+
+* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+* Type: String
+
+The browser that is called by the `npm docs` command to open websites.
+
+### ca
+
+* Default: The npm CA certificate
+* Type: String or null
+
+The Certificate Authority signing certificate that is trusted for SSL
+connections to the registry.
+
+Set to `null` to only allow "known" registrars, or to a specific CA cert
+to trust only that specific signing authority.
+
+See also the `strict-ssl` config.
+
+### cache
+
+* Default: Windows: `%APPDATA%\npm-cache`, Posix: `~/.npm`
+* Type: path
+
+The location of npm's cache directory.  See `npm-cache(1)`
+
+### cache-lock-stale
+
+* Default: 60000 (1 minute)
+* Type: Number
+
+The number of ms before cache folder lockfiles are considered stale.
+
+### cache-lock-retries
+
+* Default: 10
+* Type: Number
+
+Number of times to retry to acquire a lock on cache folder lockfiles.
+
+### cache-lock-wait
+
+* Default: 10000 (10 seconds)
+* Type: Number
+
+Number of ms to wait for cache lock files to expire.
+
+### cache-max
+
+* Default: Infinity
+* Type: Number
+
+The maximum time (in seconds) to keep items in the registry cache before
+re-checking against the registry.
+
+Note that no purging is done unless the `npm cache clean` command is
+explicitly used, and that only GET requests use the cache.
+
+### cache-min
+
+* Default: 10
+* Type: Number
+
+The minimum time (in seconds) to keep items in the registry cache before
+re-checking against the registry.
+
+Note that no purging is done unless the `npm cache clean` command is
+explicitly used, and that only GET requests use the cache.
+
+### color
+
+* Default: true on Posix, false on Windows
+* Type: Boolean or `"always"`
+
+If false, never shows colors.  If `"always"` then always shows colors.
+If true, then only prints color codes for tty file descriptors.
+
+### coverage
+
+* Default: false
+* Type: Boolean
+
+A flag to tell test-harness to run with their coverage options enabled,
+if they respond to the `npm_config_coverage` environment variable.
+
+### depth
+
+* Default: Infinity
+* Type: Number
+
+The depth to go when recursing directories for `npm ls` and
+`npm cache ls`.
+
+### description
+
+* Default: true
+* Type: Boolean
+
+Show the description in `npm search`
+
+### dev
+
+* Default: false
+* Type: Boolean
+
+Install `dev-dependencies` along with packages.
+
+Note that `dev-dependencies` are also installed if the `npat` flag is
+set.
+
+### editor
+
+* Default: `EDITOR` environment variable if set, or `"vi"` on Posix,
+  or `"notepad"` on Windows.
+* Type: path
+
+The command to run for `npm edit` or `npm config edit`.
+
+### engine-strict
+
+* Default: false
+* Type: Boolean
+
+If set to true, then npm will stubbornly refuse to install (or even
+consider installing) any package that claims to not be compatible with
+the current Node.js version.
+
+### force
+
+* Default: false
+* Type: Boolean
+
+Makes various commands more forceful.
+
+* lifecycle script failure does not block progress.
+* publishing clobbers previously published versions.
+* skips cache when requesting from the registry.
+* prevents checks against clobbering non-npm files.
+
+### fetch-retries
+
+* Default: 2
+* Type: Number
+
+The "retries" config for the `retry` module to use when fetching
+packages from the registry.
+
+### fetch-retry-factor
+
+* Default: 10
+* Type: Number
+
+The "factor" config for the `retry` module to use when fetching
+packages.
+
+### fetch-retry-mintimeout
+
+* Default: 10000 (10 seconds)
+* Type: Number
+
+The "minTimeout" config for the `retry` module to use when fetching
+packages.
+
+### fetch-retry-maxtimeout
+
+* Default: 60000 (1 minute)
+* Type: Number
+
+The "maxTimeout" config for the `retry` module to use when fetching
+packages.
+
+### git
+
+* Default: `"git"`
+* Type: String
+
+The command to use for git commands.  If git is installed on the
+computer, but is not in the `PATH`, then set this to the full path to
+the git binary.
+
+### global
+
+* Default: false
+* Type: Boolean
+
+Operates in "global" mode, so that packages are installed into the
+`prefix` folder instead of the current working directory.  See
+`npm-folders(1)` for more on the differences in behavior.
+
+* packages are installed into the `{prefix}/lib/node_modules` folder, instead of the
+  current working directory.
+* bin files are linked to `{prefix}/bin`
+* man pages are linked to `{prefix}/share/man`
+
+### globalconfig
+
+* Default: {prefix}/etc/npmrc
+* Type: path
+
+The config file to read for global config options.
+
+### globalignorefile
+
+* Default: {prefix}/etc/npmignore
+* Type: path
+
+The config file to read for global ignore patterns to apply to all users
+and all projects.
+
+If not found, but there is a "gitignore" file in the
+same directory, then that will be used instead.
+
+### group
+
+* Default: GID of the current process
+* Type: String or Number
+
+The group to use when running package scripts in global mode as the root
+user.
+
+### https-proxy
+
+* Default: the `HTTPS_PROXY` or `https_proxy` or `HTTP_PROXY` or
+  `http_proxy` environment variables.
+* Type: url
+
+A proxy to use for outgoing https requests.
+
+### user-agent
+
+* Default: node/{process.version} {process.platform} {process.arch}
+* Type: String
+
+Sets a User-Agent to the request header
+
+### ignore
+
+* Default: ""
+* Type: string
+
+A white-space separated list of glob patterns of files to always exclude
+from packages when building tarballs.
+
+### init-module
+
+* Default: ~/.npm-init.js
+* Type: path
+
+A module that will be loaded by the `npm init` command.  See the
+documentation for the
+[init-package-json](https://github.com/isaacs/init-package-json) module
+for more information, or npm-init(1).
+
+### init.version
+
+* Default: "0.0.0"
+* Type: semver
+
+The value `npm init` should use by default for the package version.
+
+### init.author.name
+
+* Default: ""
+* Type: String
+
+The value `npm init` should use by default for the package author's name.
+
+### init.author.email
+
+* Default: ""
+* Type: String
+
+The value `npm init` should use by default for the package author's email.
+
+### init.author.url
+
+* Default: ""
+* Type: String
+
+The value `npm init` should use by default for the package author's homepage.
+
+### json
+
+* Default: false
+* Type: Boolean
+
+Whether or not to output JSON data, rather than the normal output.
+
+This feature is currently experimental, and the output data structures
+for many commands is either not implemented in JSON yet, or subject to
+change.  Only the output from `npm ls --json` is currently valid.
+
+### link
+
+* Default: false
+* Type: Boolean
+
+If true, then local installs will link if there is a suitable globally
+installed package.
+
+Note that this means that local installs can cause things to be
+installed into the global space at the same time.  The link is only done
+if one of the two conditions are met:
+
+* The package is not already installed globally, or
+* the globally installed version is identical to the version that is
+  being installed locally.
+
+### loglevel
+
+* Default: "http"
+* Type: String
+* Values: "silent", "win", "error", "warn", "http", "info", "verbose", "silly"
+
+What level of logs to report.  On failure, *all* logs are written to
+`npm-debug.log` in the current working directory.
+
+Any logs of a higher level than the setting are shown.
+The default is "http", which shows http, warn, and error output.
+
+### logstream
+
+* Default: process.stderr
+* Type: Stream
+
+This is the stream that is passed to the
+[npmlog](https://github.com/isaacs/npmlog) module at run time.
+
+It cannot be set from the command line, but if you are using npm
+programmatically, you may wish to send logs to somewhere other than
+stderr.
+
+If the `color` config is set to true, then this stream will receive
+colored output if it is a TTY.
+
+### long
+
+* Default: false
+* Type: Boolean
+
+Show extended information in `npm ls`
+
+### message
+
+* Default: "%s"
+* Type: String
+
+Commit message which is used by `npm version` when creating version commit.
+
+Any "%s" in the message will be replaced with the version number.
+
+### node-version
+
+* Default: process.version
+* Type: semver or false
+
+The node version to use when checking package's "engines" hash.
+
+### npat
+
+* Default: false
+* Type: Boolean
+
+Run tests on installation and report results to the
+`npaturl`.
+
+### npaturl
+
+* Default: Not yet implemented
+* Type: url
+
+The url to report npat test results.
+
+### onload-script
+
+* Default: false
+* Type: path
+
+A node module to `require()` when npm loads.  Useful for programmatic
+usage.
+
+### optional
+
+* Default: true
+* Type: Boolean
+
+Attempt to install packages in the `optionalDependencies` hash.  Note
+that if these packages fail to install, the overall installation
+process is not aborted.
+
+### parseable
+
+* Default: false
+* Type: Boolean
+
+Output parseable results from commands that write to
+standard output.
+
+### prefix
+
+* Default: see npm-folders(1)
+* Type: path
+
+The location to install global items.  If set on the command line, then
+it forces non-global commands to run in the specified folder.
+
+### production
+
+* Default: false
+* Type: Boolean
+
+Set to true to run in "production" mode.
+
+1. devDependencies are not installed at the topmost level when running
+   local `npm install` without any arguments.
+2. Set the NODE_ENV="production" for lifecycle scripts.
+
+### proprietary-attribs
+
+* Default: true
+* Type: Boolean
+
+Whether or not to include proprietary extended attributes in the
+tarballs created by npm.
+
+Unless you are expecting to unpack package tarballs with something other
+than npm -- particularly a very outdated tar implementation -- leave
+this as true.
+
+### proxy
+
+* Default: `HTTP_PROXY` or `http_proxy` environment variable, or null
+* Type: url
+
+A proxy to use for outgoing http requests.
+
+### rebuild-bundle
+
+* Default: true
+* Type: Boolean
+
+Rebuild bundled dependencies after installation.
+
+### registry
+
+* Default: https://registry.npmjs.org/
+* Type: url
+
+The base URL of the npm package registry.
+
+### rollback
+
+* Default: true
+* Type: Boolean
+
+Remove failed installs.
+
+### save
+
+* Default: false
+* Type: Boolean
+
+Save installed packages to a package.json file as dependencies.
+
+When used with the `npm rm` command, it removes it from the dependencies
+hash.
+
+Only works if there is already a package.json file present.
+
+### save-bundle
+
+* Default: false
+* Type: Boolean
+
+If a package would be saved at install time by the use of `--save`,
+`--save-dev`, or `--save-optional`, then also put it in the
+`bundleDependencies` list.
+
+When used with the `npm rm` command, it removes it from the
+bundledDependencies list.
+
+### save-dev
+
+* Default: false
+* Type: Boolean
+
+Save installed packages to a package.json file as devDependencies.
+
+When used with the `npm rm` command, it removes it from the devDependencies
+hash.
+
+Only works if there is already a package.json file present.
+
+### save-optional
+
+* Default: false
+* Type: Boolean
+
+Save installed packages to a package.json file as optionalDependencies.
+
+When used with the `npm rm` command, it removes it from the devDependencies
+hash.
+
+Only works if there is already a package.json file present.
+
+### searchopts
+
+* Default: ""
+* Type: String
+
+Space-separated options that are always passed to search.
+
+### searchexclude
+
+* Default: ""
+* Type: String
+
+Space-separated options that limit the results from search.
+
+### searchsort
+
+* Default: "name"
+* Type: String
+* Values: "name", "-name", "date", "-date", "description",
+  "-description", "keywords", "-keywords"
+
+Indication of which field to sort search results by.  Prefix with a `-`
+character to indicate reverse sort.
+
+### shell
+
+* Default: SHELL environment variable, or "bash" on Posix, or "cmd" on
+  Windows
+* Type: path
+
+The shell to run for the `npm explore` command.
+
+### shrinkwrap
+
+* Default: true
+* Type: Boolean
+
+If set to false, then ignore `npm-shrinkwrap.json` files when
+installing.
+
+### sign-git-tag
+
+* Default: false
+* Type: Boolean
+
+If set to true, then the `npm version` command will tag the version
+using `-s` to add a signature.
+
+Note that git requires you to have set up GPG keys in your git configs
+for this to work properly.
+
+### strict-ssl
+
+* Default: true
+* Type: Boolean
+
+Whether or not to do SSL key validation when making requests to the
+registry via https.
+
+See also the `ca` config.
+
+### tag
+
+* Default: latest
+* Type: String
+
+If you ask npm to install a package and don't tell it a specific version, then
+it will install the specified tag.
+
+Also the tag that is added to the package@version specified by the `npm
+tag` command, if no explicit tag is given.
+
+### tmp
+
+* Default: TMPDIR environment variable, or "/tmp"
+* Type: path
+
+Where to store temporary files and folders.  All temp files are deleted
+on success, but left behind on failure for forensic purposes.
+
+### unicode
+
+* Default: true
+* Type: Boolean
+
+When set to true, npm uses unicode characters in the tree output.  When
+false, it uses ascii characters to draw trees.
+
+### unsafe-perm
+
+* Default: false if running as root, true otherwise
+* Type: Boolean
+
+Set to true to suppress the UID/GID switching when running package
+scripts.  If set explicitly to false, then installing as a non-root user
+will fail.
+
+### usage
+
+* Default: false
+* Type: Boolean
+
+Set to show short usage output (like the -H output)
+instead of complete help when doing `npm-help(1)`.
+
+### user
+
+* Default: "nobody"
+* Type: String or Number
+
+The UID to set to when running package scripts as root.
+
+### username
+
+* Default: null
+* Type: String
+
+The username on the npm registry.  Set with `npm adduser`
+
+### userconfig
+
+* Default: ~/.npmrc
+* Type: path
+
+The location of user-level configuration settings.
+
+### userignorefile
+
+* Default: ~/.npmignore
+* Type: path
+
+The location of a user-level ignore file to apply to all packages.
+
+If not found, but there is a .gitignore file in the same directory, then
+that will be used instead.
+
+### umask
+
+* Default: 022
+* Type: Octal numeric string
+
+The "umask" value to use when setting the file creation mode on files
+and folders.
+
+Folders and executables are given a mode which is `0777` masked against
+this value.  Other files are given a mode which is `0666` masked against
+this value.  Thus, the defaults are `0755` and `0644` respectively.
+
+### version
+
+* Default: false
+* Type: boolean
+
+If true, output the npm version and exit successfully.
+
+Only relevant when specified explicitly on the command line.
+
+### versions
+
+* Default: false
+* Type: boolean
+
+If true, output the npm version as well as node's `process.versions`
+hash, and exit successfully.
+
+Only relevant when specified explicitly on the command line.
+
+### viewer
+
+* Default: "man" on Posix, "browser" on Windows
+* Type: path
+
+The program to use to view help content.
+
+Set to `"browser"` to view html help content in the default web browser.
+
+### yes
+
+* Default: null
+* Type: Boolean or null
+
+If set to `null`, then prompt the user for responses in some
+circumstances.
+
+If set to `true`, then answer "yes" to any prompt.  If set to `false`
+then answer "no" to any prompt.
+
+## SEE ALSO
+
+* npm-folders(1)
+* npm(1)
diff --git a/doc/cli/json.md b/doc/files/package.json.md
index 403f7f856..403f7f856 100644
--- a/doc/cli/json.md
+++ b/doc/files/package.json.md
diff --git a/doc/cli/semver.md b/doc/files/semver.md
index 2c499a984..2c499a984 100644
--- a/doc/cli/semver.md
+++ b/doc/files/semver.md
diff --git a/doc/cli/coding-style.md b/doc/misc/npm-coding-style.md
index 1aa3e80e2..1aa3e80e2 100644
--- a/doc/cli/coding-style.md
+++ b/doc/misc/npm-coding-style.md
diff --git a/doc/cli/developers.md b/doc/misc/npm-developers.md
index d1ffd5aa8..d1ffd5aa8 100644
--- a/doc/cli/developers.md
+++ b/doc/misc/npm-developers.md
diff --git a/doc/cli/disputes.md b/doc/misc/npm-disputes.md
index 52d2a2e56..52d2a2e56 100644
--- a/doc/cli/disputes.md
+++ b/doc/misc/npm-disputes.md
diff --git a/doc/cli/faq.md b/doc/misc/npm-faq.md
index e00fec61d..e00fec61d 100644
--- a/doc/cli/faq.md
+++ b/doc/misc/npm-faq.md
diff --git a/doc/cli/registry.md b/doc/misc/npm-registry.md
index 9173defef..9173defef 100644
--- a/doc/cli/registry.md
+++ b/doc/misc/npm-registry.md
diff --git a/doc/cli/removing-npm.md b/doc/misc/removing-npm.md
index bedd28a2f..bedd28a2f 100644
--- a/doc/cli/removing-npm.md
+++ b/doc/misc/removing-npm.md