Merge pull request #5607 from Mikejo5000/mikejo-br15

Jak-MS · web-flow · commit 1507baf3a336 · 2019-10-15T11:37:29.000-05:00
Debugger updates
diff --git a/docs/debugger/create-custom-views-of-native-objects.md b/docs/debugger/create-custom-views-of-native-objects.md
@@ -14,7 +14,7 @@ manager: jillfra
 ms.workload:
   - "cplusplus"
 ---
-# Create custom views of C++ objects in the debugger
+# Create custom views of C++ objects in the debugger using the Natvis framework
 
 The Visual Studio *Natvis* framework customizes the way native types appear in debugger variable windows, such as the **Locals** and **Watch** windows, and in **DataTips**. Natvis visualizations can help make the types you create more visible during debugging.
 
diff --git a/docs/debugger/debugger-feature-tour.md b/docs/debugger/debugger-feature-tour.md
@@ -196,6 +196,14 @@ The Exception Helper is a great feature that can help you debug errors. You can
 
 Expand the **Exception Settings** node to see more options on how to handle this exception type, but you don't need to change anything for this tour!
 
+## Configure debugging
+
+You can configure your project to build as a [Debug or Release configuration](../debugger/how-to-set-debug-and-release-configurations.md), configure project properties for debugging, or configure [general settings](../debugger/how-to-specify-debugger-settings.md) for debugging. In addition, you can configure the debugger to display custom information using features such as [DebuggerDisplay](using-the-debuggerdisplay-attribute.md) attribute or, for C/C++, the [NatVis framework](create-custom-views-of-native-objects.md).
+
+Debugging properties are specific to each project type. For example, you can specify an argument to pass to the application when you start it. You can access the project-specific properties by right-clicking the project in Solution Explorer and selecting **Properties**. Debugging properties typically appear in the **Build** or **Debug** tab, depending on the particular project type.
+
+![Project properties](../debugger/media/dbg-tour-project-properties.png "Project properties")
+
 ## Debug live ASP.NET apps in Azure App Service
 
 the **Snapshot Debugger** takes a snapshot of your in-production apps when code that you are interested in executes. To instruct the debugger to take a snapshot, you set snappoints and logpoints in your code. The debugger lets you see exactly what went wrong, without impacting traffic of your production application. The Snapshot Debugger can help you dramatically reduce the time it takes to resolve issues that occur in production environments.
diff --git a/docs/debugger/debugger-settings-and-preparation.md b/docs/debugger/debugger-settings-and-preparation.md
@@ -25,6 +25,10 @@ This section describes the debugger-related property settings, and the preparati
  For more information, see [How to: Set Debug and Release Configurations](../debugger/how-to-set-debug-and-release-configurations.md).
 
 ## In This Section
+
+ [How to: Specify Debugger Settings](../debugger/how-to-specify-debugger-settings.md)
+ Describes debugger settings in the **Options** dialog box.
+ 
  [Debugger Project Settings](../debugger/debugger-project-settings.md)
  Explains how to specify debugger settings, how to set debug and release configurations, and how to manage symbols and source code. Also describes appropriate project settings for C++, C#, F#, and Visual Basic debug configurations, as well as web projects.
 
diff --git a/docs/debugger/find-your-debugging-task.md b/docs/debugger/find-your-debugging-task.md
@@ -59,6 +59,12 @@ If you want to pause and debug code while examining execution flow or viewing fu
 
 You can do this by [setting a breakpoint from the Disassembly window](using-breakpoints.md#BKMK_Set_a_breakpoint_from_debugger_windows).
 
+## Execute code
+
+### Learn the commands to step through your code while debugging
+
+For more information, see [Navigate code with the debugger](navigating-through-code-with-the-debugger.md).
+
 ## Inspect data
 
 ### Check the value of variables while running your app
@@ -73,19 +79,7 @@ Set a watch on the variable. For more information, see [Set a watch on variables
 
 Open the built-in [string visualizer](view-strings-visualizer.md) while debugging.
 
-## Additional tasks
-
-### Learn the commands to step through your code while debugging
-
-For more information, see [Navigate code with the debugger](navigating-through-code-with-the-debugger.md).
-
-### Edit code during a debugging session
-
-Use [Edit and continue](edit-and-continue.md). For XAML, use [XAML Hot Reload](xaml-hot-reload.md).
-
-### Send messages to the Output window without modifying code
-
-Set a tracepoint. For more information, see [Using tracepoints](using-tracepoints.md).
+## Configure debugging
 
 ### Customize information shown in the debugger
 
@@ -97,6 +91,16 @@ For native C++, use the [NatVis framework](create-custom-views-of-native-objects
 
 To configure debugger options and debugger project settings, see [Debugger settings and preparation](debugger-settings-and-preparation.md).
 
+## Additional tasks
+
+### Edit code during a debugging session
+
+Use [Edit and continue](edit-and-continue.md). For XAML, use [XAML Hot Reload](xaml-hot-reload.md).
+
+### Send messages to the Output window without modifying code
+
+Set a tracepoint. For more information, see [Using tracepoints](using-tracepoints.md).
+
 ### Debug on remote machines
 
 See [Remote debugging](remote-debugging.md).
diff --git a/docs/debugger/index.yml b/docs/debugger/index.yml
@@ -24,8 +24,6 @@ landingContent:
         links:
           - text: What is debugging?
             url: what-is-debugging.md
-          - text: Debugging techniques and tools
-            url: write-better-code-with-visual-studio.md
           - text: First look at the debugger
             url: debugger-feature-tour.md
           - text: Find your debugging task
diff --git a/docs/debugger/media/dbg-tour-project-properties.png b/docs/debugger/media/dbg-tour-project-properties.png
diff --git a/docs/debugger/toc.yml b/docs/debugger/toc.yml
@@ -44,8 +44,6 @@
     items:
     - name: Use breakpoints
       href: using-breakpoints.md
-    - name: Use tracepoints
-      href: using-tracepoints.md
     - name: Troubleshooting breakpoints
       href: troubleshooting-breakpoints.md
   - name: Data inspection
@@ -138,6 +136,8 @@
         href: xaml-hot-reload-troubleshooting.md
     - name: Edit and Continue not supported for F#
       href: edit-and-continue-not-supported-for-f-hash.md
+  - name: Log to Output window
+    href: using-tracepoints.md
   - name: View debugger data
     items:
     - name: Modules
diff --git a/docs/debugger/using-the-debuggerdisplay-attribute.md b/docs/debugger/using-the-debuggerdisplay-attribute.md
@@ -14,6 +14,7 @@ ms.workload:
   - "multiple"
 ---
 # Tell the debugger what to show using the DebuggerDisplay Attribute (C#, Visual Basic, F#, C++/CLI)
+
 The <xref:System.Diagnostics.DebuggerDisplayAttribute> controls how an object, property, or field is displayed in the debugger variable windows. This attribute can be applied to types, delegates, properties, fields, and assemblies. If applied to a base type, the attribute also applies to a subclass.
 
 The `DebuggerDisplay` attribute has a single argument, which is a string to be displayed in the value column for instances of the type. This string can contain braces (`{` and `}`). Text within a pair of braces is evaluated as a field, property or method.
