diff --git a/src/doc/src/guide/build-cache.md b/src/doc/src/guide/build-cache.md
index d253b8acc4d..a84bbdf4b9f 100644
--- a/src/doc/src/guide/build-cache.md
+++ b/src/doc/src/guide/build-cache.md
@@ -7,8 +7,9 @@ a similar result can be achieved by using a third party tool, [sccache].
 To setup `sccache`, install it with `cargo install sccache` and set 
 `RUSTC_WRAPPER` environmental variable to `sccache` before invoking Cargo.
 If you use bash, it makes sense to add `export RUSTC_WRAPPER=sccache` to 
-`.bashrc`. Refer to sccache documentation for more details.
+`.bashrc`. Alternatively, you can set `build.rustc-wrapper` in the
+ [Cargo configuration][config]. Refer to sccache documentation for more
+ details.
 
 [sccache]: https://github.com/mozilla/sccache
-
-
+[config]: ../reference/config.md
diff --git a/src/doc/src/reference/config.md b/src/doc/src/reference/config.md
index cfd50c793a9..067a03faff9 100644
--- a/src/doc/src/reference/config.md
+++ b/src/doc/src/reference/config.md
@@ -130,6 +130,8 @@ debug = false
 [build]
 jobs = 1                  # number of parallel jobs, defaults to # of CPUs
 rustc = "rustc"           # the rust compiler tool
+rustc-wrapper = ".."      # run this wrapper instead of `rustc`; useful to set up a
+                          # build cache tool such as `sccache`
 rustdoc = "rustdoc"       # the doc generator tool
 target = "triple"         # build for the target triple (ignored by `cargo install`)
 target-dir = "target"     # path of where to place all generated artifacts
diff --git a/src/doc/src/reference/environment-variables.md b/src/doc/src/reference/environment-variables.md
index e32c52eac1e..28584760767 100644
--- a/src/doc/src/reference/environment-variables.md
+++ b/src/doc/src/reference/environment-variables.md
@@ -20,7 +20,8 @@ system:
   compiler instead.
 * `RUSTC_WRAPPER` — Instead of simply running `rustc`, Cargo will execute this
   specified wrapper instead, passing as its commandline arguments the rustc
-  invocation, with the first argument being rustc.
+  invocation, with the first argument being `rustc`. Useful to set up a build
+  cache tool such as `sccache`.
 * `RUSTDOC` — Instead of running `rustdoc`, Cargo will execute this specified
   `rustdoc` instance instead.
 * `RUSTDOCFLAGS` — A space-separated list of custom flags to pass to all `rustdoc`