From e94dda38cb0ae1c3cc4e9f84b72ea843b46e2161 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:16:29 +0800 Subject: [PATCH 1/3] Add blockquotes for error messages in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8021.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8022.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8027.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8036.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8037.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8045.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index e71b3d6cd07..c9d4ad5b508 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -8,7 +8,7 @@ ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 --- # Command-Line Error D8016 -'option1' and 'option2' command-line options are incompatible +> 'option1' and 'option2' command-line options are incompatible The command-line options cannot be specified together. diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 5daada8340c..4623eb4eedc 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -8,6 +8,6 @@ ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 --- # Command-Line Error D8021 -invalid numeric argument 'number' +> invalid numeric argument 'number' A number greater than 65,534 was specified as a numeric argument. diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index 0fde42f9251..a96fc7f0267 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -8,7 +8,7 @@ ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b --- # Command-Line Error D8022 -cannot open 'messagefile' +> cannot open 'messagefile' The given file was not in the current directory or in a directory specified in the PATH environment variable. The message file contains a brief summary of compiler command-line syntax and options. diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index 9fb55846634..2c3ddadf48d 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -8,7 +8,7 @@ ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 --- # Command-Line Error D8027 -cannot execute 'component' +> cannot execute 'component' The compiler could not run the given compiler component or linker. diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 86973440583..3e3a1c40d2d 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -8,7 +8,7 @@ ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 --- # Command-Line Error D8036 -'/option' not allowed with multiple source files +> '/option' not allowed with multiple source files These compiler options cannot be used with multiple source files: diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index d85b75168da..a1481b4c3b0 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -8,7 +8,7 @@ ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d --- # Command-Line Error D8037 -cannot create temporary il file; clean temp directory of old il files +> cannot create temporary il file; clean temp directory of old il files There is not enough space to create temporary compiler intermediate files. To remedy this error, remove any old MSIL files in the directory specified by the **TMP** environment variable. These files will be of the form _CL_hhhhhhhh.ss, where h represents a random hexadecimal digit and ss represents the type of IL file. Also, be sure to update your machine with the latest operating system patches. diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index fad1a656cf8..9eeb050064f 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -8,7 +8,7 @@ ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 --- # Command-Line Error D8045 -cannot compile C file 'file' with the /clr option +> cannot compile C file 'file' with the /clr option Only C++ source code files can be passed to a compilation that uses **/clr**. Use **/TP** to compile a .c file as a .cpp file; see [/Tc, /Tp, /TC, /TP (Specify Source File Type)](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) for more information. From 489e93eb6063f42dd97dea0d64ff9172ca92eff2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:18:21 +0800 Subject: [PATCH 2/3] Add "Remarks" headings for error references in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8021.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8022.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8027.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8036.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8037.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8045.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8048.md | 4 ++-- docs/error-messages/tool-errors/command-line-error-d8049.md | 4 ++-- 9 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index c9d4ad5b508..1fe996958e8 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -10,6 +10,8 @@ ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 > 'option1' and 'option2' command-line options are incompatible +## Remarks + The command-line options cannot be specified together. Check environment variables, such as CL, for option specifications. diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 4623eb4eedc..2e0b943bf5e 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -10,4 +10,6 @@ ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 > invalid numeric argument 'number' +## Remarks + A number greater than 65,534 was specified as a numeric argument. diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index a96fc7f0267..e4528f28403 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -10,6 +10,8 @@ ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b > cannot open 'messagefile' +## Remarks + The given file was not in the current directory or in a directory specified in the PATH environment variable. The message file contains a brief summary of compiler command-line syntax and options. Move this file to the current directory or a directory in the current path. If this file cannot be found, run the SETUP program to copy it from the distribution disks. diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index 2c3ddadf48d..a59a6e4acb4 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -10,6 +10,8 @@ ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 > cannot execute 'component' +## Remarks + The compiler could not run the given compiler component or linker. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 3e3a1c40d2d..3fc557944f4 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -10,6 +10,8 @@ ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 > '/option' not allowed with multiple source files +## Remarks + These compiler options cannot be used with multiple source files: - Name assembly file listing (/Fa) diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index a1481b4c3b0..48cb2eeff43 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -10,6 +10,8 @@ ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d > cannot create temporary il file; clean temp directory of old il files +## Remarks + There is not enough space to create temporary compiler intermediate files. To remedy this error, remove any old MSIL files in the directory specified by the **TMP** environment variable. These files will be of the form _CL_hhhhhhhh.ss, where h represents a random hexadecimal digit and ss represents the type of IL file. Also, be sure to update your machine with the latest operating system patches. ## See also diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index 9eeb050064f..03fda0dd403 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -10,6 +10,8 @@ ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 > cannot compile C file 'file' with the /clr option +## Remarks + Only C++ source code files can be passed to a compilation that uses **/clr**. Use **/TP** to compile a .c file as a .cpp file; see [/Tc, /Tp, /TC, /TP (Specify Source File Type)](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) for more information. For more information, see [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). diff --git a/docs/error-messages/tool-errors/command-line-error-d8048.md b/docs/error-messages/tool-errors/command-line-error-d8048.md index 65fa5514cab..9f126105634 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8048.md +++ b/docs/error-messages/tool-errors/command-line-error-d8048.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8048"] > cannot compile C file '*file-name*' with /ZW option -Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. - ## Remarks +Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. + By default, all files in a C++ Universal Windows platform (UWP) project are compiled by using the **`/ZW`** compiler option. The **`/ZW`** option enables the Windows Runtime compiler extensions, or C++/CX. Unfortunately, **`/ZW`** doesn't work on C source files. You can disable C++/CX compilation selectively for C files in Visual Studio projects. Select your C file in Solution Explorer, then right-click to choose **Properties** from the shortcut menu. In the **Property Pages** dialog, select the **Configuration Properties** > **C/C++** -> **General** property page. Set the **Consume Windows Runtime Extension** property to *`No`*. Choose **OK** to save your changes. diff --git a/docs/error-messages/tool-errors/command-line-error-d8049.md b/docs/error-messages/tool-errors/command-line-error-d8049.md index ec848363813..a4322d5ba1b 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8049.md +++ b/docs/error-messages/tool-errors/command-line-error-d8049.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8049"] > cannot execute '*compiler-component*': command line is too long to fit in debug record -An internal length limit on debug record include paths was exceeded. - ## Remarks +An internal length limit on debug record include paths was exceeded. + When the compiler creates debug records in an object file, it uses the full path for each included file. Absolute paths are recorded as specified. For relative include paths, the debug record prepends the build's current working directory to the relative path. If your build runs in a relatively deep path, the corresponding path records get longer. The total length of too many long paths can exceed the internal limits of the compiler. ## To resolve this issue From da0ebf9968271ef6dcac8562326f0a99cfe1a198 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:20:37 +0800 Subject: [PATCH 3/3] Update metadata for error references in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8021.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8022.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8027.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8036.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8037.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8045.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8048.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8049.md | 2 +- 9 files changed, 16 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index 1fe996958e8..6378c6f5ad7 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8016" title: "Command-Line Error D8016" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8016" +ms.date: 11/04/2016 f1_keywords: ["D8016"] helpviewer_keywords: ["D8016"] -ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 --- # Command-Line Error D8016 diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 2e0b943bf5e..67f23270441 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8021" title: "Command-Line Error D8021" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8021" +ms.date: 11/04/2016 f1_keywords: ["D8021"] helpviewer_keywords: ["D8021"] -ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 --- # Command-Line Error D8021 diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index e4528f28403..430d8c3d87a 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8022" title: "Command-Line Error D8022" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8022" +ms.date: 11/04/2016 f1_keywords: ["D8022"] helpviewer_keywords: ["D8022"] -ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b --- # Command-Line Error D8022 diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index a59a6e4acb4..886b134653b 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8027" title: "Command-Line Error D8027" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8027" +ms.date: 11/04/2016 f1_keywords: ["D8027"] helpviewer_keywords: ["D8027"] -ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 --- # Command-Line Error D8027 diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 3fc557944f4..986134ce3d3 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8036" title: "Command-Line Error D8036" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8036" +ms.date: 11/04/2016 f1_keywords: ["D8036"] helpviewer_keywords: ["D8036"] -ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 --- # Command-Line Error D8036 diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index 48cb2eeff43..be3f25d3a85 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8037" title: "Command-Line Error D8037" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8037" +ms.date: 11/04/2016 f1_keywords: ["D8037"] helpviewer_keywords: ["D8037"] -ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d --- # Command-Line Error D8037 diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index 03fda0dd403..0297b0dbfcc 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8045" title: "Command-Line Error D8045" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8045" +ms.date: 11/04/2016 f1_keywords: ["D8045"] helpviewer_keywords: ["D8045"] -ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 --- # Command-Line Error D8045 diff --git a/docs/error-messages/tool-errors/command-line-error-d8048.md b/docs/error-messages/tool-errors/command-line-error-d8048.md index 9f126105634..39dcd944558 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8048.md +++ b/docs/error-messages/tool-errors/command-line-error-d8048.md @@ -1,6 +1,6 @@ --- -description: "Learn about causes and solutions for command-line error D8048" title: "Command-Line Error D8048" +description: "Learn about causes and solutions for command-line error D8048" ms.date: 04/18/2021 f1_keywords: ["D8048"] helpviewer_keywords: ["D8048"] diff --git a/docs/error-messages/tool-errors/command-line-error-d8049.md b/docs/error-messages/tool-errors/command-line-error-d8049.md index a4322d5ba1b..24c359f7583 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8049.md +++ b/docs/error-messages/tool-errors/command-line-error-d8049.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and solutions for command-line error D8049" title: "Command-Line Error D8049" +description: "Learn about the cause and solutions for command-line error D8049" ms.date: 10/28/2021 f1_keywords: ["D8049"] helpviewer_keywords: ["D8049"]