Add "Remarks" and "Example" headings for error references in range [C1051, C1080]

Rageking8 · web-flow · commit 48f00ee8c931 · 2025-07-03T19:07:33.000+08:00
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md
@@ -10,4 +10,6 @@ ms.assetid: 87dcbd3b-0952-499a-bd42-64f9e8de2605
 
 > program database file, 'pdbfile', has an obsolete format, delete it and recompile
 
+## Remarks
+
 The compiler cannot update the program database file, which has an older version number. Delete the file and recompile your program with **/Zi** or **/ZI**. For more information, see [/Z7, /Zi, /ZI (Debug Information Format)](../../build/reference/z7-zi-zi-debug-information-format.md)
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md
@@ -10,6 +10,8 @@ ms.assetid: f2c09a2f-d3c1-4420-9501-ffcb65caf87b
 
 > program database file, '*filename*', was generated by the linker with /DEBUG:fastlink; compiler cannot update such PDB files; please delete it or use /Fd to specify a different PDB filename
 
+## Remarks
+
 The compiler cannot update the same program database (PDB) files which are generated by the linker when the [/DEBUG:fastlink](../../build/reference/debug-generate-debug-info.md) option is specified. Normally the compiler-generated PDB files and the linker-generated PDB files have different names. However, if they are set to use the same names, this error can result.
 
 To fix this issue, you can explicitly delete the PDB files before you compile again, or you can create different names for the compiler-generated and linker-generated PDB files.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md
@@ -10,6 +10,8 @@ ms.assetid: f50c1c6a-d9cc-42fa-984e-4e2e6e9cd1b1
 
 > '<identifier>' : function too large
 
+## Remarks
+
 The function is too large to compile.
 
 ### To fix by using the following possible solutions
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md
@@ -10,6 +10,8 @@ ms.assetid: 9cfb7307-b22a-4418-b7c0-2621b0ab5b1b
 
 > compiler limit : initializers nested too deeply
 
+## Remarks
+
 The code exceeds the nesting limit on initializers (10-15 levels, depending on the combination of types being initialized).
 
 ### To fix by using the following possible solutions
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md
@@ -10,6 +10,8 @@ ms.assetid: a9fb9190-d7eb-4d5f-b1a2-a41e584a28c1
 
 > compiler limit : out of keys
 
+## Remarks
+
 The source file contains too many symbols. The compiler ran out of hash keys for the symbol table.
 
 ### To fix by using the following possible solutions
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md
@@ -10,4 +10,6 @@ ms.assetid: 1e67e727-963d-42c5-8c32-c0e370d32735
 
 > unexpected end of file in macro expansion
 
+## Remarks
+
 The compiler reached the end of the source file while gathering macro-invocation arguments, probably due to a missing right parenthesis in the macro invocation.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md
@@ -10,6 +10,8 @@ ms.assetid: feaf305c-c84c-4160-b974-50e283412849
 
 > compiler is out of heap space
 
+## Remarks
+
 The operating system or run-time library cannot fill a request for memory.
 
 ### To fix this error try the following possible solutions
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md
@@ -10,6 +10,8 @@ ms.assetid: 9366c0bc-96e0-4967-aa7d-4ebf098de806
 
 > compiler limit : blocks nested too deeply
 
+## Remarks
+
 Nesting of code blocks exceeds the limit of 128 nesting levels. This is a hard limit in the compiler for both C and C++, in both the 32-bit and 64-bit tool set. The count of nesting levels can be increased by anything that creates a scope or block. For example, namespaces, using directives, preprocessor expansions, template expansion, exception handling, loop constructs, and else-if clauses can all increase the nesting level seen by the compiler.
 
 To fix this error you must refactor your code. In any case, deeply nested code is difficult to understand and reason about. Refactoring your code to have fewer nesting levels may improve code quality and simplify maintenance. Break deeply nested code into functions that are called from the original context. Limit the number of loops or chained else-if clauses within a block.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md
@@ -10,4 +10,6 @@ ms.assetid: d4598a28-b8f6-4e78-a0c6-db324f5bdfc3
 
 > compiler limit : token overflowed internal buffer
 
+## Remarks
+
 An identifier exceeds the length of the internal buffer used for identifiers. Shorten the name.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md
@@ -10,6 +10,8 @@ ms.assetid: 80a27e13-696d-4199-a284-0d6b07446ff3
 
 > compiler limit : out of tags
 
+## Remarks
+
 The source file contains more than 65,523 classes, structs, unions, namespaces, or enums.
 
 Split the file into smaller files.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md
@@ -10,6 +10,8 @@ ms.assetid: e2c94be6-4573-4571-aac9-73d657fe9f96
 
 > compiler limit : 64K limit on size of a type record has been exceeded
 
+## Remarks
+
 This error could occur if a symbol has a decorated name exceeding 247 characters.  To resolve, shorten the symbol name.
 
 When the compiler generates debug information, it emits type records to define types encountered in source code.  For example, type records include simple structures and argument lists of functions.  Some of these type records can be large lists.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md
@@ -10,4 +10,6 @@ ms.assetid: 3b4abd16-4552-4900-84be-54f6ebb6c785
 
 > cannot open file 'file'
 
+## Remarks
+
 Ensure that `file` is not in use by another program.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md
@@ -10,8 +10,12 @@ ms.assetid: 1058269a-5db6-4c23-a97f-b5269eb9188b
 
 > mismatched #if/#endif pair in file 'filename'
 
+## Remarks
+
 An `#if`, `#ifdef`, or `#ifndef` directive has no corresponding `#endif`.
 
+## Example
+
 The following sample generates C1070:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md
@@ -10,6 +10,8 @@ ms.assetid: 489f1786-370e-4ecd-af67-538fe6e5bd4e
 
 > unexpected end of file found in comment
 
+## Remarks
+
 The compiler reached the end of the file while scanning a comment.
 
 ### To fix by checking the following possible causes
@@ -18,6 +20,8 @@ The compiler reached the end of the file while scanning a comment.
 
 1. Missing newline character after a comment on the last line of a source file.
 
+## Example
+
 The following sample generates C1071:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md
@@ -10,6 +10,8 @@ ms.assetid: a946fcf1-674e-4a7a-a28c-b1effacbabe1
 
 > Internal error involving incremental compilation (compiler file '*filename*', line *number*)
 
+## Remarks
+
 Recompile the file without using incremental compilation.
 
 This error is obsolete in Visual Studio 2022 and later versions.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md
@@ -10,4 +10,6 @@ ms.assetid: 979d4ab2-0f1a-472a-85f8-71f48297274f
 
 > 'IDB' is illegal extension for PDB file: filename
 
+## Remarks
+
 The compiler expects program databases to have the .pdb extension.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md
@@ -10,6 +10,8 @@ ms.assetid: 69a74e3d-b53f-4526-a440-2c94e6403355
 
 > the left token was unmatched at the end of the file
 
+## Remarks
+
 The compiler expected matching *token* before it reached the end of file.
 
 This error can be caused by an unmatched bracket, brace, or other paired character.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md
@@ -10,6 +10,8 @@ ms.assetid: 84ac1180-3e8a-48e8-9f77-7f18a778b964
 
 > compiler limit : internal heap limit reached; use /Zm to specify a higher limit
 
+## Remarks
+
 This error can be caused by too many symbols, or too many template instantiations. Starting in Visual Studio 2015, this message may result from Windows virtual memory pressure caused by too many parallel build processes. In this case, the recommendation to use the **/Zm** option should be ignored unless you are using a `#pragma hdrstop` directive.
 
 To resolve this error:
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md
@@ -10,6 +10,8 @@ ms.assetid: 514d66f4-b512-479a-b793-ebf45c91e15b
 
 > compiler limit : cannot have more than number command line options
 
+## Remarks
+
 The number of command-line options exceeds the internal limit.
 
 There may be too many symbols defined with [/D](../../build/reference/d-preprocessor-definitions.md). (Place the definitions in a header file instead.)
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md
@@ -10,6 +10,8 @@ ms.assetid: cf06a65a-f9a5-4bd8-8128-201a6cbe2113
 
 > compiler limit : PCH file size limit exceeded
 
+## Remarks
+
 The PCH file exceeds the 4 GB size limit.
 
 This error is obsolete in Visual Studio 2022 and later versions.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md
@@ -10,4 +10,6 @@ ms.assetid: 01e9e7c0-6a20-4539-b9d2-d27e7afcc8e6
 
 > compiler limit : command line option exceeded limit of number characters
 
+## Remarks
+
 An argument passed to the compiler exceeds 256 characters.
