diff --git a/src/doc/rustc/src/codegen-options/index.md b/src/doc/rustc/src/codegen-options/index.md index 1883346430be0..077c322bd7736 100644 --- a/src/doc/rustc/src/codegen-options/index.md +++ b/src/doc/rustc/src/codegen-options/index.md @@ -497,19 +497,19 @@ point instructions in software. It takes one of the following values: This option controls the emission of "split debuginfo" for debug information that `rustc` generates. The default behavior of this option is platform-specific, and not all possible values for this option work on all -platform. Possible values are: +platforms. Possible values are: * `off` - This is the default for platforms with ELF binaries and windows-gnu - (not Windows MSVC and not macOS). This typically means that dwarf debug + (not Windows MSVC and not macOS). This typically means that DWARF debug information can be found in the final artifact in sections of the executable. This option is not supported on Windows MSVC. On macOS this options prevents the final execution of `dsymutil` to generate debuginfo. -* `packed` - This is the default for Windows MSVC and macOS platforms. The term +* `packed` - This is the default for Windows MSVC and macOS. The term "packed" here means that all the debug information is packed into a separate file from the main executable. On Windows MSVC this is a `*.pdb` file, on macOS this is a `*.dSYM` folder, and on other platforms this is a `*.dwp` - files. + file. * `unpacked` - This means that debug information will be found in separate files for each compilation unit (object file). This is not supported on @@ -517,7 +517,7 @@ platform. Possible values are: debug information. On other Unix platforms this means that `*.dwo` files will contain debug information. -Note that `packed` and `unpacked` gated behind `-Zunstable-options` on +Note that `packed` and `unpacked` are gated behind `-Z unstable-options` on non-macOS platforms at this time. ## target-cpu