diff --git a/src/doc/man/cargo-metadata.md b/src/doc/man/cargo-metadata.md
index a94d3005cc2..6792e3776cc 100644
--- a/src/doc/man/cargo-metadata.md
+++ b/src/doc/man/cargo-metadata.md
@@ -318,8 +318,10 @@ The JSON output has the following format:
         */
         "root": "file:///path/to/my-package#0.1.0",
     },
-    /* The absolute path to the build directory where Cargo places its output. */
+    /* The absolute path to the target directory where Cargo places its output. */
     "target_directory": "/path/to/my-package/target",
+    /* The absolute path to the build directory where Cargo places intermediate build artifacts. (unstable) */
+    "build_directory": "/path/to/my-package/build-dir",
     /* The version of the schema for this metadata structure.
        This will be changed if incompatible changes are ever made.
     */
diff --git a/src/doc/man/generated_txt/cargo-metadata.txt b/src/doc/man/generated_txt/cargo-metadata.txt
index a2fb4e094cc..4bb09938369 100644
--- a/src/doc/man/generated_txt/cargo-metadata.txt
+++ b/src/doc/man/generated_txt/cargo-metadata.txt
@@ -314,8 +314,10 @@ OUTPUT FORMAT
                    */
                    "root": "file:///path/to/my-package#0.1.0",
                },
-               /* The absolute path to the build directory where Cargo places its output. */
+               /* The absolute path to the target directory where Cargo places its output. */
                "target_directory": "/path/to/my-package/target",
+               /* The absolute path to the build directory where Cargo places intermediate build artifacts. (unstable) */
+               "build_directory": "/path/to/my-package/build-dir",
                /* The version of the schema for this metadata structure.
                   This will be changed if incompatible changes are ever made.
                */
diff --git a/src/doc/src/commands/cargo-metadata.md b/src/doc/src/commands/cargo-metadata.md
index 97cf03b2a07..420def90703 100644
--- a/src/doc/src/commands/cargo-metadata.md
+++ b/src/doc/src/commands/cargo-metadata.md
@@ -318,8 +318,10 @@ The JSON output has the following format:
         */
         "root": "file:///path/to/my-package#0.1.0",
     },
-    /* The absolute path to the build directory where Cargo places its output. */
+    /* The absolute path to the target directory where Cargo places its output. */
     "target_directory": "/path/to/my-package/target",
+    /* The absolute path to the build directory where Cargo places intermediate build artifacts. (unstable) */
+    "build_directory": "/path/to/my-package/build-dir",
     /* The version of the schema for this metadata structure.
        This will be changed if incompatible changes are ever made.
     */
diff --git a/src/etc/man/cargo-metadata.1 b/src/etc/man/cargo-metadata.1
index 9560e645e3d..df588ea4241 100644
--- a/src/etc/man/cargo-metadata.1
+++ b/src/etc/man/cargo-metadata.1
@@ -320,8 +320,10 @@ The JSON output has the following format:
         */
         "root": "file:///path/to/my\-package#0.1.0",
     },
-    /* The absolute path to the build directory where Cargo places its output. */
+    /* The absolute path to the target directory where Cargo places its output. */
     "target_directory": "/path/to/my\-package/target",
+    /* The absolute path to the build directory where Cargo places intermediate build artifacts. (unstable) */
+    "build_directory": "/path/to/my\-package/build\-dir",
     /* The version of the schema for this metadata structure.
        This will be changed if incompatible changes are ever made.
     */