Recover doc mention of sccache

Cherry-picked from 13bb7bd95b457f7383487cf8dcf476009939cfac which failed
to update the book and was replaced in
1271bb4de0c0e0a085be239c2418af9c673ffc87.

diff --git a/src/doc/src/guide/build-cache.md b/src/doc/src/guide/build-cache.md
new file mode 100644 (file)
index 0000000..f3b62e7
--- /dev/null
+++ b/src/doc/src/guide/build-cache.md
@@ -0,0 +1,14 @@
+## Build cache
+
+Cargo shares build artifacts among all the packages of a single workspaces.
+Today, Cargo does not share build results across different workspaces, but 
+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.
+
+[sccache]: https://github.com/mozilla/sccache
+
+

diff --git a/src/doc/src/guide/index.md b/src/doc/src/guide/index.md
index d8bfda17c86c3318b7d5ccc6b2b12fce5df96733..c8a61b28df90659250d02db6e549438eada5d2e2 100644 (file)
--- a/src/doc/src/guide/index.md
+++ b/src/doc/src/guide/index.md
@@ -11,3 +11,4 @@ develop Rust projects.
 * [Cargo.toml vs Cargo.lock](guide/cargo-toml-vs-cargo-lock.html)
 * [Tests](guide/tests.html)
 * [Continuous Integration](guide/continuous-integration.html)
+* [Build Cache](guide/build-cache.html)