Add "Remarks" and "Example" headings for error references in range [C2941, C2980]

Rageking8 · web-flow · commit 7745b4cfd38b · 2025-08-11T23:38:06.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md
@@ -10,6 +10,8 @@ ms.assetid: 1bba94eb-5bf6-468d-8f84-96a6391a7048
 
 > '*class*' : type-class-id redefined as a local 'item'
 
+## Remarks
+
 You can't use a generic or template class as an item.
 
 This error is obsolete in Visual Studio 2022 and later versions.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md
@@ -10,10 +10,14 @@ ms.assetid: 13abf744-8fa1-450d-886d-e5717c04956e
 
 > '*class*' : type-class-id redefined as a formal argument of a function
 
+## Remarks
+
 You can't use a generic or template class as a formal argument. You cannot pass an argument directly to the constructor of a generic or template class.
 
 This error is obsolete in Visual Studio 2022 and later versions.
 
+## Examples
+
 The following sample generates C2942:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md
@@ -10,10 +10,14 @@ ms.assetid: ede6565e-d892-44c0-8eee-c69545f3be2e
 
 > '*class*' : type-class-id redefined as a type argument of a template
 
+## Remarks
+
 You can't use a generic or template class, instead of a symbol, as a generic or template type argument.
 
 This error is obsolete in Visual Studio 2022 and later versions.
 
+## Example
+
 The following sample generates C2943:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md
@@ -10,10 +10,14 @@ ms.assetid: f209e668-e72f-442a-a438-8c4ff43a404a
 
 > '*class*' : type-class-id redefined as a value argument of a template
 
+## Remarks
+
 You can't use a generic or template class, instead of a symbol, as a template value argument.
 
 This error is obsolete in Visual Studio 2022 and later versions.
 
+## Examples
+
 The following sample generates C2944:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md
@@ -10,4 +10,6 @@ ms.assetid: be640257-7017-45d1-986a-9fe8caab52f3
 
 > explicit instantiation does not refer to a template-class specialization
 
+## Remarks
+
 You cannot explicitly instantiate something that is not templated.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md
@@ -10,6 +10,8 @@ ms.assetid: c86dfbfc-7702-4f09-8a53-d205710e99c2
 
 > explicit instantiation; 'class' is not a template-class specialization
 
+## Remarks
+
 You cannot explicitly instantiate a nontemplated class.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md
@@ -10,10 +10,14 @@ ms.assetid: 6c056f62-ec90-4883-8a67-aeeb6ec13546
 
 > expecting '>' to terminate construct, found 'syntax'
 
+## Remarks
+
 A generic or template argument list may not have been terminated correctly.
 
 C2947 can also be generated by syntax errors.
 
+## Example
+
 The following sample generates C2947:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md
@@ -10,4 +10,6 @@ ms.assetid: 780c6ed3-43a0-4112-8d00-b7bf79086c05
 
 > explicit instantiation; storage class specifier 'specifier' not permitted on specialization
 
+## Remarks
+
 You cannot use storage-class specifiers (such as **`extern`**) in a specialization of a template class that was previously explicitly instantiated.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md
@@ -10,8 +10,12 @@ ms.assetid: c6f95aa2-c894-425b-a51c-d40d70c8daa1
 
 > type declarations are only permitted at global, namespace, or class scope
 
+## Remarks
+
 You cannot declare a generic or template class outside global or namespace scope. If you make your generic or template declarations in an include file, make sure the include file is at global scope.
 
+## Examples
+
 The following sample generates C2951:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md
@@ -10,8 +10,12 @@ ms.assetid: a40e18a2-d02c-4511-854f-6c6fd6789a1a
 
 > 'declaration' : type declaration missing template parameter list
 
+## Remarks
+
 A template declaration was ill formed.
 
+## Examples
+
 The following sample generates C2952:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md
@@ -10,8 +10,12 @@ ms.assetid: 8dbcfa24-8296-4e40-bdc4-5526c07d8892
 
 > 'identifier' : class template has already been defined
 
+## Remarks
+
 Check the source file and include files for other definitions.
 
+## Example
+
 The following sample generates C2953:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md
@@ -10,10 +10,14 @@ ms.assetid: 77709fb6-d69b-46fd-a62f-e8564563d01b
 
 > 'identifier' : use of class template or alias generic requires template or generic argument list
 
+## Remarks
+
 You cannot use a class template or class generic as an identifier without a template or generic argument list.
 
 For more information, see [Class Templates](../../cpp/class-templates.md).
 
+## Examples
+
 The following sample generates C2955 and shows how to fix it:
 
 ```cpp
@@ -61,8 +65,6 @@ int main() {
 }
 ```
 
-## Example
-
 **Visual Studio 2017 and later:** The compiler correctly diagnoses missing template argument lists when the template appears in a template parameter list (for example as part of a default template argument or a non-type template parameter). The following code compiles in Visual Studio 2015 but produces an error in Visual Studio 2017.
 
 ```
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2956"]
 
 > usual deallocation function '*function*' would be chosen as placement deallocation function
 
+## Remarks
+
 The deallocation function found for the placement new expression matches one of the usual deallocation functions. Either an implicit compiler-generated deallocation or an explicit `delete` (or `delete[]`) would use the wrong deallocation function.
 
 ## Remarks
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md
@@ -10,8 +10,12 @@ ms.assetid: 9cb4526f-4af8-47e9-b786-56192627ca72
 
 > 'delim' : invalid left delimiter : expected '<'
 
+## Remarks
+
 A generic class was ill formed.
 
+## Example
+
 The following sample generates C2957:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md
@@ -10,6 +10,8 @@ ms.assetid: 332bf6d3-7cd1-4b1a-8ddb-d4a8cbf01115
 
 > the left delimiter found at 'location' was not matched correctly
 
+## Remarks
+
 A delimiter is not properly matched.
 
 This error can be caused by mismatched parenthesis in a function template declaration.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md
@@ -10,6 +10,8 @@ ms.assetid: d66bb2a8-70c3-4209-a358-b0c47f111a50
 
 > a generic class or function may not be a member of a template
 
+## Remarks
+
 For more information, see [Windows Runtime and Managed Templates](../../extensions/windows-runtime-and-managed-templates-cpp-component-extensions.md) and [Generics](../../extensions/generics-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md
@@ -10,6 +10,8 @@ ms.assetid: 6f966aec-4eea-4221-8e1b-fe66808c6f5c
 
 > syntax error : 'token' : expected template-class member function definition to end with '}'
 
+## Remarks
+
 The token caused a syntax error in a template declaration.
 
 This error can be caused by mismatched delimiters
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md
@@ -10,8 +10,12 @@ ms.assetid: e4ea3d66-b937-4b2c-b42a-96e03fb11579
 
 > syntax error : 'symbol' : expected member function definition to end with '}'
 
+## Remarks
+
 A template member function definition has an unmatched closing brace.
 
+## Example
+
 The following sample generates C2969:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md
@@ -10,8 +10,12 @@ ms.assetid: 21d90348-20d3-438c-b278-efdbfb93a7d2
 
 > 'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument
 
+## Remarks
+
 You cannot use the name or address of a static variable as a template argument. The template class expects a const value that can be evaluated at compile time.
 
+## Example
+
 The following sample generates C2970:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md
@@ -10,8 +10,12 @@ ms.assetid: fdb5467b-9a41-41ef-ac20-2e9428d5a4fc
 
 > 'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument
 
+## Remarks
+
 You cannot use the name or address of a local variable as a template argument.
 
+## Example
+
 The following sample generates C2971:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md
@@ -10,4 +10,6 @@ ms.assetid: 18b4a1c1-0ef6-43af-887a-1b5b1ab88d5b
 
 > invalid template argument 'number'
 
+## Remarks
+
 Check the template definition to find the correct types.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md
@@ -10,8 +10,12 @@ ms.assetid: 1b444260-f2bf-48d7-ab1e-35573d8c4a0e
 
 > invalid type argument 'number', type expected
 
+## Remarks
+
 The generic or template argument does not match the generic or template declaration. A type should appear within the angle brackets. Check the generic or template definition to find the correct types.
 
+## Examples
+
 The following sample generates C2974:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md
@@ -10,9 +10,11 @@ ms.assetid: 526f6b9d-6c76-4c12-9252-1b1d7c1e06c7
 
 > '*argument*' : invalid template argument for '*type*', expected compile-time constant expression
 
+## Remarks
+
 The template argument does not match the template declaration; a constant expression should appear within the angle brackets. Variables are not allowed as template actual arguments. Check the template definition to find the correct types.
 
-## Example
+## Examples
 
 The following sample generates C2975 and also shows correct usage:
 
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md
@@ -10,10 +10,14 @@ ms.assetid: d9bf9836-325e-4f72-a7e3-a67cf19d32e7
 
 > 'identifier' : too few type arguments
 
+## Remarks
+
 A generic or template is missing one or more actual arguments. Check the generic or template declaration to find the correct number of parameters.
 
 This error can be caused by missing template arguments in C++ Standard Library components.
 
+## Examples
+
 The following sample generates C2976:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md
@@ -10,8 +10,12 @@ ms.assetid: 3c4218e0-5d03-4a2b-b757-c507c35f3542
 
 > 'identifier' : too many type arguments
 
+## Remarks
+
 A generic or template has too many actual arguments. Check the generic or template declaration to find the correct number of parameters.
 
+## Examples
+
 The following sample generates C2977:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2978"]
 
 > syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics
 
+## Remarks
+
 A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md
@@ -10,6 +10,8 @@ ms.assetid: 98bd9043-ec44-451e-a482-3a8e35fc7464
 
 > explicit specializations are not supported in generics
 
+## Remarks
+
 A generic class was declared incorrectly.  See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information.
 
 ## Example
