Add "Remarks" and "Example" headings for error references in range [C2401, C2430]

Rageking8 · web-flow · commit 71aa7b204a79 · 2025-07-26T22:53:05.000+08:00
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md
@@ -10,4 +10,6 @@ ms.assetid: 4c237b34-f771-4106-93e2-82dae337f1e2
 
 > 'identifier' : register must be base in 'context'
 
+## Remarks
+
 The register used in an indirect memory operand must be a base register in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md
@@ -10,4 +10,6 @@ ms.assetid: 23fa63e1-ea9e-482f-be2e-a205c548ba69
 
 > 'identifier' : register must be index in 'context'
 
+## Remarks
+
 The register used in an indirect memory operand must be an index register in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md
@@ -10,4 +10,6 @@ ms.assetid: add1f0ba-96b6-4df3-b53f-de1433d80c0c
 
 > 'identifier' : register must be base/index in 'context'
 
+## Remarks
+
 The register used in an indirect memory operand must be a base or index register in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md
@@ -10,4 +10,6 @@ ms.assetid: 51794d2f-404b-4d89-b3ea-fc5faa9c197d
 
 > 'identifier' : illegal register in 'context'
 
+## Remarks
+
 This register is invalid in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md
@@ -10,4 +10,6 @@ ms.assetid: 14f6726d-e04b-4cce-8a85-4553fc38fcf7
 
 > illegal short forward reference with offset
 
+## Remarks
+
 Short forward references must refer to a label only. An additional offset cannot be used.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md
@@ -10,4 +10,6 @@ ms.assetid: 9d3fbc4c-40bb-42c7-bfd7-7656c40e2065
 
 > 'identifier' : name undefined in 'context'
 
+## Remarks
+
 An undefined identifier is used with the `SIZE`, `LENGTH`, or member-selection (.) operator.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md
@@ -10,4 +10,6 @@ ms.assetid: faf38041-cf0f-4624-b6f8-30ce0e1efc1e
 
 > illegal 'float' register in 'context'
 
+## Remarks
+
 An `NDP` register was specified in an invalid context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md
@@ -10,4 +10,6 @@ ms.assetid: 3dc4881a-3c33-4c4e-b18e-a1f0e21ea931
 
 > illegal type on PTR operator in 'context'
 
+## Remarks
+
 The first parameter of the `PTR` operator is not a legal type specification.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md
@@ -10,4 +10,6 @@ ms.assetid: 5d4aa952-0752-4412-b5c2-050dde0636f4
 
 > illegal type used as operator in 'context'
 
+## Remarks
+
 The type is not legal as an operator in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md
@@ -10,6 +10,8 @@ ms.assetid: b69b2de1-56f3-4ebc-8913-04ac57ffe8a1
 
 > 'identifier' : ambiguous member name in 'context'
 
+## Remarks
+
 The identifier is a member of more than one structure or union in this context.
 
 Use a structure or union specifier on the operand that caused the error. A structure or union specifier is an identifier of type **`struct`** or **`union`** (a **`typedef`** name or a variable of the same type as the structure or union being referenced). The specifier must be the left operand of the first member-selection operator (.) to use the operand.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md
@@ -10,4 +10,6 @@ ms.assetid: d1842b89-da09-4c35-89a1-84dc844a9f3e
 
 > 'label' : case-insensitive label redefined
 
+## Remarks
+
 The label is defined more than once in the current function. Change the spelling of the label and its references.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md
@@ -10,4 +10,6 @@ ms.assetid: d0403952-f41e-4b21-840d-ab4e44171838
 
 > 'token' : illegal align size
 
+## Remarks
+
 The size used with the `ALIGN` directive is missing or outside the valid range.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md
@@ -10,6 +10,8 @@ ms.assetid: f225c913-2bea-46b1-b096-3d358ac94a15
 
 > improper operand type
 
+## Remarks
+
 The opcode does not use operands of this type.
 
 ### To fix by checking the following possible causes
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md
@@ -10,4 +10,6 @@ ms.assetid: 8f42d7a8-5289-4f56-8404-23e5243274d2
 
 > divide by zero in 'context'
 
+## Remarks
+
 The parameter to the right of the division operator is zero in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md
@@ -10,6 +10,8 @@ ms.assetid: 00e4690f-04a0-4159-b358-b1e0664102c1
 
 > cannot delete browser file: filename
 
+## Remarks
+
 The compiler could not delete the browser file.
 
 ### To fix by checking the following possible causes
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md
@@ -10,4 +10,6 @@ ms.assetid: 51fe3195-34b6-445e-9f01-1e93e8714295
 
 > mod by zero in 'context'
 
+## Remarks
+
 The parameter to the right of the `MOD` operator is zero in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md
@@ -10,4 +10,6 @@ ms.assetid: cc11faab-a022-4702-ac8b-9864b916cfa2
 
 > 'identifier' : illegal symbol in context
 
+## Remarks
+
 The identifier is invalid in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md
@@ -10,4 +10,6 @@ ms.assetid: 0a9afb9f-60d8-4df7-b2ae-5c36e86df891
 
 > PTR operator used with register in 'context'
 
+## Remarks
+
 The `PTR` operator cannot be used with a **`register`** operand.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md
@@ -10,6 +10,8 @@ ms.assetid: ef0ec302-4028-4778-b134-0b8cea4bcad9
 
 > illegal segment override in 'operand'
 
+## Remarks
+
 Inline assembly code incorrectly uses a segment override operator (colon) on an operand.  Possible causes include:
 
 - The register preceding the operator is not a segment register.
@@ -20,6 +22,8 @@ Inline assembly code incorrectly uses a segment override operator (colon) on an
 
 - The expression following the segment override operator is not an immediate operand or a memory operand.
 
+## Example
+
 The following sample generates C2422:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md
@@ -10,8 +10,12 @@ ms.assetid: 8797fb8b-b58b-4add-b6e6-2a9a3cd9084d
 
 > 'number' : illegal scale
 
+## Remarks
+
 Inline assembly code uses a number other than 1, 2, 4, or 8 to scale a register.
 
+## Example
+
 The following sample generates C2423:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md
@@ -10,4 +10,6 @@ ms.assetid: 03613746-a324-4b8b-94c0-424e8b0aae94
 
 > 'token' : improper expression in 'context'
 
+## Remarks
+
 The token forms part of an incorrect expression in this context.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md
@@ -10,10 +10,14 @@ ms.assetid: 0ce59404-9aff-4e01-aa8d-27d23e92eb30
 
 > 'token' :non-constant expression in 'context'
 
+## Remarks
+
 The token forms part of a non-constant expression in this context.
 
 To fix this issue, replace the token with a constant literal or with a calculation.
 
+## Example
+
 The following sample generates C2425:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md
@@ -10,4 +10,6 @@ ms.assetid: 3428aeed-3f78-4675-9bc4-5b72f50eaaf6
 
 > 'token' : illegal operator in 'context'
 
+## Remarks
+
 The token cannot be used as an operator in this context. Index operators, for example, cannot be nested.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md
@@ -10,8 +10,12 @@ ms.assetid: a7d421af-6180-40b4-b7a6-9f3bc7dfaaf9
 
 > 'class' : cannot define class in this scope
 
+## Remarks
+
 An attempt was made to define a nested class, but the nested class is a member of a base class, not the most containing class.
 
+## Example
+
 The following sample generates C2427:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md
@@ -10,8 +10,12 @@ ms.assetid: 74aa5714-e930-4f9e-9061-68ccce7f0d38
 
 > 'operation' : not allowed on operand of type 'bool'
 
+## Remarks
+
 You cannot apply a decrement operator to objects of type **`bool`**.
 
+## Example
+
 The following sample generates C2428:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md
@@ -10,8 +10,12 @@ ms.assetid: 57ff6df9-5cf1-49f3-8bd8-4e550dfd65a0
 
 > '*language feature*' requires compiler flag '*compiler option*'
 
+## Remarks
+
 The language feature requires a specific compiler option for support.
 
+## Example
+
 The error **C2429: language feature 'nested-namespace-definition' requires compiler flag '/std:c++17'** is generated if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names, starting in Visual Studio 2015 Update 5. (In Visual Studio 2017 version 15.3, the **`/std:c++latest`** switch is required.) Compound namespace definitions are not allowed in C++ prior to C++17. The compiler supports compound namespace definitions when the [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) compiler option is specified:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md
@@ -10,6 +10,8 @@ ms.assetid: 07c20f76-63e1-4d22-b2a9-98b0d45c5cac
 
 > more than one index register in 'identifier'
 
+## Remarks
+
 More than one register is scaled. The compiler supports scaled indexing, but you can only scale one register.
 
 ## Example
