Auto merge of #14657 - ehuss:deprecate-build-plan, r=epage

Document build-plan as being deprecated

This adds a note to the build-plan documentation that it is deprecated. I do not think it will make any progress as it is. In the future, we should remove the feature (#7902), possibly with a code-warning ahead of time.

Author: bors

src/doc/src/reference/unstable.md

@@ -254,6 +254,13 @@ cargo test --target foo -Zdoctest-xcompile
 ## Build-plan
 * Tracking Issue: [#5579](https://github.com/rust-lang/cargo/issues/5579)
 
+<div class="warning">
+
+> The build-plan feature is deprecated and may be removed in a future version.
+> See <https://github.com/rust-lang/cargo/issues/7614>.
+
+</div>
+
 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.