[doc/book] Improve page titles

diff --git a/src/doc/book/src/03-02-manifest.md b/src/doc/book/src/03-02-manifest.md
index a5d25e77bd46b894e2c01dab82f0ccff2effc3a0..2b2367ad662b1b77e41bea7cc0ef4088a7b0e637 100644 (file)
--- a/src/doc/book/src/03-02-manifest.md
+++ b/src/doc/book/src/03-02-manifest.md
@@ -1,5 +1,8 @@
 ## The Manifest Format
 
+The `Cargo.toml` file for each package is called its *manifest*. Every manifest
+file consists of one or more sections.
+
 ### The `[package]` section
 
 The first section in a `Cargo.toml` is `[package]`.

diff --git a/src/doc/book/src/03-05-build-scripts.md b/src/doc/book/src/03-05-build-scripts.md
index 9b7367c4c559e1a5a389cb175bc550f54e088570..6d775ed1bf6d9db188a0b25cda919bf1ac53b012 100644 (file)
--- a/src/doc/book/src/03-05-build-scripts.md
+++ b/src/doc/book/src/03-05-build-scripts.md
@@ -1,4 +1,4 @@
-## Build Script Support
+## Build Scripts
 
 Some packages need to compile third-party non-Rust code, for example C
 libraries. Other packages need to link to C libraries which can either be

diff --git a/src/doc/book/src/03-08-source-replacement.md b/src/doc/book/src/03-08-source-replacement.md
index dcb88346d020f2613db8954b9f3316289dc3a290..8407bc0e679e104ec92bfcf330c94d0423f66ceb 100644 (file)
--- a/src/doc/book/src/03-08-source-replacement.md
+++ b/src/doc/book/src/03-08-source-replacement.md
@@ -1,4 +1,4 @@
-## Replacing sources
+## Source Replacement
 
 Cargo supports the ability to **replace one source with another** to express
 strategies along the lines of mirrors or vendoring dependencies. Configuration

diff --git a/src/doc/book/src/03-10-policies.md b/src/doc/book/src/03-10-policies.md
index f6565d305ade2ba9265ea03a1e436d716c370441..9d48d095f9e71f4f5c0836252c9d4f4f368b623b 100644 (file)
--- a/src/doc/book/src/03-10-policies.md
+++ b/src/doc/book/src/03-10-policies.md
@@ -1,4 +1,4 @@
-## Crates.io package policies
+## Crates.io Package Policies
 
 In general, these policies are guidelines. Problems are often contextual, and
 exceptional circumstances sometimes require exceptional measures. We plan to

diff --git a/src/doc/book/src/SUMMARY.md b/src/doc/book/src/SUMMARY.md
index ab4028d2ff20316317b0dff722d16e1edb1b194e..b5b7dd30674f4a39e4d773f8cbb9b26b09dc853e 100644 (file)
--- a/src/doc/book/src/SUMMARY.md
+++ b/src/doc/book/src/SUMMARY.md
@@ -18,14 +18,14 @@
 
 * [Cargo In Depth](cargo-in-depth.md)
     * [Specifying Dependencies](03-01-specifying-dependencies.md)
-    * [Cargo.toml Format](03-02-manifest.md)
+    * [The Manifest Format](03-02-manifest.md)
     * [Configuration](03-03-config.md)
     * [Environment Variables](03-04-environment-variables.md)
     * [Build Scripts](03-05-build-scripts.md)
     * [Publishing on crates.io](03-06-crates-io.md)
-    * [Package ID specs](03-07-pkgid-spec.md)
+    * [Package ID Specifications](03-07-pkgid-spec.md)
     * [Source Replacement](03-08-source-replacement.md)
     * [External Tools](03-09-external-tools.md)
-    * [Policies](03-10-policies.md)
+    * [Crates.io Package Policies](03-10-policies.md)
 
 [FAQ](faq.md)

diff --git a/src/doc/book/src/cargo-in-depth.md b/src/doc/book/src/cargo-in-depth.md
index b367ccba3dd23b512870c2bfd77c163c5185084e..e4a749fee9ac801a05433ff935c714b4968bfc95 100644 (file)
--- a/src/doc/book/src/cargo-in-depth.md
+++ b/src/doc/book/src/cargo-in-depth.md
@@ -5,11 +5,11 @@ crate, you may be interested in more details in the following areas.
 
 * [Reading about all the possible ways of specifying dependencies](03-01-specifying-dependencies.html)
 * [Learning more details about what you can specify in your `Cargo.toml` manifest](03-02-manifest.html)
-* [Configuration](03-03-config.html)
-* [Environment Variables](03-04-environment-variables.html)
-* [Build Scripts](03-05-build-scripts.html)
+* [Learn how Cargo's Configuration system works](03-03-config.html)
+* [Environment Variables that Cargo sets and reads](03-04-environment-variables.html)
+* [Build Script Support](03-05-build-scripts.html)
 * [Publishing your crate on crates.io](03-06-crates-io.html)
-* [Package ID specs](03-07-pkgid-spec.html)
-* [Source Replacement](03-08-source-replacement.html)
-* [External Tools](03-09-external-tools.html)
-* [Policies](03-10-policies.html)
+* [Package ID Specifications](03-07-pkgid-spec.html)
+* [Learn how to replace one source with another](03-08-source-replacement.html)
+* [Integration with external tools, like IDEs and other build systems](03-09-external-tools.html)
+* [Crates.io Package Policies](03-10-policies.html)