Add "Remarks" and "Example" headings for error references in range [C2851, C2880]

Rageking8 · web-flow · commit 055bafe15faa · 2025-08-09T23:01:33.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md
@@ -10,8 +10,12 @@ ms.assetid: 917fec9c-790a-4149-8dfc-00d17a09199c
 
 > syntax error in #pragma hdrstop
 
+## Remarks
+
 The `#pragma hdrstop` gives an invalid filename. The pragma can be followed by an optional filename in parentheses and quotation marks:
 
+## Example
+
 The following sample generates C2854:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md
@@ -9,10 +9,10 @@ helpviewer_keywords: ["C2855"]
 
 > command-line option '*option*' inconsistent with precompiled header
 
-This error occurs when a command-line option differs from the options used to create the precompiled header.
-
 ## Remarks
 
+This error occurs when a command-line option differs from the options used to create the precompiled header.
+
 Error C2855 can occur when you make an incremental build after changing a compiler option. It can also happen if you set specific compiler options for individual source files.
 
 To resolve this error, regenerate the precompiled header by using the specified command-line option. To regenerate the precompiled header, build the associated source file. For example, projects created by a Visual Studio template usually create a source file named *`pch.cpp`* to generate the precompiled header. (In older versions of Visual Studio, this file is named *`stdafx.cpp`*.) In other projects, the source file to rebuild is the one built by using the [`/Yc` (Create precompiled header file)](../../build/reference/yc-create-precompiled-header-file.md) compiler option. We recommend you rebuild your entire project after making a change to the precompiled header.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md
@@ -10,6 +10,8 @@ ms.assetid: fe616c51-124e-49e3-9dd8-883ec1660680
 
 > #pragma hdrstop cannot be inside an #if block
 
+## Remarks
+
 The `hdrstop` pragma cannot be placed inside the body of a conditional compilation block.
 
 Move the `#pragma hdrstop` statement to an area that is not contained in an `#if/#endif` block.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md
@@ -10,10 +10,10 @@ ms.assetid: b57302bd-58ec-45ae-992a-1e282d5eeccc
 
 > '#include' statement specified with the /Yc*filename* command-line option was not found in the source file
 
-The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled.
-
 ## Remarks
 
+The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled.
+
 When you use the **/Yc**<em>filename</em> option on a source file to create a precompiled header (PCH) file, that source file must include the *filename* header file. Every file included by the source file, up to and including the specified *filename*, is included in the PCH file. In other source files compiled by using the **/Yu**<em>filename</em> option to use the PCH file, an include of *filename* must be the first non-comment line in the file. The compiler ignores anything in the source file before this include.
 
 This error can be caused by an `#include "filename"` statement in a conditional compilation block that is not compiled in your PCH source file.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md
@@ -10,6 +10,8 @@ ms.assetid: 1fb1d770-307e-476e-9984-a1d8f8ce2820
 
 > command-line option '/Yc (/Fd*filename1*)' inconsistent with precompiled header, which used '/Fd*filename2*'
 
+## Remarks
+
 The program database specified by the Use Precompiled Header ([`/Yu`](../../build/reference/yu-use-precompiled-header-file.md)) option is not the one specified by the previous Create Precompiled Header ([`/Yc`](../../build/reference/yc-create-precompiled-header-file.md)) option.
 
 This error is obsolete in Visual Studio 2022 and later versions.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md
@@ -10,6 +10,8 @@ ms.assetid: fcfbc58d-08f6-4752-9688-8aaac517e684
 
 > filename is not the type file that was used when this precompiled header was created, recreate the precompiled header.
 
+## Remarks
+
 The project database and precompiled header files must be created together to ensure consistent information. Rebuild the project to recreate the precompiled header.
 
 For information on precompiled headers, see [/Y (Precompiled Headers)](../../build/reference/y-precompiled-headers.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2860"]
 
 > 'void' cannot be used as a function parameter except for '(void)'
 
+## Remarks
+
 A function parameter cannot be of type **`void`**.
 
+## Example
+
 The following sample generates C2860:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md
@@ -10,6 +10,8 @@ ms.assetid: 012bb44d-6c9b-4def-b54e-b19f1f8ddd1b
 
 > 'function name' : an interface member function cannot be defined
 
+## Remarks
+
 The compiler encountered the interface keyword or deduced a struct as an interface but then found a member function definition.  An interface cannot contain a definition for a member function.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md
@@ -10,8 +10,12 @@ ms.assetid: c04d8499-b799-48a1-9fb4-7902a0b0ac8e
 
 > 'interface' : an interface can only have public members
 
+## Remarks
+
 Protected and private members may be accessed only from other member functions. Such members are no use in an interface, since it may not provide implementations for any of its members.
 
+## Example
+
 The following sample will generate C2862:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md
@@ -10,8 +10,12 @@ ms.assetid: 32561d67-a795-486b-b3b6-4b90a1acb176
 
 > 'interface' : an interface cannot have friends
 
+## Remarks
+
 Declaring friends on an interface is not allowed.
 
+## Example
+
 The following sample generates C2863:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md
@@ -10,6 +10,8 @@ ms.assetid: 973eb6a0-c99a-4d25-b3e5-fe0539794d77
 
 > 'function' : illegal comparison for handle_or_pointer
 
+## Remarks
+
 You can compare references to [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) or managed reference types only for equality to see if they refer to the same object (==) or to different objects (!=).
 
 You cannot compare them for ordering because the .NET runtime might move managed objects at any time, changing the outcome of the test.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md
@@ -10,8 +10,12 @@ ms.assetid: 63be26b2-d9ab-4f3d-a8b7-981ce3e4d6b9
 
 > 'identifier' : is not a namespace
 
+## Remarks
+
 A **`using`** directive is applied to something other than a namespace.
 
+## Example
+
 The following sample generates C2867:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md
@@ -10,6 +10,8 @@ ms.assetid: 6ff5837b-e66d-44d1-9d17-80af35e08d08
 
 > '*identifier*' : illegal syntax for using-declaration; expected qualified-name
 
+## Remarks
+
 A [using declaration](../../cpp/using-declaration.md) requires a *qualified name*, a scope-operator (`::`) separated sequence of namespace, class, or enumeration names that ends with the identifier name. A single scope resolution operator may be used to introduce a name from the global namespace.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md
@@ -10,8 +10,12 @@ ms.assetid: 6e30c001-47f3-4101-b9f1-cc542c9fffae
 
 > 'name' : has already been defined to be a namespace
 
+## Remarks
+
 You cannot reuse a name already used as a namespace.
 
+## Example
+
 The following sample generates C2869:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md
@@ -10,8 +10,12 @@ ms.assetid: 80523ee9-1fd3-4dc4-8a77-5083deb99066
 
 > 'name' : a namespace definition must appear either at file scope or immediately within another namespace definition
 
+## Remarks
+
 You defined namespace `name` incorrectly. Namespaces must be defined at file scope (outside all blocks and classes) or immediately within another namespace.
 
+## Example
+
 The following sample generates C2870:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md
@@ -10,6 +10,8 @@ ms.assetid: 44aeb84d-61f0-45e0-8dad-22a3cd46b7f8
 
 > 'name' : a namespace with this name does not exist
 
+## Remarks
+
 This error will occur when you pass an identifier that is not a namespace to a [using](../../cpp/namespaces-cpp.md#using_directives) directive.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md
@@ -10,6 +10,8 @@ ms.assetid: c619ef97-6e0e-41d7-867c-f8d28a07d553
 
 > '*symbol*' : ambiguous symbol
 
+## Remarks
+
 The compiler cannot determine which symbol you are referring to. More than one symbol with the specified name is in scope. See the notes following the error message for the file locations and declarations the compiler found for the ambiguous symbol. To fix this issue, you can fully qualify the ambiguous symbol by using its namespace, for example, `std::byte` or `::byte`. You can also use a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to give an included namespace a convenient short name for use when disambiguating symbols in your source code.
 
 C2872 can occur if a header file includes a [using directive](../../cpp/namespaces-cpp.md#using_directives), and a subsequent header file is included that contains a type that is also in the namespace specified in the **`using`** directive. Specify a **`using`** directive only after all your header files are specified with `#include`.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md
@@ -10,4 +10,6 @@ ms.assetid: 7a10036b-400e-4364-bd2f-dcd7370c5e28
 
 > 'symbol' : symbol cannot be used in a using-declaration
 
+## Remarks
+
 A **`using`** directive is missing a [namespace](../../cpp/namespaces-cpp.md) keyword. This causes the compiler to misinterpret the code as a [using declaration](../../cpp/using-declaration.md) rather than a [using directive](../../cpp/namespaces-cpp.md#using_directives).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md
@@ -10,8 +10,12 @@ ms.assetid: b54fa9d8-8df5-40d9-9b3b-aa3e9dd6a3be
 
 > using-declaration causes a multiple declaration of 'symbol'
 
+## Remarks
+
 The declaration causes the same item to be defined twice.
 
+## Example
+
 The following sample generates C2874:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md
@@ -10,10 +10,14 @@ ms.assetid: d589fc0c-08b2-4a79-bc0e-dca5eb80bdd5
 
 > using-declaration causes a multiple declaration of 'class::identifier'
 
+## Remarks
+
 The declaration causes the same item to be defined twice.
 
 This error is obsolete in Visual Studio 2022 and later versions.
 
+## Example
+
 The following sample generates C2875:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md
@@ -10,8 +10,12 @@ ms.assetid: 8b674bf1-f9f4-4a8e-8127-e884c1d1708f
 
 > 'class::symbol' : not all overloads are accessible
 
+## Remarks
+
 All overloaded forms of a function in a base class must be accessible to the derived class.
 
+## Example
+
 The following sample generates C2876:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md
@@ -10,8 +10,12 @@ ms.assetid: 0b54837e-fcae-4d90-9658-623250435e24
 
 > 'symbol' is not accessible from 'class'
 
+## Remarks
+
 All members derived from a base class must be accessible in the derived class.
 
+## Example
+
 The following sample generates C2877:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md
@@ -10,8 +10,12 @@ ms.assetid: 83ee3de1-f554-49e8-a840-1f550cee7f69
 
 > 'name' : a namespace or class of this name does not exist
 
+## Remarks
+
 You made reference to a namespace or class that is not defined.
 
+## Example
+
 The following sample generates C2878:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md
@@ -10,8 +10,12 @@ ms.assetid: ac92b645-2394-49de-8632-43d44e0553ed
 
 > 'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition
 
+## Remarks
+
 You cannot create a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to a symbol other than a namespace.
 
+## Example
+
 The following sample generates C2879:
 
 ```cpp
