Add "Remarks" and "Example" headings for error references in range [C2521, C2550]

Rageking8 · web-flow · commit 6e1d0266feb8 · 2025-07-30T23:33:52.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md
@@ -10,6 +10,8 @@ ms.assetid: 6042821b-e345-4a54-a7e9-a2c9019ea016
 
 > function does not take any arguments
 
+## Remarks
+
 You attempted to use arguments with a destructor or finalizer.
 
 For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md
@@ -10,8 +10,12 @@ ms.assetid: 7951b700-8f37-45a0-beb4-a79ae0ced72e
 
 > 'class::~identifier' : destructor/finalizer tag mismatch
 
+## Remarks
+
 The name of the destructor must be the class name preceded by a tilde (`~`). The constructor and destructor are the only members that have the same name as the class.
 
+## Example
+
 The following sample generates C2523:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md
@@ -10,6 +10,8 @@ ms.assetid: e71d17f5-2fc2-416b-8dbd-e9bed85eb33a
 
 > 'destructor' : a destructor/finalizer must have a 'void' parameter list
 
+## Remarks
+
 The destructor or finalizer had a parameter list that is not [void](../../cpp/void-cpp.md). Other parameter types are not allowed.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2526"]
 
 > 'identifier1' : C linkage function cannot return C++ class 'identifier2'
 
+## Remarks
+
 A function defined with C linkage cannot return a user-defined type.
 
+## Example
+
 The following sample generates C2526:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md
@@ -10,8 +10,12 @@ ms.assetid: 2ea9d583-67a8-4b16-b35f-a50eeffc03c4
 
 > 'name' : pointer to reference is illegal
 
+## Remarks
+
 You cannot declare a pointer to a reference. Dereference the variable before declaring a pointer to it.
 
+## Example
+
 The following sample generates C2528:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md
@@ -10,8 +10,12 @@ ms.assetid: 73a99e55-b91e-488d-9b72-cc80faaeb436
 
 > 'name' : reference to reference is illegal
 
+## Remarks
+
 This error may be fixed by using pointer syntax and declaring a reference to a pointer.
 
+## Example
+
 The following sample generates C2529:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md
@@ -10,6 +10,8 @@ ms.assetid: b790a312-48df-4a6a-9e27-be2c5f32f16c
 
 > 'identifier' : references must be initialized
 
+## Remarks
+
 You must initialize a reference when it was declared, unless it is declared already:
 
 - With the keyword [extern](../../cpp/extern-cpp.md).
@@ -20,6 +22,8 @@ You must initialize a reference when it was declared, unless it is declared alre
 
 - As the return type of a function.
 
+## Example
+
 The following sample generates C2530:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md
@@ -10,8 +10,12 @@ ms.assetid: c49afe15-55f8-4dc8-ac01-bf653622a7db
 
 > 'identifier' : reference to a bit field illegal
 
+## Remarks
+
 References to bit fields are not allowed.
 
+## Example
+
 The following sample generates C2531:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md
@@ -10,4 +10,6 @@ ms.assetid: a94fdf13-5063-4206-b5a5-374930287bee
 
 > 'identifier' : illegal modifier for reference
 
+## Remarks
+
 The reference was changed. References cannot be modified to refer to another object. Use a pointer instead.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md
@@ -10,10 +10,14 @@ ms.assetid: 5b335652-076c-4824-87c8-a741f64a3ce0
 
 > 'identifier' : constructors not allowed a return type
 
+## Remarks
+
 A constructor cannot have a return type (not even a **`void`** return type).
 
 A common source of this error is a missing semicolon between the end of a class definition and the first constructor implementation. The compiler sees the class as a definition of the return type for the constructor function, and generates C2533.
 
+## Example
+
 The following sample generates C2533, and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md
@@ -10,8 +10,12 @@ ms.assetid: 481f9f54-5b51-4aa0-8eea-218f10807705
 
 > 'identifier' : constructor cannot return a value
 
+## Remarks
+
 A constructor cannot contain a **`return`** statement with an expression (even if the expression has type **`void`**). This differs from regular void-returning function where a return expression of type **`void`** is allowed. However, using the **`return`** statement without an expression is allowed for early returns in the constructor.
 
+## Example
+
 The following sample generates C2534:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md
@@ -10,10 +10,14 @@ ms.assetid: a958f83e-e2bf-4a59-b44b-d406ec325d7e
 
 > 'identifier' : member function already defined or declared
 
+## Remarks
+
 This error could be caused by using the same formal parameter list in more than one definition or declaration of an overloaded function.
 
 If you get C2535 because of the Dispose function, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers) for more information.
 
+## Example
+
 The following sample generates C2535:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2537"]
 
 > 'specifier' : illegal linkage specification
 
+## Remarks
+
 The linkage specifier is not supported. Only the "C" and "C++" linkage specifiers are supported.
 
+## Example
+
 The following sample generates C2537:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md
@@ -10,8 +10,12 @@ ms.assetid: 92c805a3-2dd9-46ca-a63d-3845c18ecc95
 
 > non-constant expression as array bound
 
+## Remarks
+
 An array must have a constant bound.
 
+## Example
+
 The following sample generates C2540:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md
@@ -10,8 +10,12 @@ ms.assetid: ed95180f-00df-4e62-a8e9-1b6dab8281bf
 
 > 'delete' : delete : cannot delete objects that are not pointers
 
+## Remarks
+
 The [delete](../../cpp/delete-operator-cpp.md) operator was used on an object that is not a pointer.
 
+## Example
+
 The following sample generates C2541:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md
@@ -10,6 +10,8 @@ ms.assetid: a984520d-f835-4cac-ac0e-7f1d5f5c6278
 
 > 'identifier' : class object has no constructor for initialization
 
+## Remarks
+
 There is no constructor with a parameter list that matches the initialization.
 
 This error can be caused by incorrect parameters in initialization.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md
@@ -10,6 +10,8 @@ ms.assetid: 6e4d2d03-ef34-4514-92fe-763543a71fa8
 
 > expected ']' for operator '[]'
 
+## Remarks
+
 The subscripting operator is missing a left bracket.
 
 This error can be caused by macro expansion.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md
@@ -10,6 +10,8 @@ ms.assetid: 8e79b74a-4e92-4752-a5fe-c3143dfc5524
 
 > expected ')' for operator '()'
 
+## Remarks
+
 The function call operator is missing a left parenthesis.
 
 This error can be caused by macro expansion.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md
@@ -10,6 +10,8 @@ ms.assetid: 51598eb9-0c57-4306-a0cd-3862980f3672
 
 > 'operator' : unable to find overloaded operator
 
+## Remarks
+
 The operator cannot be used with the operands provided. You must supply an overloaded operator with the required operands.
 
 This error can be caused if operands have incorrect type.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2548"]
 
 > 'class::member' : missing default parameter for parameter parameter
 
+## Remarks
+
 The default parameter list is missing a parameter. If you supply a default parameter anywhere in a parameter list, you must define default parameters for all subsequent parameters in the current declaration or any previous declarations within the same scope.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md
@@ -10,6 +10,8 @@ ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d
 
 > user-defined conversion cannot specify a return type
 
+## Example
+
 The following sample generates C2549:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md
@@ -10,8 +10,12 @@ ms.assetid: 3293f53e-ee66-4035-920d-34e115c3a24c
 
 > 'identifier' : constructor initializer lists are only allowed on constructor definitions
 
+## Remarks
+
 A base class initializer list is used on the definition of a function that is not a constructor.
 
+## Example
+
 The following sample generates C2550:
 
 ```cpp
