Add "Remarks" and "Example" headings for warning references in range [C4121, C4160]

Rageking8 · web-flow · commit 91296d78b74d · 2025-08-26T23:22:36.000+08:00
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md
@@ -10,6 +10,8 @@ ms.assetid: 9a83eb0d-8708-42f7-988a-b0b6f2f646a0
 
 > 'function' : alloc_text applicable only to functions with C linkage
 
+## Remarks
+
 The **alloc_text** pragma applies only to functions declared with **extern c**. It cannot be used with external C++ functions.
 
 The pragma is ignored.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md
@@ -10,6 +10,8 @@ ms.assetid: c08c3a65-9584-47a1-a147-44f00c4b230e
 
 > __fastcall with stack checking is inefficient
 
+## Remarks
+
 The **`__fastcall`** keyword was used with stack checking enabled.
 
 The **`__fastcall`** convention generates faster code, but stack checking causes slower code. When using **`__fastcall`**, turn off stack checking with the **check_stack** pragma or /Gs.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md
@@ -10,12 +10,16 @@ ms.assetid: a4190c64-4bfb-48fd-8e98-52720bc0d878
 
 > 'character' : unrecognized character escape sequence
 
+## Remarks
+
 The `character` following a backslash (\\) in a character or string constant is not recognized as a valid escape sequence. The backslash is ignored and not printed. The character following the backslash is printed.
 
 To print a single backslash, specify a double backslash (\\\\).
 
 The C++ standard, in section 2.13.2 discusses escape sequences.
 
+## Example
+
 The following sample generates C4129:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md
@@ -10,6 +10,8 @@ ms.assetid: 65ebf929-bba0-4237-923b-c1b66adfe17d
 
 > '*/' found outside of comment
 
+## Remarks
+
 The closing-comment delimiter is not preceded by an opening-comment delimiter. The compiler assumes a space between the asterisk (<strong>\*</strong>) and the forward slash (/).
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md
@@ -10,6 +10,8 @@ ms.assetid: 1fdfc3dc-60a2-4f00-b133-20e400f9b7a6
 
 > benign redefinition of type
 
+## Remarks
+
 A type is redefined in a manner that has no effect on the generated code.
 
 To fix by checking the following possible causes:
@@ -18,6 +20,8 @@ To fix by checking the following possible causes:
 
 - A type defined with the **`typedef`** command is redefined using different syntax.
 
+## Example
+
 The following sample generates C4142:
 
 ```c
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md
@@ -10,4 +10,6 @@ ms.assetid: ef0bd19f-d169-4034-8710-b22971bd642d
 
 > pragma 'same_seg' not supported; use __based allocation
 
+## Remarks
+
 The **#pragma same_seg** is no longer supported. Use the [__based](../../cpp/based-pointers-cpp.md) keyword instead.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md
@@ -10,7 +10,13 @@ ms.assetid: a37b445d-dbc6-43b4-8d95-ffd0e4225464
 
 > 'expression' : relational expression as switch expression
 
-The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. The following sample generates C4144:
+## Remarks
+
+The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values.
+
+## Example
+
+The following sample generates C4144:
 
 ```cpp
 // C4144.cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md
@@ -10,6 +10,8 @@ ms.assetid: 0440777a-cca2-4159-aff5-e67a254ad64a
 
 > 'expression1' : relational expression as switch expression; possible confusion with 'expression2'
 
+## Remarks
+
 A **`switch`** statement uses a relational expression as its control expression, which results in a Boolean value for the **`case`** statements. Did you mean *expression2*?
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md
@@ -10,4 +10,6 @@ ms.assetid: 37a15754-9dba-470b-adda-c4b888064b3e
 
 > function/data pointer conversion in expression
 
+## Remarks
+
 A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md
@@ -10,6 +10,8 @@ ms.assetid: 4511afeb-e893-4cc6-83b6-4c7a0477f76b
 
 > deletion of an array expression; conversion to pointer supplied
 
+## Remarks
+
 You cannot use **`delete`** on an array, so the compiler converts the array to a pointer.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md
@@ -10,6 +10,8 @@ ms.assetid: ba233353-09e3-4195-8127-13a27ddd8d70
 
 > deletion of an array expression without using the array form of 'delete'
 
+## Remarks
+
 The array form of **`delete`** should be used to delete an array. This warning occurs only under ANSI-compatibility (/Za).
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md
@@ -10,4 +10,6 @@ ms.assetid: 6dabc303-eba1-4a8e-a124-a6e1dc84f4bd
 
 > pragma was ignored by C compiler
 
+## Remarks
+
 Only the C++ compiler recognizes **init_seg()**.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md
@@ -10,4 +10,6 @@ ms.assetid: 6513c6b9-6772-4849-b96c-5bb093d54de6
 
 > assuming #pragma pointers_to_members(full_generality, inheritance)
 
+## Remarks
+
 A `#pragma pointers_to_members( single | multiple | virtual )` was issued without an accompanying `#pragma pointers_to_members(full_generality)`.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md
@@ -9,10 +9,10 @@ helpviewer_keywords: ["C4146"]
 
 > unary minus operator applied to unsigned type, result still unsigned
 
-Unsigned types only hold non-negative values. So unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative.
-
 ## Remarks
 
+Unsigned types only hold non-negative values. So unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative.
+
 When you express a negative integer literal, the **`-`** in front of the value is parsed as a [unary negation](../../cpp/unary-plus-and-negation-operators-plus-and.md) operator. The compiler applies the operator after it parses the numeric value. If the numeric value fits in the range of an unsigned integer type, but not the corresponding signed integer type, the compiler interprets the value as unsigned.
 
 This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll. The reason is because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps:
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C4150"]
 
 > deletion of pointer to incomplete type 'type'; no destructor called
 
+## Remarks
+
 The `delete` operator is called to delete a type that was declared but not defined. The compiler can't find the destructor to call because the definition isn't in the same translation unit as the `delete`.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md
@@ -10,6 +10,8 @@ ms.assetid: 9adf3acb-c0fe-42a8-a4db-5822b1493f77
 
 > deletion of an array expression without using the array form of 'delete'; array form substituted
 
+## Remarks
+
 The non-array form of **`delete`** cannot delete an array. The compiler translated **`delete`** to the array form.
 
 This warning occurs only under Microsoft extensions (/Ze).
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C4133"]
 
 > '*expression*': incompatible types - from '*type1*' to '*type2*'
 
+## Remarks
+
 This warning is emitted when incompatible types are used in an expression. For example, doing arithmetic operations such as subtraction with different pointer types.
 
 To avoid this warning, provide an appropriate type cast.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md
@@ -10,7 +10,13 @@ ms.assetid: 8c5b85c9-2543-426b-88bc-319c50158c7e
 
 > 'symbol' : alignment of a member was sensitive to packing
 
-The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. For example, the following code snippet produces C4121:
+## Remarks
+
+The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size.
+
+## Example
+
+For example, the following code snippet produces C4121:
 
 ```cpp
 // C4121.cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md
@@ -10,6 +10,8 @@ ms.assetid: a081d1f4-0789-4915-91df-7ff0b28ca245
 
 > decimal digit terminates octal escape sequence
 
+## Remarks
+
 The compiler evaluates the octal number without the decimal digit and assumes the decimal digit is a character.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md
@@ -16,7 +16,7 @@ The controlling expression of an **`if`** statement or **`while`** loop evaluate
 
 If the controlling expression of a **`while`** loop is a constant because the loop exits in the middle, consider replacing the **`while`** loop with a **`for`** loop. You can omit the initialization, termination test and loop increment of a **`for`** loop, which causes the loop to be infinite, just like `while(1)`, and you can exit the loop from the body of the **`for`** statement.
 
-## Example
+## Examples
 
 The following sample shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning:
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md
@@ -10,8 +10,12 @@ ms.assetid: 45e4c7b2-6b51-41c7-ba5e-941aa5c7d3dc
 
 > 'operator' : logical operation on address of string constant
 
+## Remarks
+
 Using the operator with the address of a string literal produces unexpected code.
 
+## Example
+
 The following sample generates C4130:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md
@@ -10,10 +10,14 @@ ms.assetid: 7903b3e1-454f-4be2-aa9b-230992f96a2d
 
 > 'function' : uses old-style declarator
 
+## Remarks
+
 The specified function declaration is not in prototype form.
 
 Old-style function declarations should be converted to prototype form.
 
+## Example
+
 The following example shows an old-style function declaration:
 
 ```c
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md
@@ -10,4 +10,6 @@ ms.assetid: b60e5b4a-53ac-4503-8456-235477f48afd
 
 > 'object' : const object should be initialized
 
+## Remarks
+
 The constant is not initialized. The value of a symbol with the **`const`** attribute cannot be changed after its definition, it should be given an initialization value.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md
@@ -10,4 +10,6 @@ ms.assetid: 6025ab70-d7cf-4730-913a-3ca0b1186a3a
 
 > non standard extension, function/data ptr conversion in expression
 
+## Remarks
+
 A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C.
