doc(man): add temp-target-dir variable

diff --git a/src/doc/man/cargo-install.md b/src/doc/man/cargo-install.md
index 3e1bc02fe946e742a705d6f02ac5d6b71e419fcb..95f55002134aed40acc0de0136a2ab3a02b54ccb 100644 (file)
--- a/src/doc/man/cargo-install.md
+++ b/src/doc/man/cargo-install.md
@@ -1,5 +1,6 @@
 # cargo-install(1)
 {{*set actionverb="Install"}}
+{{*set temp-target-dir=true}}
 
 ## NAME
 

diff --git a/src/doc/man/includes/options-target-dir.md b/src/doc/man/includes/options-target-dir.md
index 009790425cca813a6a6295c6693b45bbc8d8a67f..b3117fcf48a4538f67253b481a2883d35b3abb05 100644 (file)
--- a/src/doc/man/includes/options-target-dir.md
+++ b/src/doc/man/includes/options-target-dir.md
@@ -1,6 +1,9 @@
 {{#option "`--target-dir` _directory_"}}
 Directory for all generated artifacts and intermediate files. May also be
 specified with the `CARGO_TARGET_DIR` environment variable, or the
-`build.target-dir` [config value](../reference/config.html). Defaults
-to `target` in the root of the workspace.
+`build.target-dir` [config value](../reference/config.html).
+{{#if temp-target-dir}} Defaults to a new temporary folder located in the
+temporary directory of the platform.
+{{else}} Defaults to `target` in the root of the workspace.
+{{/if}}
 {{/option}}