aboutsummaryrefslogtreecommitdiff
path: root/clang/docs
diff options
context:
space:
mode:
authorAlexandre Ganea <aganea@havenstudios.com>2024-06-15 11:33:44 -0400
committerGitHub <noreply@github.com>2024-06-15 11:33:44 -0400
commit7cb5faf6da5a6f6335aca8a2532e5320ec434458 (patch)
treef68f6aef3523b3d6f3418f583f7f8a8b15055757 /clang/docs
parent961dd1ae5ea216024af3aa7d43a57c6b45a023ec (diff)
downloadllvm-7cb5faf6da5a6f6335aca8a2532e5320ec434458.zip
llvm-7cb5faf6da5a6f6335aca8a2532e5320ec434458.tar.gz
llvm-7cb5faf6da5a6f6335aca8a2532e5320ec434458.tar.bz2
[Clang][Driver] Expose `-fno-eliminate-unused-debug-types` to clang-cl (#95259)
This is used to set DebugInfoKind to "UnusedTypeInfo". This helps in the context of Unreal Engine and NATVIS files that reference unused otherwise `static constexpr` class members. See https://udn.unrealengine.com/s/question/0D5QP00000N012h0AB/fname-debug-visualizer-fails-to-work-with-the-clang-compiler This partially fixes https://github.com/llvm/llvm-project/issues/46924
Diffstat (limited to 'clang/docs')
-rw-r--r--clang/docs/UsersManual.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/clang/docs/UsersManual.rst b/clang/docs/UsersManual.rst
index 8e01ea1..d273102 100644
--- a/clang/docs/UsersManual.rst
+++ b/clang/docs/UsersManual.rst
@@ -3347,6 +3347,9 @@ below. If multiple flags are present, the last one is used.
By default, Clang does not emit type information for types that are defined
but not used in a program. To retain the debug info for these unused types,
the negation **-fno-eliminate-unused-debug-types** can be used.
+ This can be particulary useful on Windows, when using NATVIS files that
+ can reference const symbols that would otherwise be stripped, even in full
+ debug or standalone debug modes.
Controlling Macro Debug Info Generation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^