doc: note the backward compatible .cargo/credential file exists

rust-lang · Aug 11, 2023 · 94a1217 · 94a1217
1 parent 3705df0
commit 94a1217
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/doc/src/reference/config.md b/src/doc/src/reference/config.md
@@ -318,6 +318,12 @@ be specified with environment variables of the form
 `CARGO_REGISTRIES_<name>_TOKEN` where `<name>` is the name of the registry in
 all capital letters.
 
+> **Note:** Cargo also reads and writes credential files without the `.toml`
+> extension, such as `.cargo/credentials`. Support for the `.toml` extension
+> was added in version 1.39. In version 1.68, Cargo writes to the file with the
+> extension by default. However, for backward compatibility reason, when both
+> files exist, Cargo will read and write the file without the extension.
+
 ### Configuration keys
 
 This section documents all configuration keys. The description for keys with