docs: document v10.4 features

jpbnetley · Feb 14, 2025 · 6589629 · 6589629
1 parent 88beeca
commit 6589629
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 0 deletions.
diff --git a/docs/cli/add.md b/docs/cli/add.md
@@ -211,6 +211,21 @@ Install a package globally.
 
 Only adds the new dependency if it is found in the workspace.
 
+
+### --allow-build
+
+Added in: v10.4.0
+
+A list of package names that are allowed to run postinstall scripts during installation.
+
+Example:
+
+```
+pnpm --allow-build=esbuild add my-bundler
+```
+
+This will run `esbuild`'s postinstall script and also add it to the `pnpm.onlyBuiltDependencies` field of `package.json`. So, `esbuild` will always be allowed to run its scripts in the future.
+
 ### --filter &lt;package_selector\>
 
 [Read more about filtering.](../filtering.md)
diff --git a/docs/cli/approve-builds.md b/docs/cli/approve-builds.md
@@ -6,3 +6,12 @@ title: pnpm approve-builds
 Added in: v10.1.0
 
 Approve dependencies for running scripts during installation.
+
+## Options
+
+### --global, -g
+
+Added in: v10.4.0
+
+Approve dependencies of globally installed packages.
+
diff --git a/docs/npmrc.md b/docs/npmrc.md
@@ -809,6 +809,14 @@ This flag does not prevent the execution of [.pnpmfile.cjs](./pnpmfile.md)
 
 Do not execute any scripts of the installed packages. Scripts of the projects are executed.
 
+:::note
+
+Since v10, pnpm doesn't run the lifecycle scripts of dependencies unless they are listed in the [`pnpm.onlyBuiltDependencies`] field of `package.json`.
+
+:::
+
+[`pnpm.onlyBuiltDependencies`]: package_json.md#pnpmonlybuiltdependencies
+
 ### child-concurrency
 
 * Default: **5**