Skip to content

Commit 4b71075

Browse files
authored
Merge pull request #422 from Microsoft/mikejo-updates
Content updates for multithreading
2 parents 29ad191 + e307341 commit 4b71075

13 files changed

+422
-64
lines changed

docs/debugger/TOC.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -121,10 +121,11 @@
121121
### [Error: Mixed-mode debugging for x64 processes is supported only when using Microsoft .NET Framework 4 or greater](error-mixed-mode-debugging-for-x64-processes-is-supported-only-when-using-microsoft-dotnet-framework-4-or-greater.md)
122122
### [Error: Remote machine does not appear in a Remote Connections dialog](error-remote-machine-does-not-appear-in-a-remote-connections-dialog.md)
123123
# [Debug Multithreaded Applications in Visual Studio](debug-multithreaded-applications-in-visual-studio.md)
124-
## [Get Started Debugging Multithreaded Applications](how-to-use-the-threads-window.md)
124+
## [Get Started Debugging Multithreaded Applications](get-started-debugging-multithreaded-apps.md)
125125
## [Tools to Debug Threads and Processes](debug-threads-and-processes.md)
126126
## [Debug Multiple Processes](debug-multiple-processes.md)
127-
## [Walkthrough: Debugging a Parallel Application](walkthrough-debugging-a-parallel-application.md)
127+
## [Walkthrough: Debug Using the Threads Window](how-to-use-the-threads-window.md)
128+
## [Walkthrough: Debug a Parallel Application](walkthrough-debugging-a-parallel-application.md)
128129
## [How to: Switch to Another Thread While Debugging](how-to-switch-to-another-thread-while-debugging.md)
129130
## [How to: Flag and Unflag Threads](how-to-flag-and-unflag-threads.md)
130131
## [How to: Use the Parallel Stacks Window](using-the-parallel-stacks-window.md)

docs/debugger/debug-multithreaded-applications-in-visual-studio.md

Lines changed: 27 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ In addition, multithreading introduces some new types of potential bugs. Often,
5050

5151
Visual Studio provides different tools for use in debugging multithreaded apps.
5252

53-
- For threads, the primary tools for debugging threads are the **Threads** window, thread markers in source windows, **Parallel Stacks** window, **Parallel Watch** window, and the **Debug Location** toolbar. To get started, see [Get started debugging a multithreaded application](../debugger/how-to-use-the-threads-window.md) and [Using the Parallel Stacks window](../debugger/using-the-parallel-stacks-window.md).
53+
- For threads, the primary tools for debugging threads are the **Threads** window, thread markers in source windows, **Parallel Stacks** window, **Parallel Watch** window, and the **Debug Location** toolbar. To get started, see [Get started debugging a multithreaded application](../debugger/get-started-debugging-multithreaded-apps.md) and [Walkthrough: Debug using the Threads Window](../debugger/how-to-use-the-threads-window.md).
5454

5555
- For code that uses the [Task Parallel Library (TPL)](http://msdn.microsoft.com/Library/b8f99f43-9104-45fd-9bff-385a20488a23) or the [Concurrency Runtime](/cpp/parallel/concrt/concurrency-runtime/), the primary tools for debugging multithreaded applications are the **Parallel Stacks** window, the **Parallel Watch** window, and the **Tasks** window (the **Tasks** window also supports JavaScript). To get started, see [Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md) and [Walkthrough: Debugging a C++ AMP Application](http://msdn.microsoft.com/Library/40e92ecc-f6ba-411c-960c-b3047b854fb5).
5656

@@ -60,16 +60,25 @@ Visual Studio provides different tools for use in debugging multithreaded apps.
6060

6161
Debugging a multithreaded application that has a user interface can be especially difficult. In that case, you might consider running the application on a second computer and using remote debugging. For information, see [Remote Debugging](../debugger/remote-debugging.md).
6262

63-
## In This Section
64-
[Get started debugging a multithreaded application](../debugger/using-the-tasks-window.md).
65-
A guided tour of thread debugging features, with emphasis on features in the **Threads** window [!INCLUDE[vs_orcas_long](../debugger/includes/vs_orcas_long_md.md)].
63+
## In This Section
64+
[Get started debugging a multithreaded application](../debugger/get-started-debugging-multithreaded-apps.md).
65+
A guided tour of thread debugging features, with emphasis on features in the **Threads** window [!INCLUDE[vs_orcas_long](../debugger/includes/vs_orcas_long_md.md)].
6666

67-
[Debug Threads and Processes](../debugger/debug-threads-and-processes.md)
68-
Explains the basics of debugging threads and processes.
67+
[Tools for Debugging Threads and Processes](../debugger/debug-threads-and-processes.md)
68+
Lists the features of the tools for debugging threads and processes.
6969

7070
[Debug Multiple Processes](../debugger/debug-multiple-processes.md)
7171
Explains how to debug multiple processes.
7272

73+
[Walkthrough: Debug using the Threads Window](../debugger/how-to-use-the-threads-window.md).
74+
A guided tour of thread debugging features, with emphasis on features in the **Threads** window [!INCLUDE[vs_orcas_long](../debugger/includes/vs_orcas_long_md.md)].
75+
76+
[Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md)
77+
Walkthrough that shows how to use the Parallel Tasks and Parallel Stacks windows.
78+
79+
[How to: Use the Parallel Stack Window](../debugger/using-the-parallel-stacks-window.md)
80+
Inspect values and expressions across multiple threads.
81+
7382
[How to: Use the Parallel Watch Window](../debugger/how-to-use-the-parallel-watch-window.md)
7483
Inspect values and expressions across multiple threads.
7584

@@ -80,28 +89,25 @@ Visual Studio provides different tools for use in debugging multithreaded apps.
8089
Three ways to switch the debugging context to another thread.
8190

8291
[How to: Flag and Unflag Threads](../debugger/how-to-flag-and-unflag-threads.md)
83-
Mark or flag threads that you want to give special attention to while debugging.
84-
85-
[How to: Set a Thread Name in Native Code](../debugger/how-to-set-a-thread-name-in-native-code.md)
86-
Give your thread a name that you view in the **Threads** window.
87-
88-
[How to: Set a Thread Name in Managed Code](../debugger/how-to-set-a-thread-name-in-managed-code.md)
89-
Give your thread a name that you view in the **Threads** window.
92+
Mark or flag threads that you want to give special attention to while debugging.
9093

9194
[How to: Debug On a High-Performance Cluster](../debugger/how-to-debug-on-a-high-performance-cluster.md)
9295
Techniques for debugging an application that runs on a high-performance cluster.
9396

94-
[Tips for Debugging Threads in Native Code](../debugger/tips-for-debugging-threads-in-native-code.md)
95-
Simple techniques that can be useful for debugging native threads.
96-
9797
[Using the Tasks Window](../debugger/using-the-tasks-window.md)
98-
Shows a list of all the managed or native task objects including their status and other useful info.
99-
100-
[Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md)
101-
Walkthrough that shows how to use the Parallel Tasks and Parallel Stacks windows.
98+
Shows a list of all the managed or native task objects including their status and other useful info.
10299

103100
[How to: Use the GPU Threads Window](../debugger/how-to-use-the-gpu-threads-window.md)
104-
Examine and work with threads that are running on the GPU during debugging.
101+
Examine and work with threads that are running on the GPU during debugging.
102+
103+
[Tips for Debugging Threads in Native Code](../debugger/tips-for-debugging-threads-in-native-code.md)
104+
Simple techniques that can be useful for debugging native threads.
105+
106+
[How to: Set a Thread Name in Native Code](../debugger/how-to-set-a-thread-name-in-native-code.md)
107+
Give your thread a name that you view in the **Threads** window.
108+
109+
[How to: Set a Thread Name in Managed Code](../debugger/how-to-set-a-thread-name-in-managed-code.md)
110+
Give your thread a name that you view in the **Threads** window.
105111

106112
## Related Sections
107113
[Using Breakpoints](../debugger/using-breakpoints.md)

docs/debugger/debugger-windows.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Debugger Windows in Visual Studio | Microsoft Docs"
33
ms.custom: "H1Hack27Feb2017"
4-
ms.date: "11/04/2016"
4+
ms.date: "04/25/2017"
55
ms.reviewer: ""
66
ms.suite: ""
77
ms.technology:
@@ -37,24 +37,24 @@ You can open most debugger windows while you are debugging your program. To see
3737
|**Window**|**Hotkey**|**See Topic**|
3838
|Breakpoints|CTRL+ALT+B|[Use Breakpoints](../debugger/using-breakpoints.md)|
3939
|Exception Settings|CTRL+ALT+E|[Manage Exceptions with the Debugger](../debugger/managing-exceptions-with-the-debugger.md)|
40-
|Output|CTRL+ALT+O|[Output Window](../ide/reference/output-window.md)|
41-
|GPU Threads|-|[How to: Use the GPU Threads Window](../debugger/how-to-use-the-gpu-threads-window.md)|
42-
|Tasks|CTR:+SHIFT+D, K|[Using the Tasks Window](../debugger/using-the-tasks-window.md)|
43-
|Parallel Stacks|CTR:+SHIFT+D, S|[Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)|
44-
|Parallel Watch|CTR:+SHIFT+D, (1, 2, 3, 4)|[Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)|
40+
|Output|CTRL+ALT+O|[Output Window](../ide/reference/output-window.md)|
4541
|Watch|CTRL+ALT+W, (1, 2, 3, 4)|[Watch and QuickWatch Windows](../debugger/watch-and-quickwatch-windows.md)|
4642
|QuickWatch|SHIFT+F9|[Watch and QuickWatch Windows](../debugger/watch-and-quickwatch-windows.md)|
47-
|Auto|CTRL+ALT+V, A|[Autos and Locals Windows](../debugger/autos-and-locals-windows.md)|
43+
|Autos|CTRL+ALT+V, A|[Autos and Locals Windows](../debugger/autos-and-locals-windows.md)|
4844
|Locals|CTRL+ALT+V, L|[Autos and Locals Windows](../debugger/autos-and-locals-windows.md)|
49-
|Immediate|CTRL+ALT+I|[Immediate Window](../ide/reference/immediate-window.md)|
45+
|Call Stacks|CTRL+ALT+C|[How to: Use the Call Stack Window](../debugger/how-to-use-the-call-stack-window.md)|
46+
|Immediate|CTRL+ALT+I|[Immediate Window](../ide/reference/immediate-window.md)|
47+
|Parallel Stacks|CTR:+SHIFT+D, S|[Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)|
48+
|Parallel Watch|CTR:+SHIFT+D, (1, 2, 3, 4)|[Get started Debugging Multithreaded Applications](../debugger/get-started-debugging-multithreaded-apps.md)|
49+
|Threads|CTRL+ALT+H|[Debug using the Threads Window](../debugger/how-to-use-the-threads-window.md)|
50+
|Modules|CTRL+ALT+U|[How to: Use the Modules Window](../debugger/how-to-use-the-modules-window.md)|
51+
|GPU Threads|-|[How to: Use the GPU Threads Window](../debugger/how-to-use-the-gpu-threads-window.md)|
52+
|Tasks|CTR:+SHIFT+D, K|[Using the Tasks Window](../debugger/using-the-tasks-window.md)|
5053
|Python Debug Interactive|SHIFT+ALT+I|[Getting Started with PTVS: Interactive Python](../python/getting-started-with-ptvs-interactive-python.md)|
5154
|JavaScript Console|CTRL+ALT+V, C|[QuickStart: Debug JavaScript](../debugger/quickstart-debug-javascript-using-the-console.md)|
5255
|DOM Explorer|CTRL+ALT+V, D|[Debug layout using DOM Explorer](../debugger/debug-layout-using-dom-explorer.md)|
5356
|Live Visual Tree|-|[Inspect XAML properties while debugging](../debugger/inspect-xaml-properties-while-debugging.md)|
54-
|Live Property Explorer|-|[Inspect XAML properties while debugging](../debugger/inspect-xaml-properties-while-debugging.md)|
55-
|Call Stacks|CTRL+ALT+C|[How to: Use the Call Stack Window](../debugger/how-to-use-the-call-stack-window.md)|
56-
|Threads|CTRL+ALT+H|[How to: Use the Threads Window](../debugger/how-to-use-the-threads-window.md)|
57-
|Modules|CTRL+ALT+U|[How to: Use the Modules Window](../debugger/how-to-use-the-modules-window.md)|
57+
|Live Property Explorer|-|[Inspect XAML properties while debugging](../debugger/inspect-xaml-properties-while-debugging.md)|
5858
|Processes|CTRL+ALT+Z|[Debug Threads and Processes](../debugger/debug-threads-and-processes.md)|
5959
|Memory|CTRL+ALT+M, (1, 2, 3, 4)|[Memory Windows](../debugger/memory-windows.md)|
6060
|Disassembly|CTRL+ALT+D|[How to: Use the Disassembly Window](../debugger/how-to-use-the-disassembly-window.md)|

docs/debugger/diagnostic-messages-in-the-output-window.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,13 @@
11
---
2-
title: "Diagnostic Messages in the Output Window | Microsoft Docs"
2+
title: "Send Diagnostic Messages to the Output Window | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "11/04/2016"
4+
ms.date: "04/25/2017"
55
ms.reviewer: ""
66
ms.suite: ""
77
ms.technology:
88
- "vs-ide-debug"
99
ms.tgt_pltfrm: ""
1010
ms.topic: "article"
11-
f1_keywords:
12-
- "vs.output"
1311
dev_langs:
1412
- "CSharp"
1513
- "VB"
@@ -48,8 +46,8 @@ translation.priority.ht:
4846
- "zh-cn"
4947
- "zh-tw"
5048
---
51-
# Diagnostic Messages in the Output Window
52-
You can write run-time messages to the Output window using the Debug class or the Trace class, which are part of the <xref:System.Diagnostics> class library. Use the Debug class if you only output in the Debug version of your program. Use the Trace class if you want output in both the Debug and Release versions.
49+
# Send Diagnostic Messages to the Output Window
50+
You can write run-time messages to the **Output** window using the `Debug` class or the `Trace` class, which are part of the <xref:System.Diagnostics> class library. Use the Debug class if you only output in the Debug version of your program. Use the Trace class if you want output in both the Debug and Release versions.
5351

5452
## Output Methods
5553
The <xref:System.Diagnostics.Trace> and <xref:System.Diagnostics.Debug> classes provide the following output methods:
@@ -73,7 +71,6 @@ You can write run-time messages to the Output window using the Debug class or th
7371
## See Also
7472
[Debugger Security](../debugger/debugger-security.md)
7573
[Output Window](../ide/reference/output-window.md)
76-
[Tracing and Instrumenting Applications](http://msdn.microsoft.com/Library/773b6fc4-9013-4322-b728-5dec7a72e743)
77-
[Introduction to Instrumentation and Tracing](http://msdn.microsoft.com/en-us/e924e57c-33cf-4b0e-9e7f-a45d13e38f2c)
74+
[Tracing and Instrumenting Applications](http://msdn.microsoft.com/Library/773b6fc4-9013-4322-b728-5dec7a72e743)
7875
[C#, F#, and Visual Basic Project Types](../debugger/debugging-preparation-csharp-f-hash-and-visual-basic-project-types.md)
7976
[Debugging Managed Code](../debugger/debugging-managed-code.md)

0 commit comments

Comments
 (0)