From 94a1217789e9bb2cbc2fc42cf72f1d30f97c3195 Mon Sep 17 00:00:00 2001 From: Weihang Lo Date: Fri, 11 Aug 2023 17:22:00 +0100 Subject: [PATCH] doc: note the backward compatible `.cargo/credential` file exists --- src/doc/src/reference/config.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/doc/src/reference/config.md b/src/doc/src/reference/config.md index ae80deff14f..d1f2b04d35e 100644 --- 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__TOKEN` where `` 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