Skip to content

Commit 526d679

Browse files
Merge pull request #10670 from MicrosoftDocs/main638780024555868842sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 9ea91f5 + d9d2e32 commit 526d679

14 files changed

+439
-9
lines changed

docs/debugger/cpp-dynamic-debugging.md

Lines changed: 402 additions & 0 deletions
Large diffs are not rendered by default.

docs/debugger/how-to-debug-optimized-code.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,22 +23,24 @@ ms.subservice: debug-diagnostics
2323
---
2424
# Debug Optimized Code
2525

26+
This article explains which compiler switches to set to enable you to debug optimized code better.
27+
28+
A better experience is available starting in Visual Studio 2022 version 17.14 that allows you to debug optimized code as if it were compiled unoptimized, while retaining the speed of optimized code. For more information, see [C++ Dynamic Debugging (Preview)](cpp-dynamic-debugging.md).
29+
2630
> [!NOTE]
2731
> The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, choose **Import and Export Settings** on the **Tools** menu. For more information, see [Reset all settings](../ide/personalizing-the-visual-studio-ide.md#reset-all-settings).
2832
2933
> [!NOTE]
30-
> The [/Zo (Enhance Optimized Debugging)](/cpp/build/reference/zo-enhance-optimized-debugging) compiler option (introduced in Visual Studio Update 3) generates richer debugging information for optimized code (projects that are not built with the **/Od** compiler option. See [/O Options (Optimize Code)](/cpp/build/reference/o-options-optimize-code)). This includes improved support for debugging local variables and inlined functions.
34+
> The [/Zo (Enhance Optimized Debugging)](/cpp/build/reference/zo-enhance-optimized-debugging) compiler option (introduced in Visual Studio Update 3) generates richer debugging information for optimized code (projects that aren't built with the **/Od** compiler option. See [/O Options (Optimize Code)](/cpp/build/reference/o-options-optimize-code)). This includes improved support for debugging local variables and inlined functions.
3135
>
3236
> [Edit and Continue](../debugger/edit-and-continue-visual-csharp.md) is disabled when the **/Zo** compiler option is used.
3337
34-
When the compiler optimizes code, it repositions and reorganizes instructions. This results in more efficient compiled code. Because of this rearrangement, the debugger cannot always identify the source code that corresponds to a set of instructions.
38+
When the compiler optimizes code, it repositions and reorganizes instructions. This results in more efficient compiled code. Because of this rearrangement, the debugger can't always identify the source code that corresponds to a set of instructions.
3539

3640
Optimization can affect:
3741

38-
- Local variables, which can be removed by the optimizer or moved to locations the debugger does not understand.
39-
42+
- The optimizer can remove local variables or move them to locations that the debugger doesn't understand.
4043
- Positions inside a function, which are changed when the optimizer merges blocks of code.
41-
4244
- Function names for frames on the call stack, which might be wrong if the optimizer merges two functions.
4345

4446
The frames that you see on the call stack are almost always correct, however, assuming you have symbols for all frames. The frames on the call stack will be wrong if you have stack corruption, if you have functions written in assembly language, or if there are operating system frames without matching symbols on the call stack.
@@ -51,7 +53,7 @@ ms.subservice: debug-diagnostics
5153

5254
## To turn on optimization in a Debug build configuration
5355

54-
1. When you create a new project, select the `Win32 Debug` target. Use the `Win32 Debug` target until your program is fully debugged and you are ready to build a `Win32 Release` target. The compiler does not optimize the `Win32 Debug` target.
56+
1. When you create a new project, select the `Win32 Debug` target. Use the `Win32 Debug` target until your program is fully debugged and you're ready to build a `Win32 Release` target. The compiler doesn't optimize the `Win32 Debug` target.
5557

5658
2. Select the project in Solution Explorer.
5759

@@ -71,9 +73,9 @@ ms.subservice: debug-diagnostics
7173

7274
> [!WARNING]
7375
>
74-
> Adding `/Zo` will disable [Edit and Continue](../debugger/edit-and-continue-visual-csharp.md).
76+
> Adding `/Zo` disables [Edit and Continue](../debugger/edit-and-continue-visual-csharp.md).
7577
76-
When you debug optimized code, use the **Disassembly** window to see what instructions are actually created and executed. When you set breakpoints, you need to know that the breakpoint might move together with an instruction. For example, consider the following code:
78+
When you debug optimized code, use the **Disassembly** window to see what instructions are created and executed. When you set breakpoints, you need to know that the breakpoint might move together with an instruction. For example, consider the following code:
7779

7880
```cpp
7981
for (x=0; x<10; x++)
33.9 KB
Loading
30.6 KB
Loading
20.9 KB
Loading
47.9 KB
Loading
26.9 KB
Loading
18.5 KB
Loading
70.6 KB
Loading
34 KB
Loading

0 commit comments

Comments
 (0)