capital letters before lowercase letters, ensuring files like `Makefile` and
`Cargo.toml` are placed together. The trailing `.toml` was chosen to emphasize
the fact that the file is in the [TOML configuration
-format](https://github.com/toml-lang/toml).
+format](https://toml.io/).
Cargo does not allow other names such as `cargo.toml` or `Cargofile` to
emphasize the ease of how a Cargo repository can be identified. An option of
```
This is called a **manifest**, and it contains all of the metadata that Cargo
-needs to compile your package.
+needs to compile your package. This file is written in the [TOML] format
+(pronounced /tɑməl/).
Here’s what’s in `src/main.rs`:
Compiling in debug mode is the default for development. Compilation time is
shorter since the compiler doesn't do optimizations, but the code will run
slower. Release mode takes longer to compile, but the code will run faster.
+
+[TOML]: https://toml.io/
All of the `[lib]`, `[[bin]]`, `[[example]]`, `[[test]]`, and `[[bench]]`
sections in `Cargo.toml` support similar configuration for specifying how a
target should be built. The double-bracket sections like `[[bin]]` are
-array-of-table of [TOML](https://github.com/toml-lang/toml#array-of-tables),
+[array-of-table of TOML](https://toml.io/en/v1.0.0-rc.3#array-of-tables),
which means you can write more than one `[[bin]]` section to make several
executables in your crate. You can only specify one library, so `[lib]` is a
normal TOML table.
[build scripts]: build-scripts.md
[`-C linker`]: ../../rustc/codegen-options/index.md#linker
[override a build script]: build-scripts.md#overriding-build-scripts
-[toml]: https://github.com/toml-lang/toml
+[toml]: https://toml.io/
[incremental compilation]: profiles.md#incremental
[profile]: profiles.md
[libcurl format]: https://ec.haxx.se/usingcurl-proxies.html
## The Manifest Format
-The `Cargo.toml` file for each package is called its *manifest*. Every manifest
-file consists of the following sections:
+The `Cargo.toml` file for each package is called its *manifest*. It is written
+in the [TOML] format. Every manifest file consists of the following sections:
* [`cargo-features`](unstable.md) — Unstable, nightly-only features.
* [`[package]`](#the-package-section) — Defines a package.
[spdx-2.1-license-expressions]: https://spdx.org/spdx-specification-21-web-version#h.jxpfx0ykyb60
[spdx-license-list-3.6]: https://github.com/spdx/license-list-data/tree/v3.6
[SPDX site]: https://spdx.org/license-list
+[TOML]: https://toml.io/
<script>
(function() {