CLI documentation update from CI

Author: npm-cli-bot

Diff for: content/cli/v10/commands/npm-audit.md

@@ -63,6 +63,13 @@ vulnerability is found. It may be useful in CI environments to include the
 will cause the command to fail. This option does not filter the report
 output, it simply changes the command's failure threshold.
 
+### Package lock
+
+By default npm requires a package-lock or shrinkwrap in order to run the
+audit.  You can bypass the package lock with `--no-package-lock` but be
+aware the results may be different with every run, since npm will
+re-build the dependency tree each time.
+
 ### Audit Signatures
 
 To ensure the integrity of packages you download from the public npm registry, or any registry that supports signatures, you can verify the registry signatures of downloaded packages using the npm CLI.
@@ -352,6 +359,16 @@ For `list` this means the output will be based on the tree described by the
 
 
 
+#### `package-lock`
+
+* Default: true
+* Type: Boolean
+
+If set to false, then ignore `package-lock.json` files when installing. This
+will also prevent _writing_ `package-lock.json` if `save` is true.
+
+
+
 #### `omit`
 
 * Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -372,6 +389,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `foreground-scripts`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-ci.md

@@ -163,6 +163,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `strict-peer-deps`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-dedupe.md

@@ -199,6 +199,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `ignore-scripts`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-doctor.md

@@ -1,7 +1,7 @@
 ---
 title: npm-doctor
 section: 1
-description: Check your npm environment
+description: Check the health of your npm environment
 github_repo: npm/cli
 github_branch: latest
 github_path: docs/lib/content/commands/npm-doctor.md

Diff for: content/cli/v10/commands/npm-find-dupes.md

@@ -139,6 +139,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `ignore-scripts`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-init.md

@@ -187,6 +187,56 @@ dot to represent the current directory in that context, e.g: `react-app .`:
 
 ### Configuration
 
+#### `init-author-name`
+
+* Default: ""
+* Type: String
+
+The value `npm init` should use by default for the package author's name.
+
+
+
+#### `init-author-url`
+
+* Default: ""
+* Type: "" or URL
+
+The value `npm init` should use by default for the package author's
+homepage.
+
+
+
+#### `init-license`
+
+* Default: "ISC"
+* Type: String
+
+The value `npm init` should use by default for the package license.
+
+
+
+#### `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/npm/init-package-json) module for
+more information, or [npm init](/cli/v10/commands/npm-init).
+
+
+
+#### `init-version`
+
+* Default: "1.0.0"
+* Type: SemVer string
+
+The value that `npm init` should use by default for the package version
+number, if not already set in package.json.
+
+
+
 #### `yes`
 
 * Default: null

Diff for: content/cli/v10/commands/npm-install-ci-test.md

@@ -109,6 +109,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `strict-peer-deps`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-install-test.md

@@ -150,6 +150,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `strict-peer-deps`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-install.md

@@ -540,6 +540,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `strict-peer-deps`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-link.md

@@ -272,6 +272,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `ignore-scripts`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-ls.md

@@ -58,7 +58,7 @@ packages will *also* show the paths to the specified packages.  For
 example, running `npm ls promzard` in npm's source tree will show:
 
 ```bash
-npm@10.1.0 /path/to/npm
+npm@10.2.0 /path/to/npm
 └─┬ [email protected]
   └── [email protected]
 ```
@@ -196,6 +196,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `link`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-prune.md

@@ -86,6 +86,20 @@ variable will be set to `'production'` for all lifecycle scripts.
 
 
 
+#### `include`
+
+* Default:
+* Type: "prod", "dev", "optional", or "peer" (can be set multiple times)
+
+Option that allows for defining which types of dependencies to install.
+
+This is the inverse of `--omit=<type>`.
+
+Dependency types specified in `--include` will not be omitted, regardless of
+the order in which omit/include are specified on the command-line.
+
+
+
 #### `dry-run`
 
 * Default: false

Diff for: content/cli/v10/commands/npm-query.md

@@ -166,6 +166,19 @@ npm query ":type(git)" | jq 'map(.name)' | xargs -I {} npm why {}
   },
   ...
 ```
+### Package lock only mode
+
+If package-lock-only is enabled, only the information in the package
+lock (or shrinkwrap) is loaded.  This means that information from the
+package.json files of your dependencies will not be included in the
+result set (e.g. description, homepage, engines).
+
+### Package lock only mode
+
+If package-lock-only is enabled, only the information in the package
+lock (or shrinkwrap) is loaded.  This means that information from the
+package.json files of your dependencies will not be included in the
+result set (e.g. description, homepage, engines).
 
 ### Configuration
 
@@ -237,6 +250,22 @@ all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
 This value is not exported to the environment for child processes.
+
+#### `package-lock-only`
+
+* Default: false
+* Type: Boolean
+
+If set to true, the current operation will only use the `package-lock.json`,
+ignoring `node_modules`.
+
+For `update` this means only the `package-lock.json` will be updated,
+instead of checking `node_modules` and downloading dependencies.
+
+For `list` this means the output will be based on the tree described by the
+`package-lock.json`, rather than the contents of `node_modules`.
+
+
 ## See Also
 
 * [dependency selectors](/cli/v10/using-npm/dependency-selectors)