Skip to content

Commit 2df9518

Browse files
committed
Improve guidance for multithreaded debugging tools
1 parent bc85c4a commit 2df9518

11 files changed

+16
-468
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2335,6 +2335,11 @@
23352335
"redirect_url": "/visualstudio/ide/how-to-configure-projects-to-target-platforms",
23362336
"redirect_document_id": false
23372337
},
2338+
{
2339+
"source_path": "docs/debugger/debug-parallel-application.md",
2340+
"redirect_url": "/visualstudio/debugger/get-started-debugging-multithreaded-apps",
2341+
"redirect_document_id": true
2342+
},
23382343
{
23392344
"source_path": "docs/debugger/walkthrough-debugging-a-windows-form.md",
23402345
"redirect_url": "/visualstudio/debugger/debugger-feature-tour",

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,9 +41,9 @@ The existence of multiple processes enables a computer to perform more than one
4141

4242
Visual Studio provides different tools for use in debugging multithreaded apps.
4343

44-
- For threads, the primary tools for debugging threads are the **Threads** window, thread markers in source windows, the **Parallel Stacks** window, the **Parallel Watch** window, and the **Debug Location** toolbar. To learn about the **Threads** window and **Debug Location** toolbar, see [Walkthrough: Debug using the Threads window](../debugger/how-to-use-the-threads-window.md). To learn how to use the **Parallel Stacks** and **Parallel Watch** windows, see [Get started debugging a multithreaded application](../debugger/get-started-debugging-multithreaded-apps.md). Both topics show how to use thread markers.
44+
- For threads, the primary tools for debugging threads are the **Threads** window, thread markers in source windows, the **Parallel Stacks** window, the **Parallel Watch** window, and the **Debug Location** toolbar. To learn about the **Threads** window and **Debug Location** toolbar, see [Debug a deadlock using Threads view](../debugger/how-to-use-the-threads-window.md). To learn how to use the **Parallel Stacks** and **Parallel Watch** windows, see [Get started debugging a multithreaded application](../debugger/get-started-debugging-multithreaded-apps.md). Both topics show how to use thread markers.
4545

46-
- For code that uses the [Task Parallel Library (TPL)](/dotnet/standard/parallel-programming/task-parallel-library-tpl) or the [Concurrency Runtime](/cpp/parallel/concrt/concurrency-runtime/), the primary tools for debugging are the **Parallel Stacks** window, the **Parallel Watch** window, and the **Tasks** window, which 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](/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application).
46+
- For code that uses the [Task Parallel Library (TPL)](/dotnet/standard/parallel-programming/task-parallel-library-tpl) or the [Concurrency Runtime](/cpp/parallel/concrt/concurrency-runtime/), the primary tools for debugging are the **Parallel Stacks** window, the **Parallel Watch** window, and the **Tasks** window, which also supports JavaScript. To get started, see [Debug an async application (.NET)](../debugger/walkthrough-debugging-a-parallel-application.md) and [Walkthrough: Debugging a C++ AMP application](/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application).
4747

4848
- For debugging threads on the GPU, the primary tool is the **GPU Threads** window. See [How to: Use the GPU Threads window](../debugger/how-to-use-the-gpu-threads-window.md).
4949

docs/debugger/debug-parallel-application.md

Lines changed: 0 additions & 455 deletions
This file was deleted.

docs/debugger/debugger-windows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ You can open most debugger windows while you're debugging your program. To see a
2525
|Immediate|CTRL+ALT+I|[Immediate Window](../ide/reference/immediate-window.md)|
2626
|Parallel Stacks|CTR:+SHIFT+D, S|[Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)|
2727
|Parallel Watch|CTR:+SHIFT+D, (1, 2, 3, 4)|[Get started Debugging Multithreaded Applications](../debugger/get-started-debugging-multithreaded-apps.md)|
28-
|Threads|CTRL+ALT+H|[Debug using the Threads Window](../debugger/how-to-use-the-threads-window.md)|
28+
|Threads|CTRL+ALT+H|[Debug a deadlock using the Threads view](../debugger/how-to-use-the-threads-window.md)|
2929
|Modules|CTRL+ALT+U|[How to: Use the Modules Window](../debugger/how-to-use-the-modules-window.md)|
3030
|GPU Threads|-|[How to: Use the GPU Threads Window](../debugger/how-to-use-the-gpu-threads-window.md)|
3131
|Tasks|CTR:+SHIFT+D, K|[Using the Tasks Window](../debugger/using-the-tasks-window.md)|

docs/debugger/debugging-native-code.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,6 @@ The section covers some common debugging problems and techniques for native appl
4242

4343
[How to: Debug Injected Code](/cpp/windows/attributes/cpp-attributes-com-net#debug-injected-code.md) provides guidance on debugging code that uses attributes. Instructions include how to turn on Source Annotation, how to view injected code, and how to view the disassembly code at the current execution point.
4444

45-
[Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md) describes how to use the **Parallel Tasks** and **Parallel Stacks** tool windows to debug a parallel application.
46-
4745
## Related sections
4846

4947
[Prepare to debug C++ projects](../debugger/debugging-preparation-visual-cpp-project-types.md) provides links to topics that describe how to debug the native project types created by the C++ project templates.

docs/debugger/how-to-flag-and-unflag-threads.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,4 +56,4 @@ Flagged threads also receive special treatment in the **Thread** list on the **D
5656
## Related content
5757
- [Debug Multithreaded Applications](../debugger/debug-multithreaded-applications-in-visual-studio.md)
5858
- [Get started debugging multithreaded applications](../debugger/get-started-debugging-multithreaded-apps.md)
59-
- [Walkthrough: Debug multithreaded applications using the Threads window](../debugger/how-to-use-the-threads-window.md)
59+
- [Debug a dealock using the Threads view](../debugger/how-to-use-the-threads-window.md)

docs/debugger/how-to-use-the-threads-window.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -303,7 +303,7 @@ This walkthrough demonstrated the **Parallel Stacks** debugger window. Use this
303303

304304
## Related content
305305

306-
- [Debugging Multithreaded Applications](../debugger/walkthrough-debugging-a-parallel-application.md)
306+
- [Debug an async application (.NET)](../debugger/walkthrough-debugging-a-parallel-application.md)
307307
- [First look at the debugger](../debugger/debugger-feature-tour.md)
308308
- [Parallel Programming](/dotnet/standard/parallel-programming/index)
309309
- [Concurrency Runtime](/cpp/parallel/concrt/concurrency-runtime)

docs/debugger/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -310,8 +310,6 @@
310310
href: get-started-debugging-multithreaded-apps.md
311311
- name: Debug an async application
312312
href: walkthrough-debugging-a-parallel-application.md
313-
- name: Debug a parallel application
314-
href: debug-parallel-application.md
315313
- name: Debug using the Threads window
316314
href: how-to-use-the-threads-window.md
317315
- name: Tools to debug threads and processes

docs/debugger/using-the-parallel-stacks-window.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -244,7 +244,8 @@ These video tutorials demonstrate how you can use the Threads and Tasks views of
244244

245245
## Related content
246246
- [Get started debugging a multithreaded application](../debugger/get-started-debugging-multithreaded-apps.md)
247-
- [Walkthrough: Debug a parallel application](../debugger/walkthrough-debugging-a-parallel-application.md)
247+
- [Debug an async application (.NET)](../debugger/walkthrough-debugging-a-parallel-application.md)
248+
- [Debug a deadlock](../debugger/how-to-use-the-threads-window.md)
248249
- [Switch to Another Thread While Debugging in Visual Studio](../debugger/how-to-switch-to-another-thread-while-debugging.md)
249250
- [Debugging managed code](/visualstudio/debugger/)
250251
- [Parallel programming](/dotnet/standard/parallel-programming/index)

docs/debugger/using-the-tasks-window.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -110,9 +110,10 @@ The **Switch to Task** command makes the current task the active task. The **Swi
110110

111111
## Related content
112112

113+
- [Debug an async application (.NET)](../debugger/walkthrough-debugging-a-parallel-application.md)
114+
- [Debug a deadlock](../debugger/how-to-use-the-threads-window.md)
113115
- [First look at the debugger](../debugger/debugger-feature-tour.md)
114116
- [Debugging Managed Code](/visualstudio/debugger/)
115117
- [Parallel Programming](/dotnet/standard/parallel-programming/index)
116118
- [Concurrency Runtime](/cpp/parallel/concrt/concurrency-runtime)
117-
- [Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)
118-
- [Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md)
119+
- [Using the Parallel Stacks Window](../debugger/using-the-parallel-stacks-window.md)

0 commit comments

Comments
 (0)