From bd547d65983c190eb69ca44d633ea31aca2b7c98 Mon Sep 17 00:00:00 2001
From: isaacs
Date: Wed, 19 Mar 2014 09:25:40 -0700
Subject: npm: upgrade to 1.4.6
* Documentation upgrades
* Fix glob bug which prevents proper README publishing
* node-gyp upgrade to 0.13
* Documentation updates
* Add --save-exact to save an exact dep (instead of a range)
* alias 't' to 'test'
---
deps/npm/html/doc/misc/npm-coding-style.html | 46 ++++++------------
deps/npm/html/doc/misc/npm-config.html | 67 +++++++++++--------------
deps/npm/html/doc/misc/npm-developers.html | 46 ++++++------------
deps/npm/html/doc/misc/npm-disputes.html | 46 ++++++------------
deps/npm/html/doc/misc/npm-faq.html | 48 ++++++------------
deps/npm/html/doc/misc/npm-index.html | 46 ++++++------------
deps/npm/html/doc/misc/npm-registry.html | 46 ++++++------------
deps/npm/html/doc/misc/npm-scripts.html | 46 ++++++------------
deps/npm/html/doc/misc/removing-npm.html | 46 ++++++------------
deps/npm/html/doc/misc/semver.html | 73 +++++++++++++++-------------
10 files changed, 181 insertions(+), 329 deletions(-)
(limited to 'deps/npm/html/doc/misc')
diff --git a/deps/npm/html/doc/misc/npm-coding-style.html b/deps/npm/html/doc/misc/npm-coding-style.html
index 3f43db0cc6..5e1992443c 100644
--- a/deps/npm/html/doc/misc/npm-coding-style.html
+++ b/deps/npm/html/doc/misc/npm-coding-style.html
@@ -3,9 +3,11 @@
More than you probably want to know about npm configuration
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
-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
-E
: --save-exact
-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 @@ -538,19 +540,28 @@ bundledDependencies list.
Save installed packages to a package.json file as devDependencies.
-When used with the npm rm
command, it removes it from the devDependencies
-hash.
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.
+Dependencies saved to package.json using --save
, --save-dev
or
+--save-optional
will be configured with an exact version rather than
+using npm's default semver range operator.
Save installed packages to a package.json file as optionalDependencies.
+Save installed packages to a package.json file as +optionalDependencies.
-When used with the npm rm
command, it removes it from the devDependencies
-hash.
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.
@@ -710,35 +721,15 @@ hash, and exit successfully.Frequently Asked Questions
In those cases, you can do this:
-curl https://npmjs.org/install.sh | sh
+curl https://www.npmjs.org/install.sh | sh
package
?Index of all npm documentation
The semantic versioner for npm
The JavaScript Package Registry
How npm handles the "scripts" field
Cleaning the Slate
The semantic versioner for npm
2.3.0-beta
will.<=1.2
ARE allowed, so 1.2.3-beta
would satisfy.
1.2.3 - 2.3.4
:= >=1.2.3 <=2.3.4
~1.2.3
:= >=1.2.3-0 <1.3.0-0
"Reasonably close to 1.2.3". When
using tilde operators, prerelease versions are supported as well,
but a prerelease of the next significant digit will NOT be
-satisfactory, so 1.3.0-beta
will not satisfy ~1.2.3
.~1.2
:= >=1.2.0-0 <1.3.0-0
"Any version starting with 1.2"1.2.x
:= >=1.2.0-0 <1.3.0-0
"Any version starting with 1.2"~1
:= >=1.0.0-0 <2.0.0-0
"Any version starting with 1"1.x
:= >=1.0.0-0 <2.0.0-0
"Any version starting with 1"1.3.0-beta
will not satisfy ~1.2.3
.^1.2.3
:= >=1.2.3-0 <2.0.0-0
"Compatible with 1.2.3". When
+using caret operators, anything from the specified version (including
+prerelease) will be supported up to, but not including, the next
+major version (or its prereleases). 1.5.1
will satisfy ^1.2.3
,
+while 1.2.2
and 2.0.0-beta
will not.^0.1.3
:= >=0.1.3-0 <0.2.0-0
"Compatible with 0.1.3". 0.x.x versions are
+special: the first non-zero component indicates potentially breaking changes,
+meaning the caret operator matches any version with the same first non-zero
+component starting at the specified version.^0.0.2
:= =0.0.2
"Only the version 0.0.2 is considered compatible"~1.2
:= >=1.2.0-0 <1.3.0-0
"Any version starting with 1.2"^1.2
:= >=1.2.0-0 <2.0.0-0
"Any version compatible with 1.2"1.2.x
:= >=1.2.0-0 <1.3.0-0
"Any version starting with 1.2"~1
:= >=1.0.0-0 <2.0.0-0
"Any version starting with 1"^1
:= >=1.0.0-0 <2.0.0-0
"Any version compatible with 1"1.x
:= >=1.0.0-0 <2.0.0-0
"Any version starting with 1"Ranges can be joined with either a space (which implies "and") or a
||
(which implies "or").
hilo
argument must be either the string '>'
or '<'
. (This is
+the function called by gtr
and ltr
.)Note that, since ranges may be non-contiguous, a version might not be
+greater than a range, less than a range, or satisfy a range! For
+example, the range 1.2 <1.2.9 || >2.0.0
would have a hole from 1.2.9
+until 2.0.0
, so the version 1.2.10
would not be greater than the
+range (because 2.0.1 satisfies, which is higher), nor less than the
+range (since 1.2.8 satisfies, which is lower), and it also does not
+satisfy the range.
If you want to know if a version satisfies or does not satisfy a
+range, use the satisfies(version, range)
function.