Release/v8.5.2

CHANGELOG.md

@@ -1,3 +1,68 @@
+## v8.5.2 (2022-02-24)
+
+### Bug Fixes
+
+* [`9bdd1ace8`](https://github.com/npm/cli/commit/9bdd1ace86300a8ee562027bbc5cb57d62dc7ba8)
+  [#4300](https://github.com/npm/cli/pull/4300)
+  fix(arborist): use full location as tracker key when inflating
+  ([@lukekarrys](https://github.com/lukekarrys)) ([@kirtangajjar](https://github.com/kirtangajjar))
+* [`c9ff797e8`](https://github.com/npm/cli/commit/c9ff797e8b5e5a7b39ced04b1d3f8a0006993a1f)
+  [#4457](https://github.com/npm/cli/pull/4457)
+  fix: remove html comments from man entries
+  ([@wraithgar](https://github.com/wraithgar))
+* [`f4c5f0e52`](https://github.com/npm/cli/commit/f4c5f0e52679b1aa42db833fc23dc07d96cc904e)
+  fix(arborist): fix unescaped periods (#4462)
+  ([@lukekarrys](https://github.com/lukekarrys))
+* [`c608512ed`](https://github.com/npm/cli/commit/c608512ed03ccf87dc989cec2849d14bf034513a)
+  [#4468](https://github.com/npm/cli/pull/4468)
+  fix: ignore integrity values for git dependencies
+  ([@lukekarrys](https://github.com/lukekarrys))
+
+### Documentation
+
+* [`e83e5c9ba`](https://github.com/npm/cli/commit/e83e5c9bad93e598969088ae780149dbe34c6b5c)
+  [#4435](https://github.com/npm/cli/pull/4435)
+  docs: clarify npm init @latest behavior
+  ([@wraithgar](https://github.com/wraithgar))
+* [`d8fa9fa5e`](https://github.com/npm/cli/commit/d8fa9fa5e44d91e1c0170628d4839f7802c65a7f)
+  [#4436](https://github.com/npm/cli/pull/4436)
+  docs: explain $INIT_CWD on using scripts page
+  ([@wraithgar](https://github.com/wraithgar))
+* [`6b68c1aaa`](https://github.com/npm/cli/commit/6b68c1aaa282205eb4d47dbc81909c11851f7e06)
+  [#4450](https://github.com/npm/cli/pull/4450)
+  docs: auto-generate npm usage for each command
+  ([@manekinekko](https://github.com/manekinekko))
+
+### Dependencies
+
+* [`d58e4442b`](https://github.com/npm/cli/commit/d58e4442b0a16c84219d5f80ab88ef68ad209918)
+  deps `@npmcli/[email protected]`
+* [`77399cb98`](https://github.com/npm/cli/commit/77399cb988d984133bfc2885a6407ffc56b9152d)
+  deps: `[email protected]`
+* [`9633752cd`](https://github.com/npm/cli/commit/9633752cd5c4a0d240adcb24f0ae7e3fafd122ba)
+  deps: `[email protected]`
+* [`938750581`](https://github.com/npm/cli/commit/9387505819f0e7e4b3d76dd3e2bd8636a1bb6306)
+  deps: `[email protected]`
+* [`2c86feaf1`](https://github.com/npm/cli/commit/2c86feaf1f974ee510563c7d93c0dd26f6355b15)
+  deps: `[email protected]`
+* [`1dab29805`](https://github.com/npm/cli/commit/1dab29805c820f82e4bae18123e911fec6948dfd)
+  deps: `[email protected]`
+* [`cf273f1cf`](https://github.com/npm/cli/commit/cf273f1cf31775c8a73cc67b654faf87b44f7f79)
+  deps: `[email protected]`
+* [`8b1d9636a`](https://github.com/npm/cli/commit/8b1d9636ad2374254263d154f2b4ca8ea6416f4c)
+  deps: `[email protected]`
+* [`67aed0542`](https://github.com/npm/cli/commit/67aed05429163fc120e05e6fb15f8f3cd9c6ef22)
+  deps: `[email protected]`
+* [`8b26a6db1`](https://github.com/npm/cli/commit/8b26a6db13c37a6f0df86c54ca859ad2f9627825)
+  deps: `[email protected]`
+* [`0b2fa7fed`](https://github.com/npm/cli/commit/0b2fa7feda4643fe16c9a492497908f94d310dbd)
+  deps: `[email protected]`
+* [`2646d199f`](https://github.com/npm/cli/commit/2646d199f26f77c4197ec0bcf30c3e452844c1ab)
+  deps: `[email protected]`
+* [`5b29666e5`](https://github.com/npm/cli/commit/5b29666e566c09dc685108daaa20163dd58ade2b)
+  [#4459](https://github.com/npm/cli/pull/4459)
+  deps: `[email protected] and dedupe vulnerable deps`
+
 ## v8.5.1 (2022-02-17)
 
 ### Dependencies

docs/content/commands/npm-access.md

@@ -6,21 +6,27 @@ description: Set access level on published packages
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/access.js -->
+
 ```bash
 npm access public [<package>]
 npm access restricted [<package>]
-
 npm access grant <read-only|read-write> <scope:team> [<package>]
 npm access revoke <scope:team> [<package>]
-
 npm access 2fa-required [<package>]
 npm access 2fa-not-required [<package>]
-
 npm access ls-packages [<user>|<scope>|<scope:team>]
 npm access ls-collaborators [<package> [<user>]]
 npm access edit [<package>]
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/access.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 Used to set access controls on private packages.

docs/content/commands/npm-adduser.md

@@ -6,12 +6,21 @@ description: Add a registry user account
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/adduser.js -->
+
 ```bash
-npm adduser [--registry=url] [--scope=@orgname] [--auth-type=legacy]
+npm adduser
 
 aliases: login, add-user
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/adduser.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-audit.md

@@ -6,13 +6,19 @@ description: Run a security audit
 
 ### Synopsis
 
-```bash
-npm audit [--json] [--production] [--audit-level=(low|moderate|high|critical)]
-npm audit fix [--force|--package-lock-only|--dry-run|--production|--only=(dev|prod)]
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/audit.js -->
 
-common options: [--production] [--only=(dev|prod)]
+```bash
+npm audit [fix]
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/audit.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 The audit command submits a description of the dependencies configured in

docs/content/commands/npm-bin.md

@@ -6,10 +6,19 @@ description: Display npm bin folder
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/bin.js -->
+
 ```bash
-npm bin [-g|--global]
+npm bin
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/bin.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-bugs.md

@@ -6,12 +6,21 @@ description: Report bugs for a package in a web browser
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/bugs.js -->
+
 ```bash
-npm bugs [<pkgname> [<pkgname> ...]]
+npm bugs [<pkgname>]
 
-aliases: issues
+alias: issues
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/bugs.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 This command tries to guess at the likely location of a package's bug

docs/content/commands/npm-cache.md

@@ -6,18 +6,26 @@ description: Manipulates packages cache
 
 ### Synopsis
 
-```bash
-npm cache add <tarball file>...
-npm cache add <folder>...
-npm cache add <tarball url>...
-npm cache add <name>@<version>...
-
-npm cache clean
-aliases: npm cache clear, npm cache rm
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/cache.js -->
 
+```bash
+npm cache add <tarball file>
+npm cache add <folder>
+npm cache add <tarball url>
+npm cache add <git url>
+npm cache add <name>@<version>
+npm cache clean [<key>]
+npm cache ls [<name>@<version>]
 npm cache verify
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/cache.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-ci.md

@@ -6,10 +6,21 @@ description: Install a project with a clean slate
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/ci.js -->
+
 ```bash
 npm ci
+
+aliases: clean-install, ic, install-clean, isntall-clean
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/ci.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 This command is similar to [`npm install`](/commands/npm-install), except

docs/content/commands/npm-completion.md

@@ -6,10 +6,19 @@ description: Tab Completion for npm
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/completion.js -->
+
 ```bash
-source <(npm completion)
+npm completion
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/completion.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-config.md

@@ -6,18 +6,25 @@ description: Manage the npm configuration files
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/config.js -->
+
 ```bash
 npm config set <key>=<value> [<key>=<value> ...]
 npm config get [<key> [<key> ...]]
 npm config delete <key> [<key> ...]
 npm config list [--json]
 npm config edit
-npm set <key>=<value> [<key>=<value> ...]
-npm get [<key> [<key> ...]]
 
 alias: c
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/config.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-dedupe.md

@@ -6,13 +6,21 @@ description: Reduce duplication in the package tree
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/dedupe.js -->
+
 ```bash
 npm dedupe
-npm ddp
 
-aliases: ddp
+alias: ddp
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/dedupe.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 Searches the local package tree and attempts to simplify the overall
@@ -145,6 +153,24 @@ When package package-locks are disabled, automatic pruning of extraneous
 modules will also be disabled. To remove extraneous modules with
 package-locks disabled use `npm prune`.
 
+This configuration does not affect `npm ci`.
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
+#### `save`
+
+* Default: `true` unless when using `npm update` or `npm dedupe` where it
+  defaults to `false`
+* Type: Boolean
+
+Save installed packages to a `package.json` file as dependencies.
+
+When used with the `npm rm` command, removes the dependency from
+`package.json`.
+
+Will also prevent writing to `package-lock.json` if set to `false`.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

docs/content/commands/npm-deprecate.md

@@ -6,10 +6,19 @@ description: Deprecate a version of a package
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/deprecate.js -->
+
 ```bash
-npm deprecate <pkg>[@<version range>] <message>
+npm deprecate <pkg>[@<version>] <message>
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/deprecate.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 Note: This command is unaware of workspaces.
 
 ### Description

docs/content/commands/npm-diff.md

@@ -6,14 +6,19 @@ description: The registry diff command
 
 ### Synopsis
 
+<!-- AUTOGENERATED USAGE DESCRIPTIONS START -->
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/diff.js -->
+
 ```bash
 npm diff [...<paths>]
-npm diff --diff=<pkg-name> [...<paths>]
-npm diff --diff=<version-a> [--diff=<version-b>] [...<paths>]
-npm diff --diff=<spec-a> [--diff=<spec-b>] [...<paths>]
-npm diff [--diff-ignore-all-space] [--diff-name-only] [...<paths>]
 ```
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/commands/diff.js -->
+
+<!-- AUTOGENERATED USAGE DESCRIPTIONS END -->
+
 ### Description
 
 Similar to its `git diff` counterpart, this command will print diff patches