## 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]`.
-## 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
-## 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
-## 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
* [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)
* [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)