diff options
author | Kristofer Selbekk <selbekk@users.noreply.github.com> | 2018-03-08 11:32:58 +0300 |
---|---|---|
committer | Kat Marchán <kzm@sykosomatic.org> | 2018-03-09 01:20:41 +0300 |
commit | dc36d850a1d763f71a98c99db05ca875dab124ed (patch) | |
tree | 06f697c3191b5e0de6ef018fdc809a09860817a1 /doc | |
parent | c8230c9bbd596156a4a8cfe62f2370f81d22bd9f (diff) |
docs: update now saves by default (#19552)
This commit makes a note that `npm update` updates `package.json` with the new version as
the minimum required dependency from `@5.0.0`.
Outdated documentation about how to update `package.json` in older versions of npm has been removed.
PR-URL: https://github.com/npm/npm/pull/19552
Credit: @selbekk
Reviewed-By: @zkat
Diffstat (limited to 'doc')
-rw-r--r-- | doc/cli/npm-update.md | 28 |
1 files changed, 4 insertions, 24 deletions
diff --git a/doc/cli/npm-update.md b/doc/cli/npm-update.md index d6ec30d2a..ec02cbcc3 100644 --- a/doc/cli/npm-update.md +++ b/doc/cli/npm-update.md @@ -26,6 +26,10 @@ As of `npm@2.6.1`, the `npm update` will only inspect top-level packages. Prior versions of `npm` would also recursively inspect all dependencies. To get the old behavior, use `npm --depth 9999 update`. +As of `npm@5.0.0`, the `npm update` will change `package.json` to save the +new version as the minimum required dependency. To get the old behavior, +use `npm update --no-save`. + ## EXAMPLES IMPORTANT VERSION NOTE: these examples assume `npm@2.6.1` or later. For @@ -104,30 +108,6 @@ If the dependence were on `^0.4.0`: Then `npm update` will install `dep1@0.4.1`, because that is the highest-sorting version that satisfies `^0.4.0` (`>= 0.4.0 <0.5.0`) -### Recording Updates with `--save` - -When you want to update a package and save the new version as -the minimum required dependency in `package.json`, you can use -`npm update -S` or `npm update --save`. For example if -`package.json` contains: - -``` -"dependencies": { - "dep1": "^1.1.1" -} -``` - -Then `npm update --save` will install `dep1@1.2.2` (i.e., `latest`), -and `package.json` will be modified: - -``` -"dependencies": { - "dep1": "^1.2.2" -} -``` - -Note that `npm` will only write an updated version to `package.json` -if it installs a new package. ### Updating Globally-Installed Packages |