`split-debuginfo` documentation contradiction

[meadowsys]

On rustc documentation, it says that split-debuginfo is packed by default. On cargo documentation, it says that split-debuginfo is unpacked by default. Is this an accidental contradition or one of them was left outdated, or is there something that I am missing on it?

[SylvainDe]

When you "default", do you mean "default for Windows MSVC and macOS" ?

From what I can find in the history, the following changes are relevant:

• rust-lang/rust@a124043#diff-6e9a08e032c83ccfc4b967a192b6d38c932eaaf6a153027bd79365830e4d7139 (28 Jan 2021)

• a4f0988#diff-966a7f9211f3b74dfc458e945a35a005552facf16738e49994f93d9cd48bb985 (26 Mar 2021)

[ehuss]

The default for rustc is different from cargo.

[meadowsys]

When you "default", do you mean "default for Windows MSVC and macOS" ?

From what I can find in the history, the following changes are relevant:

• a124043#diff-6e9a08e032c83ccfc4b967a192b6d38c932eaaf6a153027bd79365830e4d7139 (28 Jan 2021)
• rust-lang/cargo@a4f0988#diff-966a7f9211f3b74dfc458e945a35a005552facf16738e49994f93d9cd48bb985 (26 Mar 2021)

hmm, I was referring specifically to the macOS defaults. I did not check Windows, since I am on a macOS machine, so I only looked at that one

The default for rustc is different from cargo.

ah, if this is the case that would make sense, so calling cargo would yield a different result than calling rustc directly if I understand correctly. If this is the case, then maybe adding a note on cargo's documentation saying that its defaults are different than rustc would be helpful?

many edits for wording, and suggesting adding a note on documentation
and another edit: oops! I forgot to specify that I was referring that specifically I noticed macOS defaults seemed to contradict

[weihanglo]

Transferred to rust-lang/cargo so it won't be lost in the future.

I think it's good to have a one line notice at the end of this section. Perhaps something like

Note that Cargo and rustc might have differents defaults for split-debuginfo. This is preserved for Cargo to experiment on different combination of flags, for providing better debugging and developer experience.

@rustbot label +S-accepted +E-easy +C-bug +A-documenting-cargo-itself +A-profile -T-cargo