From: Eric Huss <eric@huss.org>
Date: Sun, 27 May 2018 22:59:29 +0000 (-0700)
Subject: Document unstable --build-plan
X-Git-Tag: archive/raspbian/0.35.0-2+rpi1~3^2^2^2^2^2^2^2~22^2^2~19^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=a46b541f7806d434a70670f60e9697388fe20eb6;p=cargo.git

Document unstable --build-plan
---

diff --git a/src/doc/src/reference/unstable.md b/src/doc/src/reference/unstable.md
index 6d206b78e..91a85c99b 100644
--- a/src/doc/src/reference/unstable.md
+++ b/src/doc/src/reference/unstable.md
@@ -254,3 +254,16 @@ for each optional dependency, implicit features get created for any optional
 dependencies where a feature of the same name is not defined. However, if
 a feature of the same name as a dependency is defined, that feature must
 include the dependency as a requirement, as `foo = ["crate:foo"]`.
+
+
+### Build-plan
+* Tracking Issue: [rust-lang/cargo#5579](https://github.com/rust-lang/cargo/issues/5579)
+
+The `--build-plan` argument for the `build` command will output JSON with
+information about which commands would be run without actually executing
+anything. This can be useful when integrating with another build tool.
+Example:
+
+```
+cargo +nightly build --build-plan -Z unstable-options
+```