Merge pull request #3064 from MicrosoftDocs/master637528132148881961

Repo sync for protected CLA branch

Author: Colin Robertson

docs/build/how-to-modify-the-target-framework-and-platform-toolset.md

@@ -1,39 +1,38 @@
 ---
 description: "Learn more about: How to: Modify the Target Framework and Platform Toolset"
 title: "How to: Modify the Target Framework and Platform Toolset"
-ms.custom: "conceptual"
-ms.date: "07/24/2019"
+ms.custom: "contperf-fy21q3"
+ms.date: 03/31/2021
 helpviewer_keywords: ["msbuild (c++), howto: modify target framework and platform toolset"]
-ms.assetid: 031b1d54-e6e1-4da7-9868-3e75a87d9ffe
 ---
 # How to: Modify the Target Framework and Platform Toolset
 
-You can edit a Visual Studio C++ project file to target different versions of the C++ platform toolset, the Windows SDK and the .NET Framework (C++/CLI projects only). By default, the project system uses the .NET Framework version and the toolset version that correspond to the version of Visual Studio that you use to create the project. You can modify all these values in the .vcxproj file so that you can use the same code base for every compilation target.
+You can edit a Visual Studio C++ project file to target different versions of the C++ platform toolset. The Windows SDK and the .NET Framework used are also editable. (The .NET Framework applies to C++/CLI projects only). A new project uses the default .NET Framework and toolset of the Visual Studio version that you use to create the project. If you modify these values in the .vcxproj file, you can use the same code base for every compilation target.
 
 ## Platform toolset
 
-The platform toolset consists of the C++ compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Since Visual Studio 2015, the major version of the toolset has remained at 14, which means that projects compiled with Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with projects compiled with Visual Studio 2015. The minor version has updated by 1 for each version since Visual Studio 2015:
+The platform toolset consists of the C++ compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. It's shown by the major version of the toolset, which has remained at 14. Projects compiled in Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with 2017 and 2015 projects. The minor version has updated by 1 for each version since Visual Studio 2015:
 
 - Visual Studio 2015: v140
 - Visual Studio 2017: v141
 - Visual Studio 2019: v142
 
-These toolsets support .NET Framework 4.5 and later.
+These toolsets support the .NET Framework 4.5 and later.
 
-Visual Studio also supports multitargeting for C++ projects. You can use the Visual Studio IDE to edit and build projects that were created with older versions of Visual Studio, without upgrading them to use a new version of the toolset. You do need to have the older toolsets installed on your computer. For more information, see [How to use native multi-targeting in Visual Studio](../porting/use-native-multi-targeting.md). For example, in Visual Studio 2015, you can *target* .NET Framework 2.0 but you must use an earlier toolset that supports it.
+Visual Studio also supports multitargeting for C++ projects. You can use the latest Visual Studio IDE to edit and build projects created by older versions of Visual Studio. It doesn't require a project upgrade the projects to use a new version of the toolset. It does require the older toolset is installed on your computer. For more information, see [How to use native multi-targeting in Visual Studio](../porting/use-native-multi-targeting.md). For example, in Visual Studio 2015, you can *target* .NET Framework 2.0, but you must use an earlier toolset that supports it.
 
 ## Target framework (C++/CLI project only)
 
-When you change the target Framework, also change the platform toolset to a version that supports that Framework. For example, to target the .NET Framework 4.5, you must use a compatible platform toolset such as Visual Studio 2015 (v140), Visual Studio 2013 (v120) or Visual Studio 2012 (v110). You can use the [Windows 7.1 SDK](https://www.microsoft.com/download/details.aspx?id=8279) platform toolset to target the .NET Framework 2.0, 3.0, 3.5, and 4, and the x86/x64 platforms.
+When you change the target Framework, also change the platform toolset to a version that supports that Framework. For example, to target the .NET Framework 4.5, you must use a compatible platform toolset. These toolsets include Visual Studio 2015 (v140), Visual Studio 2013 (v120), or Visual Studio 2012 (v110). You can use the [Windows 7.1 SDK](https://www.microsoft.com/download/details.aspx?id=8279) to target .NET Framework 2.0, 3.0, 3.5, and 4.
 
 You can extend the target platform further by creating a custom platform toolset. For more information, see [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) on the Visual C++ blog.
 
 ### To change the target Framework
 
-1. In Visual Studio, in **Solution Explorer**, select your project. On the menu bar, open the **Project** menu and choose **Unload project**. This unloads the project (.vcxproj) file for your project.
+1. In Visual Studio, in **Solution Explorer**, select your project. On the menu bar, open the **Project** menu and choose **Unload project**. This command unloads the project (.vcxproj) file for your project.
 
    > [!NOTE]
-   >  A C++ project cannot be loaded while the project file is being modified in Visual Studio. However, you can use another editor such as Notepad to modify the project file while the project is loaded in Visual Studio. Visual Studio will detect that the project file has changed and prompt you to reload the project.
+   >  A C++ project can't be loaded while you edit the project file in Visual Studio. However, you can use another editor such as Notepad to modify the project file while the project is loaded in Visual Studio. Visual Studio will detect that the project file has changed and prompt you to reload the project.
 
 1. On the menu bar, select **File**, **Open**, **File**. In the **Open File** dialog box, navigate to your project folder, and then open the project (.vcxproj) file.
 
@@ -45,19 +44,23 @@ You can extend the target platform further by creating a custom platform toolset
 
 1. In **Solution Explorer**, open the shortcut menu for your project and then choose **Reload Project**.
 
-1. To verify the change, in **Solution Explorer**, right-click to open the shortcut menu for your project (not for your solution) and then choose **Properties** to open your project **Property Pages** dialog box. In the left pane of the dialog box, expand **Configuration Properties** and then select **General**. Verify that **.NET Target Framework Version** shows the new Framework version.
+1. To verify the change, on the menu bar, select **Project** > **Properties** to open your project **Property Pages** dialog box. In the dialog box, select the **Configuration Properties** > **General** property page. Verify that **.NET Target Framework Version** shows the new Framework version.
 
 ### To change the platform toolset
 
-1. In Visual Studio, in **Solution Explorer**, open the shortcut menu for your project (not for your solution) and then choose **Properties** to open your project **Property Pages** dialog box.
+1. In Visual Studio, on the menu bar, select **Project** > **Properties** to open your project **Property Pages** dialog box.
 
-1. In the **Property Pages** dialog box, open the **Configuration** drop-down list and then select **All Configurations**.
+1. In the top of the **Property Pages** dialog box, open the **Configuration** drop-down list and then select **All Configurations**.
 
-1. In the left pane of the dialog box, expand **Configuration Properties** and then select **General**.
+1. In the dialog box, select the **Configuration Properties** > **General** property page.
 
-1. In the right pane, select **Platform Toolset** and then select the toolset you want from the drop-down list. For example, if you have installed the Visual Studio 2010 toolset, select **Visual Studio 2010 (v100)** to use it for your project.
+1. In the properties page, select **Platform Toolset** and then select the toolset you want from the drop-down list. For example, if you've installed the Visual Studio 2010 toolset, select **Visual Studio 2010 (v100)** to use it for your project.
 
-1. Choose the **OK** button.
+1. Choose the **OK** button to save your changes.
+
+## Next Steps
+
+[Walkthrough: Working with Projects and Solutions (C++)](../ide/walkthrough-working-with-projects-and-solutions-cpp.md)
 
 ## See also
 

docs/build/integrate-vcpkg.md

@@ -47,5 +47,5 @@ If you've used the **`integrate`** option, you should remove the integration bef
 [Install vcpkg](install-vcpkg.md)\
 [Manage libraries with vcpkg](manage-libraries-with-vcpkg.md)\
 [vcpkg command-line reference](vcpkg-command-line-reference.md)\
-[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/index.md)\
+[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/README.md)\
 [Frequently asked questions](https://github.com/microsoft/vcpkg/blob/master/docs/about/faq.md)

docs/build/manage-libraries-with-vcpkg.md

@@ -319,6 +319,6 @@ Type **`vcpkg remove`** to remove an installed library. If any other libraries d
 [Install vcpkg](install-vcpkg.md)\
 [Integrate vcpkg](integrate-vcpkg.md)\
 [vcpkg command-line reference](vcpkg-command-line-reference.md)\
-[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/index.md)\
+[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/README.md)\
 [Frequently asked questions](https://github.com/microsoft/vcpkg/blob/master/docs/about/faq.md)\
 [Installing and Using Packages Example: SQLite](https://github.com/microsoft/vcpkg/blob/master/docs/examples/installing-and-using-packages.md)

docs/build/vcpkg-command-line-reference.md

@@ -45,5 +45,5 @@ A quick reference to the commands available in vcpkg.
 [Install vcpkg](install-vcpkg.md)\
 [Integrate vcpkg](integrate-vcpkg.md)\
 [Manage libraries with vcpkg](manage-libraries-with-vcpkg.md)\
-[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/index.md)\
+[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/README.md)\
 [Frequently asked questions](https://github.com/microsoft/vcpkg/blob/master/docs/about/faq.md)

docs/build/vcpkg.md

@@ -57,5 +57,5 @@ Use the **`vcpkg contact --survey`** command to send feedback to Microsoft about
 [Integrate vcpkg](integrate-vcpkg.md)\
 [Manage libraries with vcpkg](manage-libraries-with-vcpkg.md)\
 [vcpkg command-line reference](vcpkg-command-line-reference.md)\
-[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/index.md)\
+[Quick start](https://github.com/microsoft/vcpkg/blob/master/docs/README.md)\
 [Frequently asked questions](https://github.com/microsoft/vcpkg/blob/master/docs/about/faq.md)

docs/c-runtime-library/reference/ceil-ceilf-ceill.md

@@ -62,8 +62,8 @@ By default, this function's global state is scoped to the application. To change
 
 |Routine|Required header|
 |-------------|---------------------|
-|**ceil**, **ceilf**, **ceill**|\<math.h>|
-|**ceil** macro | \<tgmath.h> ||
+| **ceil**, **ceilf**, **ceill**| \<math.h> |
+| **ceil** macro | \<tgmath.h> |
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
 

docs/c-runtime-library/reference/floor-floorf-floorl.md

@@ -63,7 +63,7 @@ By default, this function's global state is scoped to the application. To change
 |Function|Required header|
 |--------------|---------------------|
 |**floor**, **floorf**, **floorl**|\<math.h>|
-|**floor** macro | \<tgmath.h> ||
+|**floor** macro | \<tgmath.h> |
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
 

docs/c-runtime-library/reference/fmin-fminf-fminl.md

@@ -76,7 +76,7 @@ If you use the \<tgmath.h> `fmin()` macro, the type of the argument determines w
 |Routine|Required header|
 |-------------|---------------------|
 |**fmin**, **fminf**, **fminl**|C: \<math.h><br />C++: \<math.h> or \<cmath>|
-|**fmin** macro | \<tgmath.h> ||
+|**fmin** macro | \<tgmath.h> |
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
 

docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md

@@ -76,7 +76,7 @@ By default, this function's global state is scoped to the application. To change
 |Routine|Required header|
 |-------------|---------------------|
 |**lround**, **lroundf**, **lroundl**, **llround**, **llroundf**, **llroundl**|\<math.h>|
-|**lround** macro | \<tgmath.h> ||
+|**lround** macro | \<tgmath.h> |
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
 

docs/c-runtime-library/reference/round-roundf-roundl.md

@@ -61,7 +61,7 @@ By default, this function's global state is scoped to the application. To change
 |Routine|Required header|
 |-------------|---------------------|
 |**round**, **roundf**, **roundl**|\<math.h>|
-|**round** macro | \<tgmath.h> ||
+|**round** macro | \<tgmath.h> |
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).