Add "Remarks" and "Example" headings for error references in range [C2161, C2180]

Rageking8 · web-flow · commit ee4f1c16609d · 2025-07-17T22:31:04.000+08:00
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md
@@ -10,8 +10,12 @@ ms.assetid: d6798821-13bb-4e60-924f-85f7bf955387
 
 > '##' cannot occur at the end of a macro definition
 
+## Remarks
+
 A macro definition ended with a token-pasting operator (##).
 
+## Example
+
 The following sample generates C2161:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2162"]
 
 > expected macro formal parameter
 
+## Remarks
+
 The token following a [stringizing operator (#)](../../preprocessor/stringizing-operator-hash.md) or a [charizing operator (#@)](../../preprocessor/charizing-operator-hash-at.md) is not a formal parameter.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md
@@ -10,4 +10,6 @@ ms.assetid: 6428d1e9-1ba1-46fc-bbf6-91d6fef2734c
 
 > 'function' : not available as an intrinsic function
 
+## Remarks
+
 An `intrinsic` or `function` pragma lists a function not available in intrinsic form. For example, certain intrinsics are not available when compiling a program that uses /clr programming.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md
@@ -10,8 +10,12 @@ ms.assetid: 55df5024-68a8-45a8-ae6c-e6dba35318a2
 
 > 'function' : intrinsic function not declared
 
+## Remarks
+
 An `intrinsic` pragma uses an undeclared function (only occurs with **/Oi**). Or, one of the compiler intrinsics was used without including its header file.
 
+## Example
+
 The following sample generates C2164:
 
 ```c
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md
@@ -10,8 +10,12 @@ ms.assetid: b108313b-b8cb-4dce-b2ec-f2b31c9cdc87
 
 > 'keyword' : cannot modify pointers to data
 
+## Remarks
+
 The **`__stdcall`**, **`__cdecl`**, or **`__fastcall`** keyword attempts to modify a pointer to data.
 
+## Example
+
 The following sample generates C2165:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md
@@ -10,4 +10,6 @@ ms.assetid: 3de3de96-12cd-47df-b24e-34cc9747ef83
 
 > 'function' : too many actual parameters for intrinsic function
 
+## Remarks
+
 A reference to an `intrinsic` function has too many parameters.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md
@@ -10,4 +10,6 @@ ms.assetid: 625e7dc3-ca74-4980-8268-8d5c0245e376
 
 > 'function' : too few actual parameters for intrinsic function
 
+## Remarks
+
 A reference to an `intrinsic` function has too few parameters.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md
@@ -10,4 +10,6 @@ ms.assetid: 97f700bd-1044-46f5-b276-3d7570ee7708
 
 > 'function' : intrinsic function, cannot be defined
 
+## Remarks
+
 A function definition appears for a function already declared `intrinsic`.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md
@@ -10,6 +10,8 @@ ms.assetid: a80343b5-ab3f-4413-b6f1-3ce9d7e519e5
 
 > 'operator' : illegal on operands of type 'type'
 
+## Remarks
+
 A unary operator is used with an invalid operand type.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md
@@ -10,4 +10,6 @@ ms.assetid: 31183ea7-858d-4273-932a-d865af7059b1
 
 > 'function' : actual parameter is not a pointer : parameter number
 
+## Remarks
+
 Parameter `number` is not a pointer. The function expects a pointer.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md
@@ -10,4 +10,6 @@ ms.assetid: 4df592b8-609b-41a5-b4fc-966eb5bb2d1a
 
 > 'function' : actual parameter is not a pointer : parameter number1, parameter list number2
 
+## Remarks
+
 Parameter `number1` passed to parameter list `number2` is not a pointer. The function expects a pointer.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md
@@ -10,4 +10,6 @@ ms.assetid: 161d563c-76e9-47e9-9142-7812e9ea169e
 
 > 'function' : actual parameter has type 'void' : parameter number1, parameter list number2
 
+## Remarks
+
 Parameter `number1` passed to parameter list `number2` is a **`void`** parameter. Parameters cannot have type **`void`**. Use **`void*`** instead.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md
@@ -10,4 +10,6 @@ ms.assetid: 3a8fa90b-2b29-414a-bb55-cf27c2bf989a
 
 > 'locale' : invalid locale
 
+## Remarks
+
 The specified locale is not valid. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for supported locales.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md
@@ -10,8 +10,12 @@ ms.assetid: 2a39a880-cddb-4d3e-a572-645a14c4c478
 
 > constant too big
 
+## Remarks
+
 A constant value is too large for the variable type it is assigned.
 
+## Example
+
 The following sample generates C2177:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md
@@ -10,6 +10,8 @@ ms.assetid: 79a14158-17f3-4221-bd06-9d675c49cef4
 
 > '*identifier*' cannot be declared with '*specifier*' specifier
 
+## Remarks
+
 A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context.
 
 The **`mutable`** specifier can be applied only to names of class data members, and cannot be applied to names declared **`const`** or **`static`**, and cannot be applied to reference members.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md
@@ -10,6 +10,8 @@ ms.assetid: f929bfc6-3964-4e54-87d6-7529b9b6c0b9
 
 > 'type' : an attribute argument cannot use type parameters
 
+## Remarks
+
 A generic type parameter is resolved at runtime. However, an attribute parameter must be resolved at compile time. Therefore, you cannot use a generic type parameter as an argument to an attribute.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md
@@ -10,8 +10,12 @@ ms.assetid: ea71b39e-b977-48a7-b7bd-af68ef5e263b
 
 > controlling expression has type 'type'
 
+## Remarks
+
 The controlling expression in an **`if`**, **`while`**, **`for`**, or **`do`** statement is an expression cast to **`void`**. To fix this issue, change the controlling expression to one that produces a **`bool`** or a type that can be converted to **`bool`**.
 
+## Example
+
 The following sample generates C2180:
 
 ```c
