-Z split-dwarf-kind={single,split} is undocumented in the unstable book

[jieyouxu]

Implementation history:

• In rustc: Stabilize -Z run-dsymutil as -C split-debuginfo #79570:
  • -Z split-dwarf=single became -C split-debuginfo=packed
  • -Z split-dwarf=split became -C split-debuginfo=unpacked
• However, as @davidtwco noted in 08ed338 (cg: split dwarf for crate dependencies #89819):

  In rustc: Stabilize -Zrun-dsymutil as -Csplit-debuginfo #79570, -Z split-dwarf-kind={none,single,split} was replaced by -C split-debuginfo={off,packed,unpacked}. -C split-debuginfo's packed and unpacked aren't exact parallels to single and split, respectively.

• As such, cg: split dwarf for crate dependencies #89819 introduced -Z split-dwarf-kind={single,split} to fill in the gap.

This unstable compiler flag doesn't seem to have an entry in the unstable book, I only discovered them while looking at tests/run-make/split-debuginfo. It would be nice to document its behavior and also the meaning of its values.

[davidtwco]

Some extra details that might be useful to anyone interested in writing this up if I don't eventually do it:

• -Zsplit-dwarf-kind=single puts the split debuginfo into the regular object files, but in a separate section so that the linker doesn't process them (just as it doesn't when the debug info in a different file and it doesn't see it at all)
• -Zsplit-dwarf-kind=split is what we do by default today - the split debuginfo is in the separate DWARF object files.

[jieyouxu]

Oh I think there's also a caveat where the target platform has to actually support the split-dwarf-kind, otherwise sometimes they become a no-op I think