Skip to content

Commit b4fb20d

Browse files
TylerMSFTTylerMSFT
authored andcommitted
alt-text updates
1 parent 9c475b8 commit b4fb20d

9 files changed

+73
-71
lines changed

docs/get-started/includes/git-source-control.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To associate your code with Git, you start by creating a new Git repository wher
2020

2121
1. In the **Create a Git repository** dialog box, sign in to GitHub.
2222

23-
:::image type="content" source="../media/vs-2022/git-create-repo.png" alt-text="Screenshot of the Create a Git Repository dialog window where you can sign in to GitHub.":::
23+
:::image type="content" source="../media/vs-2022/git-create-repo.png" alt-text="Screenshot of the Create a Git Repository dialog window where you create a new GitHub repository.":::
2424

2525
The repository name auto-populates based on your folder location. By default, your new repository is private, which means you're the only one who can access it.
2626

@@ -29,9 +29,9 @@ To associate your code with Git, you start by creating a new Git repository wher
2929
3030
1. Select **Create and Push**.
3131

32-
After you create your repository, you see status details in the status bar.
32+
After you create your repository, status details appear in the status bar.
3333

34-
:::image type="content" source="../media/vs-2022/git-new-private-repo-status-details.png" alt-text="Screenshot of the repo status bar that's below the Solution Explorer pane in Visual Studio.":::
34+
:::image type="content" source="../media/vs-2022/git-new-private-repo-status-details.png" alt-text="Screenshot of the repo status bar located below the Visual Studio Solution Explorer pane, showing the branch name and number of outstanding changes.":::
3535

3636
The first icon with the arrows shows how many outgoing/incoming commits are in your current branch. You can use this icon to pull any incoming commits or push any outgoing commits. You can also choose to view these commits first. To do so, select the icon, and then select **View Outgoing/Incoming**.
3737

docs/get-started/tutorial-console-cpp.md

Lines changed: 47 additions & 42 deletions
Large diffs are not rendered by default.

docs/linux/cmake-linux-configure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ When you do a build:
108108

109109
## Choose a Linux target
110110

111-
When you open a CMake project folder, Visual Studio parses the *CMakeLists.txt* file and specifies a Windows target of **x86-Debug**. To target a remote Linux system, you'll change the project settings based on your Linux compiler. For example, if you're using GCC on Linux and compiling with debug info, choose: **Linux-GCC-Debug** or **Linux-GCC-Release**.
111+
When you open a CMake project folder, Visual Studio parses the *CMakeLists.txt* file, and specifies a Windows target of **x86-Debug**. To target a remote Linux system, you'll change the project settings based on your Linux compiler. For example, if you're using GCC on Linux and compiling with debug info, choose: **Linux-GCC-Debug** or **Linux-GCC-Release**.
112112

113113
If you specify a remote Linux target, your source is copied to the remote system.
114114

docs/linux/connect-to-your-remote-linux-computer.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -64,11 +64,11 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste
6464

6565
1. In the Connection Manager dialog, choose the **Add** button to add a new connection.
6666

67-
![Screenshot showing CrossPlatform > C++ > Connection Manager selected under options, and the Add button highlighted.](media/settings_connectionmanager.png)
67+
![Screenshot showing CrossPlatform > C plus plus > Connection Manager selected under options, and the Add button highlighted.](media/settings_connectionmanager.png)
6868

6969
In either scenario, the **Connect to Remote System** window is displayed.
7070

71-
![Screenshot showing the Connect to Remote System window which has fields for the host name, port, user name, auth type, and password.](media/connect.png)
71+
![Screenshot showing the Connect to Remote System window which has fields for host name, port, user name, authentication type, and password.](media/connect.png)
7272

7373
1. Enter the following information:
7474

@@ -90,7 +90,7 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste
9090

9191
If the connection fails, the entry boxes that need to be changed are outlined in red.
9292

93-
![Screenshot showing a Connection Manager Error. The host name and port fields are outlined in red to indicate an error.](media/settings_connectionmanagererror.png)
93+
![Screenshot of the Connect to Remote System window with the host name and port fields outlined in red to indicate that they are incorrect.](media/settings_connectionmanagererror.png)
9494

9595
If you use key files for authentication, make sure the target machine's SSH server is running and configured properly.
9696

@@ -181,7 +181,7 @@ For example: `HostKeyAlgorithms ssh-dss,ssh-rsa`
181181

182182
You can enable logging to help troubleshoot connection problems. On the menu bar, select **Tools > Options**. In the **Options** dialog, select **Cross Platform > Logging**:
183183

184-
![Screenshot showing the Remote Logging screen with options to enable logging, log file location, and a checkbox indicating whether to log to the "Cross Platform Logging pane in the output window.](media/remote-logging-vs2019.png)
184+
![Screenshot of the Remote Logging screen with options to enable logging, log file location, and whether to log to the output window.](media/remote-logging-vs2019.png)
185185

186186
Logs include connections, all commands sent to the remote machine (their text, exit code and execution time), and all output from Visual Studio to the shell. Logging works for any cross-platform CMake project or MSBuild-based Linux project in Visual Studio.
187187

docs/linux/create-a-new-linux-project.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
title: "Create a Linux MSBuild C++ project in Visual Studio"
33
ms.date: "10/15/2020"
44
description: "Create a new MSBuild-based Linux project in Visual Studio."
5-
ms.assetid: 5d7c1d67-bc31-4f96-8622-2b4cf91372fd
65
---
76
# Create a Linux MSBuild C++ project in Visual Studio
87

@@ -25,7 +24,7 @@ To create a new Linux project in Visual Studio 2017, follow these steps:
2524
1. Select **File > New Project** in Visual Studio, or press **Ctrl + Shift + N**.
2625
1. Select the **Visual C++ > Cross Platform > Linux** node, and then select the project type to create. Enter a **Name** and **Location**, and choose **OK**.
2726

28-
![Screenshot showing the New Project dialog box with Visual C plus plus > Cross Platform > Linux selected, all of the project types called out, and the Name and Location text boxes also called out.](media/newproject.png)
27+
![The New Project dialog box with Visual C plus plus > Cross Platform > Linux selected and all project types and Name and Location text boxes called out.](media/newproject.png)
2928

3029
| Project Type | Description |
3130
| ------------ | --- |
@@ -52,7 +51,7 @@ To create a new Linux project in Visual Studio, follow these steps:
5251
1. In the **Search for templates** textbox, enter **Linux** to list the available templates for Linux projects.
5352
1. Select the project type to create, for example **Console Application**, and then choose **Next**. Enter a **Name** and **Location**, and choose **Create**.
5453

55-
![Screenshot of the new project dialog box with the language drop-down set to C++ and the platform drop-down set to Linux.](media/newproject-vs2019.png)
54+
![Screenshot of the new project dialog box with the language drop-down set to C plus plus and the platform drop-down set to Linux.](media/newproject-vs2019.png)
5655

5756
| Project Type | Description |
5857
| ------------ | --- |

docs/linux/deploy-run-and-debug-your-linux-project.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
title: "Deploy, run, and debug your Linux MSBuild C++ project in Visual Studio"
33
description: "Describes how to compile, execute, and debug code on the remote target from inside a MSBuild-based Linux C++ project in Visual Studio."
44
ms.date: "08/08/2020"
5-
ms.assetid: f7084cdb-17b1-4960-b522-f84981bea879
65
ms.custom: intro-deployment
76
---
87
# Deploy, run, and debug your Linux MSBuild project
@@ -56,11 +55,11 @@ There are several ways to interact with and debug your Linux project.
5655

5756
When the remote target is available, you'll see it listed by either name or IP address.
5857

59-
![Screenshot showing a Remote target.](media/remote_target.png)
58+
![Screenshot showing a Remote target IP address.](media/remote_target.png)
6059

6160
If you haven't connected to the remote target yet, you'll see an instruction to use [Linux Connection Manager](connect-to-your-remote-linux-computer.md) to connect to the remote target.
6261

63-
![Screenshot showing the Remote Architecture.](media/architecture.png)
62+
![Screenshot showing the Remote Architecture, which is x64.](media/architecture.png)
6463

6564
1. Set a breakpoint by clicking in the left gutter of some code that you know will execute.
6665

@@ -126,13 +125,13 @@ You can separate your remote build machine from your remote debug machine for bo
126125

127126
By default, the remote debug machine is the same as the remote build machine (**Configuration Properties** > **General** > **Remote Build Machine**). To specify a new remote debug machine, right-click on the project in **Solution Explorer** and go to **Configuration Properties** > **Debugging** > **Remote Debug Machine**.
128127

129-
![Screenshot showing the Linux remote debug machine property in the Property Pages dialog.](media/linux-remote-debug-machine.png)
128+
![Screenshot showing the Linux remote debug machine property in the Property Pages dialog which displays the username, authentication type, and port.](media/linux-remote-debug-machine.png)
130129

131130
The drop-down menu for **Remote Debug Machine** is populated with all established remote connections. To add a new remote connection, navigate to **Tools** > **Options** > **Cross Platform** > **Connection Manager** or search for "Connection Manager" in **Quick Launch**. You can also specify a new remote deploy directory in the project's Property Pages (**Configuration Properties** > **General** > **Remote Deploy Directory**).
132131

133132
By default, only the files necessary for the process to debug will be deployed to the remote debug machine. You can use **Solution Explorer** to configure which source files will be deployed to the remote debug machine. When you click on a source file, you'll see a preview of its File Properties directly below the Solution Explorer.
134133

135-
![Screenshot showing the Linux deployable files specified in the Properties window.](media/linux-deployable-content.png)
134+
![Screenshot showing the properties of main.cpp with content = False highlighted.](media/linux-deployable-content.png)
136135

137136
The **Content** property specifies whether the file will be deployed to the remote debug machine. You can disable deployment entirely by navigating to **Property Pages** > **Configuration Manager** and unchecking **Deploy** for the desired configuration.
138137

@@ -159,7 +158,7 @@ In some cases, you may require more control over your project's deployment. For
159158

160159
For CMake projects that target a remote Linux machine, you can specify a new remote debug machine in launch.vs.json. By default, the value of "remoteMachineName" is synchronized with the "remoteMachineName" property in CMakeSettings.json, which corresponds to your remote build machine. These properties no longer need to match, and the value of "remoteMachineName" in launch.vs.json will dictate which remote machine is used for deploy and debug.
161160

162-
![The CMake remote debug machine specified in the launch.vs.json file.](media/cmake-remote-debug-machine.png)
161+
![The CMake remote debug machine specified in the launch_schema.json file. remote Machine Name is specified as ${debugInfo . remoteMachineName}](media/cmake-remote-debug-machine.png)
163162

164163
IntelliSense will suggest all a list of all established remote connections. You can add a new remote connection by navigating to **Tools** > **Options** > **Cross Platform** > **Connection Manager** or searching for "Connection Manager" in **Quick Launch**.
165164

docs/linux/download-install-and-setup-the-linux-development-workload.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
title: "Install the C++ Linux workload in Visual Studio"
33
description: "How to download, install, and set up the Linux workload for C++ in Visual Studio."
44
ms.date: "05/03/2020"
5-
ms.assetid: e11b40b2-f3a4-4f06-b788-73334d58dfd9
65
ms.custom: intro-installation
76
---
87
# Download, install, and set up the Linux workload
@@ -29,11 +28,11 @@ For any of these scenarios, the **Linux development with C++** workload is requi
2928

3029
1. Type "Visual Studio Installer" in the Windows search box:
3130

32-
![Screenshot showing the Windows search box.](media/visual-studio-installer-search.png)
31+
![Screenshot showing the Windows search box with the contents visual studio installer.](media/visual-studio-installer-search.png)
3332

3433
1. Look for the installer under the **Apps** results and double-click it. When the installer opens, choose **Modify**, and then click on the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux development with C++** workload.
3534

36-
![Screenshot showing the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linuxworkload.png)
35+
![Screenshot highlighting the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linuxworkload.png)
3736

3837
1. If you're targeting IoT or embedded platforms, go to the **Installation details** pane on the right. Under **Linux development with C++**, expand **Optional Components**, and choose the components you need. CMake support for Linux is selected by default.
3938

docs/linux/linux-asan-configuration.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ASan is a runtime memory error detector for C/C++ that catches the following err
2020

2121
When ASan detects an error, it stops execution immediately. If you run an ASan-enabled program in the debugger, you see a message that describes the type of error, the memory address, and the location in the source file where the error occurred:
2222

23-
![Screenshot showing an ASan error message.](media/asan-error.png)
23+
![Screenshot showing the address sanitizer error message: heap use after free.](media/asan-error.png)
2424

2525
You can also view the full ASan output (including where the corrupted memory was allocated/deallocated) in the Debug pane of the output window.
2626

@@ -31,26 +31,26 @@ You can also view the full ASan output (including where the corrupted memory was
3131
3232
To enable ASan for MSBuild-based Linux projects, right-click on the project in **Solution Explorer** and select **Properties**. Next, navigate to **Configuration Properties** > **C/C++** > **Sanitizers**. ASan is enabled via compiler and linker flags, and requires your project to be recompiled to work.
3333

34-
![Enable ASan for an MSBuild project.](media/msbuild-asan-prop-page.png)
34+
![Screenshot of the project property page with Configuration Properties > C/C plus plus > Sanitizers Enable Address Sanitizer drop down set to Yes.](media/msbuild-asan-prop-page.png)
3535

3636
You can pass optional ASan runtime flags by navigating to **Configuration Properties** > **Debugging** > **AddressSanitizer Runtime Flags**. Click the down-arrow to add or remove flags.
3737

38-
![Configure ASan runtime flags.](media/msbuild-asan-runtime-flags.png)
38+
![Screenshot of the project property page with Configuration Properties > Debugging > Address Sanitizer Runtime Flags set to detect_leaks = 0.](media/msbuild-asan-runtime-flags.png)
3939

4040
## Enable ASan for Visual Studio CMake projects
4141

4242
> [!NOTE]
4343
> To build with CMake Presets, first enable ASan in your CMakeLists.txt file. For more information, see [Enable AddressSanitizer for Windows and Linux](../build/cmake-presets-vs.md#enable-addresssanitizer-for-windows-and-linux).
4444
45-
To enable ASan for CMake, right-click on the CMakeLists.txt file in **Solution Explorer** and choose **CMake Settings for Project**.
45+
To enable ASan for CMake, right-click on the `CMakeLists.txt` file in **Solution Explorer** and choose **CMake Settings for Project**.
4646

4747
Make sure you have a Linux configuration (for example, **Linux-Debug**) selected in the left pane of the dialog:
4848

49-
![Screenshot of the left pane with Linux Debug listed as one of the Configuration options.](media/linux-debug-configuration.png)
49+
![Screenshot of the Configurations pane with Linux Debug listed as one of the options.](media/linux-debug-configuration.png)
5050

5151
The ASan options are under **General**. Enter the ASan runtime flags in the format "flag=value", separated by spaces. The UI incorrectly suggests using semi-colons. Use spaces or colons to separate flags.
5252

53-
![Screenshot of the Enable Address Sanitizer option showing some Address Sanitizer run time flags.](media/cmake-settings-asan-options.png)
53+
![Screenshot of the Enable Address Sanitizer option showing some Address Sanitizer run time flags like detect_leaks=0.](media/cmake-settings-asan-options.png)
5454

5555
## Install the ASan debug symbols
5656

docs/linux/set-up-fips-compliant-secure-remote-linux-development.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -99,11 +99,11 @@ You've successfully set up `ssh`, created and deployed encryption keys, and test
9999
100100
1. In the Connection Manager dialog, choose the **Add** button to add a new connection.
101101
102-
![Screenshot showing the Connection Manager dialog.](media/settings_connectionmanager.png)
102+
![Screenshot showing the Connection Manager dialog under Cross Platform > C plus plus > Connection Manager.](media/settings_connectionmanager.png)
103103
104104
The **Connect to Remote System** window is displayed.
105105
106-
![Screenshot showing the Connect to Remote System window.](media/connect.png)
106+
![Screenshot showing the Connect to Remote System window, which has text boxes for host name, port, user name, auth type, and password.](media/connect.png)
107107
108108
1. In the **Connect to Remote System** dialog, enter the connection details of your remote machine.
109109
@@ -124,7 +124,7 @@ You've successfully set up `ssh`, created and deployed encryption keys, and test
124124
125125
If the connection fails, the entry boxes that need to be changed are outlined in red.
126126
127-
![Screenshot showing a Connection Manager Error.](media/settings_connectionmanagererror.png)
127+
![Screenshot of the Connect to Remote System window showing the host name and port text boxes outlined in red to indicate they need to be changed.](media/settings_connectionmanagererror.png)
128128
129129
For more information on troubleshooting your connection, see [Connect to your remote Linux computer](connect-to-your-remote-linux-computer.md).
130130

0 commit comments

Comments
 (0)