Skip to content

Commit 03f11e8

Browse files
committed
Auto merge of #8125 - ehuss:doc-config-toml, r=alexcrichton
Add note about .cargo/config support. I think it would be good to have some mention that Cargo also supports `.cargo/config` files. This is still the predominant way Cargo is used, and there is a ton of documentation, projects, and examples that still use the old form.
2 parents 1638705 + d20d395 commit 03f11e8

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

src/doc/src/reference/config.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,11 @@ together. Numbers, strings, and booleans will use the value in the deeper
3030
config directory taking precedence over ancestor directories, where the
3131
home directory is the lowest priority. Arrays will be joined together.
3232

33+
> **Note:** Cargo also reads config files without the `.toml` extension, such as
34+
> `.cargo/config`. Support for the `.toml` extension was added in version 1.39
35+
> and is the preferred form. If both files exist, Cargo will use the file
36+
> without the extension.
37+
3338
### Configuration format
3439

3540
Configuration files are written in the [TOML format][toml] (like the

0 commit comments

Comments
 (0)