Merge pull request #12601 from ghogen/cpp-note

Add note and adjust dev_langs metadata for C++ MSBuild tasks

Author: ghogen

docs/msbuild/bscmake-task.md

@@ -7,9 +7,6 @@ f1_keywords:
 - vc.task.bscmake
 - VC.Project.VCBscMakeTool.PreserveSBR
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), tasks
@@ -24,6 +21,8 @@ ms.subservice: msbuild
 > [!IMPORTANT]
 > BscMake is no longer used by the Visual Studio IDE. Since Visual Studio 2008, browse information is stored automatically in an *.sdf* file in the *Solution* folder.
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
  Wraps the Microsoft Browse Information Maintenance Utility tool (*bscmake.exe*).  The *bscmake.exe* tool builds a browse information file (*.bsc*) from source browser files (*.sbr*) that are created during compilation. Use the **Object Browser** to view a *.bsc* file. For more information, see [BSCMAKE reference](/cpp/build/reference/bscmake-reference).
 
 ## Parameters

docs/msbuild/cl-task.md

@@ -9,8 +9,6 @@ f1_keywords:
 - VC.Project.VCCLCompilerTool.TreatSpecificWarningsAsErrors
 - VC.Project.VCCLCompilerTool.CreateHotpatchableImage
 dev_langs:
-- VB
-- CSharp
 - C++
 helpviewer_keywords:
 - MSBuild (C++), CL task
@@ -22,6 +20,8 @@ ms.subservice: msbuild
 ---
 # CL task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft C++ compiler tool, *cl.exe*. The compiler produces executable (*.exe*) files, dynamic-link library (*.dll*) files, or code module (*.netmodule*) files. For more information, see [Compiler options](/cpp/build/reference/compiler-options) and [Use MSBuild from the command line](/cpp/build/msbuild-visual-cpp) and [Use the Microsoft C++ toolset from the command line](/cpp/build/building-on-the-command-line).
 
 ## Parameters

docs/msbuild/clangcompile-task.md

@@ -6,9 +6,6 @@ ms.topic: "reference"
 f1_keywords:
   - "vc.task.clangcompile"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "MSBuild (C++), ClangCompile task"
@@ -18,6 +15,8 @@ ms.author: twhitney
 ---
 # ClangCompile task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft C++ compiler tool, clang.exe.
 
 ## Parameters

docs/msbuild/cppclean-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.cppclean
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), CPPClean task
@@ -20,6 +17,8 @@ ms.subservice: msbuild
 ---
 # CPPClean Task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Deletes the temporary files that MSBuild creates when a C++ project is built. The process of deleting build files is known as *cleaning*.
 
 ## Parameters

docs/msbuild/custombuild-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.custombuild
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), CustomBuild task
@@ -18,6 +15,8 @@ ms.author: ghogen
 ---
 # CustomBuild task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft C++ compiler tool, cmd.exe. This class derives from [TrackedVCToolTask](../msbuild/trackedvctooltask-base-class.md), but does not use file tracking to discover file dependencies. All dependencies should be explicitly specified as AdditionalDependencies for incremental build working properly.
 
 ## Parameters

docs/msbuild/fxc-task.md

@@ -6,9 +6,6 @@ ms.topic: "reference"
 f1_keywords:
   - "vc.task.fxc"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "MSBuild (C++), FXC task"
@@ -18,6 +15,8 @@ ms.author: twhitney
 ---
 # FXC task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Use HLSL shader compilers in the build process.
 
 ## Parameters

docs/msbuild/getoutofdateitems-task.md

@@ -6,9 +6,6 @@ ms.topic: "reference"
 f1_keywords:
   - "vc.task.getoutofdateitems"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "MSBuild (C++), GetOutOfDateItems task"
@@ -18,6 +15,8 @@ ms.author: twhitney
 ---
 # GetOutOfDateItems task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Helper task that reads old tlogs, writes new tlogs, and returns set of items that are not up-to-date.
 
 ## Parameters

docs/msbuild/getoutputfilename-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.getoutputfilename
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), GetOutputFileName task
@@ -18,6 +15,8 @@ ms.author: ghogen
 ---
 # GetOutputFileName task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Helper task to get output file name for cl and other tools, which allow specifying only output directory or full file name or nothing.
 
 ## Parameters

docs/msbuild/includes/cpp-task.md

@@ -0,0 +1,8 @@
+---
+author: ghogen
+ms.author: ghogen
+ms.topic: include
+ms.date: 5/17/2024
+---
+> [!NOTE]
+> This task is only available when using the C++ build system.

docs/msbuild/lib-task.md

@@ -12,9 +12,6 @@ f1_keywords:
   - "VC.Project.VCLibrarianTool.LinkLibraryDependencies"
   - "VC.Project.VCLibrarianTool.LinkTimeCodeGeneration"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "MSBuild (C++), LIB task"
@@ -26,6 +23,8 @@ ms.subservice: msbuild
 ---
 # LIB task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft 32-Bit Library Manager tool, *lib.exe*. The Library Manager creates and manages a library of Common Object File Format (COFF) object files. The Library Manager can also create export files and import libraries to reference exported definitions. For more information, see [LIB reference](/cpp/build/reference/lib-reference) and [Running LIB](/cpp/build/reference/running-lib).
 
 ## Parameters

docs/msbuild/link-task.md

@@ -18,8 +18,6 @@ f1_keywords:
 - VC.Project.VCLinkerTool.ImageHasSafeExceptionHandlers
 - VC.Project.VCLinkerTool.CLRSupportLastError
 dev_langs:
-- VB
-- CSharp
 - C++
 helpviewer_keywords:
 - MSBuild (C++), Link task
@@ -31,6 +29,8 @@ ms.subservice: msbuild
 ---
 # Link task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft C++ linker tool, *link.exe*. The linker tool links Common Object File Format (COFF) object files and libraries to create an executable (*.exe*) file or a dynamic-link library (DLL). For more information, see [Linker options](/cpp/build/reference/linker-options) and [Use MSBuild from the command line](/cpp/build/msbuild-visual-cpp) and [Use the Microsoft C++ toolset from the command line](/cpp/build/building-on-the-command-line).
 
 ## Parameters

docs/msbuild/mt-task.md

@@ -22,6 +22,8 @@ ms.subservice: msbuild
 ---
 # MT task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft Manifest Tool, *mt.exe*. For more information, see [Mt.exe](/windows/desktop/SbsCs/mt-exe).
 
 ## Parameters

docs/msbuild/multitooltask-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.multitooltask
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), MultiToolTask task
@@ -18,6 +15,8 @@ ms.author: ghogen
 ---
 # MultiToolTask task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Experimental task that enables parallel execution of MIDL, CL, Clang, and FXC (hlsl). See [Improve parallelism in MSBuild](https://devblogs.microsoft.com/cppblog/improved-parallelism-in-msbuild/).
 
 ## Parameters

docs/msbuild/parallelcustombuild-task.md

@@ -6,9 +6,6 @@ ms.topic: "reference"
 f1_keywords:
   - "vc.task.parallelcustombuild"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "MSBuild (C++), ParallelCustomBuild task"
@@ -18,6 +15,8 @@ ms.author: twhitney
 ---
 # ParallelCustomBuild task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Run parallel instances of the [CustomBuild task](../msbuild/custombuild-task.md).
 
 ## Parameters

docs/msbuild/rc-task.md

@@ -9,9 +9,6 @@ f1_keywords:
   - "VC.Project.VCResourceCompilerTool.SuppressStartupBanner"
   - "VC.Project.VCResourceCompilerTool.NullTerminateStrings"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "RC task (MSBuild (C++))"
@@ -23,6 +20,8 @@ ms.subservice: msbuild
 ---
 # RC task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the Microsoft Windows Resource Compiler tool, *rc.exe*. The **RC** task compiles resources, such as cursors, icons, bitmaps, dialog boxes, and fonts, into a resource (*.res*) file. For more information, see [Resource Compiler](/windows/desktop/menurc/resource-compiler).
 
 ## Parameters

docs/msbuild/setenv-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.setenv
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - MSBuild (C++), tasks
@@ -20,6 +17,8 @@ ms.subservice: msbuild
 ---
 # SetEnv task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Sets or deletes the value of a specified environment variable.
 
 ## Parameters

docs/msbuild/trackedvctooltask-base-class.md

@@ -4,8 +4,6 @@ description: Learn about the parameters that the TrackedVCToolTask base class ad
 ms.date: 03/10/2019
 ms.topic: reference
 dev_langs:
-- VB
-- CSharp
 - C++
 author: ghogen
 ms.author: ghogen

docs/msbuild/vcmessage-task.md

@@ -6,9 +6,6 @@ ms.topic: reference
 f1_keywords:
 - vc.task.vcmessage
 dev_langs:
-- VB
-- CSharp
-- C++
 - C++
 helpviewer_keywords:
 - VCMessage task (MSBuild (C++))
@@ -20,6 +17,8 @@ ms.subservice: msbuild
 ---
 # VCMessage task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Logs warning and error messages during a build.
 
 ## Remarks

docs/msbuild/xdcmake-task.md

@@ -6,9 +6,6 @@ ms.topic: "reference"
 f1_keywords:
   - "vc.task.xdcmake"
 dev_langs:
-  - "VB"
-  - "CSharp"
-  - "C++"
   - "C++"
 helpviewer_keywords:
   - "XDCMake task (MSBuild (C++))"
@@ -20,6 +17,8 @@ ms.subservice: msbuild
 ---
 # XDCMake task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the XML Documentation tool (*xdcmake.exe*), which merges XML document comment (*.xdc*) files into an *.xml* file.
 
  An *.xdc* file is created when you provide documentation comments in your C++ source code and compile by using the [/doc](/cpp/build/reference/doc-process-documentation-comments-c-cpp) compiler option. For more information, see [XDCMake reference](/cpp/build/reference/xdcmake-reference), [XML Document Generator Tool property pages](/cpp/build/reference/xml-document-generator-tool-property-pages), and command-line help option (**/?**) for *xdcmake.exe*.

docs/msbuild/xsd-task.md

@@ -8,8 +8,6 @@ f1_keywords:
 - VC.Project.VCXMLDataGeneratorTool.Namespace
 - VC.Project.VCXMLDataGeneratorTool.GenerateFromSchema
 dev_langs:
-- VB
-- CSharp
 - C++
 helpviewer_keywords:
 - XSD task (MSBuild (C++))
@@ -21,6 +19,8 @@ ms.subservice: msbuild
 ---
 # XSD task
 
+[!INCLUDE [C++-specific task](./includes/cpp-task.md)]
+
 Wraps the XML Schema Definition tool (*xsd.exe*), which generates schema or class files from a source.
 
 > [!NOTE]