Skip to content

Commit aec8868

Browse files
Merge pull request #13616 from Mikejo5000/mikejo-br24
Add context for running the remote debugger.
2 parents bbb9753 + da46c10 commit aec8868

File tree

2 files changed

+12
-8
lines changed

2 files changed

+12
-8
lines changed

docs/debugger/remote-debugging-cpp.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.subservice: debug-diagnostics
1818
---
1919
# Remote Debugging a C++ Project in Visual Studio
2020

21-
To debug a Visual Studio application on a different computer, install and run the remote tools on the computer where you will deploy your app, configure your project to connect to the remote computer from Visual Studio, and then deploy and run your app.
21+
To debug a Visual Studio application on a different computer, install and run the remote tools on the computer where you'll deploy your app, configure your project to connect to the remote computer from Visual Studio, and then deploy and run your app.
2222

2323
![Remote debugger components](../debugger/media/remote-debugger-client-apps.png "Remote_debugger_components")
2424

@@ -29,7 +29,7 @@ For information about remote debugging Universal Windows Apps (UWP), see [Debug
2929
The remote debugger is supported on Windows 7 and newer and versions of Windows Server starting with Windows Server 2008 Service Pack 2. For a complete list of requirements, see [Requirements](../debugger/remote-debugging.md#requirements_msvsmon).
3030

3131
> [!NOTE]
32-
> Debugging between two computers connected through a proxy is not supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries/regions is not recommended and may fail or be unacceptably slow.
32+
> Debugging between two computers connected through a proxy isn't supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries/regions isn't recommended and may fail or be unacceptably slow.
3333
3434
## Download and Install the remote tools
3535

@@ -40,6 +40,8 @@ The remote debugger is supported on Windows 7 and newer and versions of Windows
4040
4141
## <a name="BKMK_setup"></a> Set up the remote debugger
4242

43+
After you install the remote debugger, follow these steps.
44+
4345
[!INCLUDE [remote-debugger-configuration](../debugger/includes/remote-debugger-configuration.md)]
4446

4547
> [!NOTE]
@@ -99,7 +101,7 @@ The remote debugger is supported on Windows 7 and newer and versions of Windows
99101

100102
## Set Up Debugging with Remote Symbols
101103

102-
You should be able to debug your code with the symbols you generate on the Visual Studio computer. The performance of the remote debugger is much better when you use local symbols.
104+
You should be able to debug your code with the symbols you generate on the Visual Studio computer. The performance of the remote debugger is significantly better when you use local symbols.
103105

104106
If you must use remote symbols, you need to specify the remote symbols in Visual Studio by adding a Windows file share to the symbol search path in **Tools > Options > Debugging > Symbols**.
105107

docs/debugger/remote-debugging-csharp.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ For information about remote debugging Universal Windows Apps (UWP), see [Debug
2929
The remote debugger is supported on Windows 7 and newer and on versions of Windows Server starting with Windows Server 2008 Service Pack 2. For a complete list of requirements, see [Requirements](../debugger/remote-debugging.md#requirements_msvsmon).
3030

3131
> [!NOTE]
32-
> Debugging between two computers connected through a proxy is not supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries/regions is not recommended and may fail or be unacceptably slow.
32+
> Debugging between two computers connected through a proxy isn't supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries/regions isn't recommended and may fail or be unacceptably slow.
3333
3434
## Download and Install the remote tools
3535

@@ -40,18 +40,20 @@ The remote debugger is supported on Windows 7 and newer and on versions of Windo
4040
4141
## <a name="BKMK_setup"></a> Set up the remote debugger
4242

43+
After you install the remote debugger, follow these steps.
44+
4345
[!INCLUDE [remote-debugger-configuration](../debugger/includes/remote-debugger-configuration.md)]
4446

4547
> [!NOTE]
4648
> If you need to add permissions for additional users, change the authentication mode, or port number for the remote debugger, see [Configure the remote debugger](../debugger/remote-debugging.md#configure_msvsmon).
4749
4850
## <a name="remote_csharp"></a> Remote debug the project
4951

50-
The debugger cannot deploy Visual C# or Visual Basic desktop applications to a remote machine, but you can still debug them remotely as follows. The following procedure assumes that you want to debug it on a computer named **MJO-DL**, as shown in the illustration below.
52+
The debugger can't deploy Visual C# or Visual Basic desktop applications to a remote machine, but you can still debug them remotely as follows. The following procedure assumes that you want to debug it on a computer named **MJO-DL**, as shown in the illustration below.
5153

5254
1. Create a WPF project named **MyWpf**.
5355

54-
If you are trying to remote debug a MAUI app instead of WPF, see [Remote debug a .NET MAUI app on Windows](#remote-debug-a-net-maui-app-on-windows).
56+
If you're trying to remote debug a MAUI app instead of WPF, see [Remote debug a .NET MAUI app on Windows](#remote-debug-a-net-maui-app-on-windows).
5557

5658
2. Set a breakpoint somewhere in the code that is easily reached.
5759

@@ -86,7 +88,7 @@ The debugger cannot deploy Visual C# or Visual Basic desktop applications to a r
8688
**MJO-DL:4024** on Visual Studio 2019
8789
::: moniker-end
8890

89-
7. Make sure that **Enable native code debugging** is not selected.
91+
7. Make sure that **Enable native code debugging** isn't selected.
9092

9193
8. Build the project.
9294

@@ -95,7 +97,7 @@ The debugger cannot deploy Visual C# or Visual Basic desktop applications to a r
9597
10. Copy the executable that you just built from your Visual Studio computer to the newly created folder on the remote computer.
9698

9799
> [!CAUTION]
98-
> Do not make changes to the code or rebuild (or you must repeat this step). The executable you copied to the remote machine must exactly match your local source and symbols.
100+
> Don't make changes to the code or rebuild (or you must repeat this step). The executable you copied to the remote machine must exactly match your local source and symbols.
99101
100102
You can copy the project manually, use XCopy, Robocopy, PowerShell, or other options.
101103

0 commit comments

Comments
 (0)