diff --git a/clang/include/clang/Options/Options.td b/clang/include/clang/Options/Options.td index 756d6deed7130..d31bd7d6be322 100644 --- a/clang/include/clang/Options/Options.td +++ b/clang/include/clang/Options/Options.td @@ -4765,25 +4765,25 @@ def ggdb3 : Flag<["-"], "ggdb3">, Group; def glldb : Flag<["-"], "glldb">, Group; def gsce : Flag<["-"], "gsce">, Group; def gdbx : Flag<["-"], "gdbx">, Group; -// Equivalent to our default dwarf version. Forces usual dwarf emission when +// Equivalent to our default DWARF version. Forces usual DWARF emission when // CodeView is enabled. def gdwarf : Flag<["-"], "gdwarf">, Group, Visibility<[ClangOption, CLOption, DXCOption, FlangOption]>, - HelpText<"Generate source-level debug information with the default dwarf version">; + HelpText<"Generate source-level debug information with the default DWARF version">; let Visibility = [ClangOption, FlangOption] in { def gdwarf_2 : Flag<["-"], "gdwarf-2">, Group, - HelpText<"Generate source-level debug information with dwarf version 2">; + HelpText<"Generate source-level debug information with DWARF version 2">; def gdwarf_3 : Flag<["-"], "gdwarf-3">, Group, - HelpText<"Generate source-level debug information with dwarf version 3">; + HelpText<"Generate source-level debug information with DWARF version 3">; def gdwarf_4 : Flag<["-"], "gdwarf-4">, Group, - HelpText<"Generate source-level debug information with dwarf version 4">; + HelpText<"Generate source-level debug information with DWARF version 4">; def gdwarf_5 : Flag<["-"], "gdwarf-5">, Group, - HelpText<"Generate source-level debug information with dwarf version 5">; + HelpText<"Generate source-level debug information with DWARF version 5">; def gdwarf_6 : Flag<["-"], "gdwarf-6">, Group, - HelpText<"Generate source-level debug information with dwarf version 6">; + HelpText<"Generate source-level debug information with DWARF version 6">; } def gdwarf64 : Flag<["-"], "gdwarf64">, Group, Visibility<[ClangOption, CC1Option, CC1AsOption]>, @@ -4793,7 +4793,7 @@ def gdwarf32 : Flag<["-"], "gdwarf32">, Group, Visibility<[ClangOption, CC1Option, CC1AsOption]>, HelpText<"Enables DWARF32 format for ELF binaries, if debug information emission is enabled.">; -def gcodeview : Flag<["-"], "gcodeview">, +def gcodeview : Flag<["-"], "gcodeview">, Group, HelpText<"Generate CodeView debug information">, Visibility<[ClangOption, CC1Option, CC1AsOption, CLOption, DXCOption]>, MarshallingInfoFlag>; @@ -4801,17 +4801,20 @@ defm codeview_ghash : BoolOption<"g", "codeview-ghash", CodeGenOpts<"CodeViewGHash">, DefaultFalse, PosFlag, - NegFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>; + NegFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>, + Group; defm codeview_command_line : BoolOption<"g", "codeview-command-line", CodeGenOpts<"CodeViewCommandLine">, DefaultTrue, PosFlag, NegFlag, - BothFlags<[], [ClangOption, CLOption, DXCOption, CC1Option]>>; + BothFlags<[], [ClangOption, CLOption, DXCOption, CC1Option]>>, + Group; defm inline_line_tables : BoolGOption<"inline-line-tables", CodeGenOpts<"NoInlineLineTables">, DefaultFalse, NegFlag, - PosFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>; + PosFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>, + Group; def gfull : Flag<["-"], "gfull">, Group; def gused : Flag<["-"], "gused">, Group; @@ -4836,7 +4839,8 @@ defm strict_dwarf : BoolOption<"g", "strict-dwarf", defm omit_unreferenced_methods : BoolGOption<"omit-unreferenced-methods", CodeGenOpts<"DebugOmitUnreferencedMethods">, DefaultFalse, NegFlag, - PosFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>; + PosFlag, BothFlags<[], [ClangOption, CLOption, DXCOption]>>, + Group; defm column_info : BoolOption<"g", "column-info", CodeGenOpts<"DebugColumnInfo">, DefaultTrue, NegFlag, @@ -4903,6 +4907,7 @@ defm structor_decl_linkage_names "Attach linkage names to C++ constructor/destructor " "declarations in DWARF.">, BothFlags<[], [ClangOption, CLOption, CC1Option]>>, + Group, DocBrief<[{On some ABIs (e.g., Itanium), constructors and destructors may have multiple variants. Historically, when generating DWARF, Clang did not attach ``DW_AT_linkage_name`` to structor DIEs because there were multiple possible manglings (depending on the structor variant) that could be used. With ``-gstructor-decl-linkage-names``, for ABIs with structor variants, we attach a "unified" mangled name to structor declarations DIEs which debuggers can use to look up all the definitions for a structor declaration. E.g., a "unified" mangled name ``_ZN3FooC4Ev`` may have multiple definitions associated with it such as ``_ZN3FooC1Ev`` and ``_ZN3FooC2Ev``. Enabling this flag results in a better interactive debugging experience (both GDB and LLDB have support for understanding these "unified" linkage names). However, it comes with a significant increase in debug-info size (particularly the `.debug_str` section). As an escape hatch, users can disable this feature using ``-gno-structor-decl-linkage-names``.}]>; @@ -4911,7 +4916,8 @@ defm key_instructions : BoolGOption<"key-instructions", NegFlag, PosFlag, - BothFlags<[], [ClangOption, CLOption, CC1Option]>>; + BothFlags<[], [ClangOption, CLOption, CC1Option]>>, + Group; def headerpad__max__install__names : Joined<["-"], "headerpad_max_install_names">; def help : Flag<["-", "--"], "help">, Visibility<[ClangOption, CC1Option, CC1AsOption, @@ -8530,7 +8536,7 @@ def main_file_name : Separate<["-"], "main-file-name">, Visibility<[CC1Option, CC1AsOption]>, MarshallingInfoString>; def split_dwarf_output : Separate<["-"], "split-dwarf-output">, - HelpText<"File name to use for split dwarf debug info output">, + HelpText<"File name to use for split DWARF debug info output">, Visibility<[CC1Option, CC1AsOption, FC1Option]>, MarshallingInfoString>; @@ -8564,7 +8570,7 @@ def dependent_lib : Joined<["--"], "dependent-lib=">, MarshallingInfoStringVector>; def split_dwarf_file : Separate<["-"], "split-dwarf-file">, - HelpText<"Name of the split dwarf debug info file to encode in the object file">, + HelpText<"Name of the split DWARF debug info file to encode in the object file">, MarshallingInfoString>; } // let Visibility = [CC1Option, FC1Option]