Skip to content

Commit d235736

Browse files
author
Colin Robertson
committed
Per Natalia, deprecate /ERRORREPORT
1 parent 1e37c36 commit d235736

16 files changed

+134
-164
lines changed

‎docs/assembler/arm/arm-assembler-command-line-reference.md‎

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
2-
title: "ARM Assembler Command-Line Reference"
3-
ms.date: "08/30/2018"
2+
title: "ARM Assembler command-line reference"
3+
description: "Reference guide to the Microsoft ARM assembler command-line options."
4+
ms.date: "02/09/2020"
45
ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
56
---
6-
# ARM Assembler Command-Line Reference
7+
# ARM Assembler command-line reference
78

89
This article provides command-line information about the Microsoft ARM assembler, *armasm*, which compiles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The linker can link COFF code with object code that is produced by the ARM assembler or by the C compiler, together with object libraries that are created by the librarian.
910

@@ -58,11 +59,7 @@ A combination of zero or more of the following:
5859
Generate debugging information.
5960

6061
- **-errorReport:** *option*<br/>
61-
Specify how internal assembler errors are reported to Microsoft. Possible values for *option* are:<br/>
62-
**none**—Do not send reports.<br/>
63-
**prompt**—Prompt the user to send reports immediately.<br/>
64-
**queue**—Prompt the user to send reports at the next admin logon. This is the default.<br/>
65-
**send**—Send reports automatically.
62+
This option is deprecated, and has no effect. Starting in Windows Vista, error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings.
6663

6764
*sourcefile*<br/>
6865
The name of the source file.
@@ -74,11 +71,12 @@ The name of the object (output) file.
7471

7572
The following example demonstrates how to use armasm in a typical scenario. First, use armasm to build an assembly language source (.asm) file to an object (.obj) file. Then, use the CL command-line C compiler to compile a source (.c) file, and also specify the linker option to link the ARM object file.
7673

77-
**armasm myasmcode.asm -o myasmcode.obj**
78-
79-
**cl myccode.c /link myasmcode.obj**
74+
```cmd
75+
armasm myasmcode.asm -o myasmcode.obj
76+
cl myccode.c /link myasmcode.obj
77+
```
8078

8179
## See also
8280

8381
[ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)<br/>
84-
[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)<br/>
82+
[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)

‎docs/assembler/masm/ml-and-ml64-command-line-reference.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
2-
title: "ML and ML64 Command-Line Reference"
3-
ms.date: "12/17/2019"
2+
title: "ML and ML64 command-line reference"
3+
description: "Reference guide to the Microsoft MASM ML and ML64 assembler command-line options."
4+
ms.date: "02/09/2020"
45
f1_keywords: ["ML"]
56
helpviewer_keywords: ["/W* MASM compiler option", "/c MASM compiler option", "/EP MASM compiler option", "/Fe MASM compiler option", "/Zp MASM compiler option", "/AT MASM compiler option", "/Zm MASM compiler option", "/Sf MASM compiler option", "/Sp MASM compiler option", "/w MASM compiler option", "/Fl MASM compiler option", "/coff MASM compiler option", "/St MASM compiler option", "/Cx MASM compiler option", "/Sl MASM compiler option", "/Cu MASM compiler option", "MASM (Microsoft Macro Assembler), ML command-line reference", "/FPi MASM compiler option", "/Zf MASM compiler option", "ML environment variable", "/Fr MASM compiler option", "/help MASM compiler option", "/Sa MASM compiler option", "/Zd MASM compiler option", "/I MASM compiler option", "/? MASM compiler option", "/Bl MASM compiler option", "/Fm MASM compiler option", "/Fo MASM compiler option", "command-line reference [ML]", "/Sn MASM compiler option", "/Gd MASM compiler option", "/D* MASM compiler option", "environment variables, ML", "/Gc MASM compiler option", "/F* MASM compiler option", "/Sc MASM compiler option", "/H MASM compiler option", "/Zs MASM compiler option", "/omf MASM compiler option", "/Sg MASM compiler option", "/Cp MASM compiler option", "/Zi MASM compiler option", "/nologo MASM compiler option", "/Sx MASM compiler option", "/WX MASM compiler option", "/Ss MASM compiler option", "command line, reference [ML]", "/Ta MASM compiler option"]
67
ms.assetid: 712623c6-f77e-47ea-a945-089e57c50b40
78
---
8-
# ML and ML64 Command-Line Reference
9+
# ML and ML64 command-line reference
910

1011
Assembles and links one or more assembly-language source files. The command-line options are case sensitive.
1112

@@ -33,7 +34,7 @@ The options listed in the following table.
3334
|**/Cx**|Preserves case in public and extern symbols.|
3435
|**/D** *symbol*⟦=*value*⟧|Defines a text macro with the given name. If *value* is missing, it is blank. Multiple tokens separated by spaces must be enclosed in quotation marks.|
3536
|**/EP**|Generates a preprocessed source listing (sent to STDOUT). See **/Sf**.|
36-
|**/ERRORREPORT** [ **NONE** &#124; **PROMPT** &#124; **QUEUE** &#124; **SEND** ]|If ml.exe or ml64.exe fails at runtime, you can use **/ERRORREPORT** to send information to Microsoft about these internal errors.<br /><br /> For more information about **/ERRORREPORT**, see [/errorReport (Report Internal Compiler Errors)](../../build/reference/errorreport-report-internal-compiler-errors.md).|
37+
|**/ERRORREPORT** [ **NONE** &#124; **PROMPT** &#124; **QUEUE** &#124; **SEND** ]| Deprecated. Error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings. |
3738
|**/F** *hexnum*|Sets stack size to *hexnum* bytes (this is the same as **/link/STACK**:*number*). The value must be expressed in hexadecimal notation. There must be a space between **/F** and *hexnum*.|
3839
|**/Fe** *filename*|Names the executable file.|
3940
|**/Fl**⟦*filename*⟧|Generates an assembled code listing. See **/Sf**.|

‎docs/build/reference/bscmake-options.md‎

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "BSCMAKE Options"
3-
ms.date: "11/04/2016"
3+
description: "Reference to the Microsoft BSCMAKE utility command-line options."
4+
ms.date: "02/09/2020"
45
f1_keywords: ["VC.Project.VCBscMakeTool.OutputFile", "VC.Project.VCBscMakeTool.SuppressStartupBanner", "VC.Project.VCBscMakeTool.PreserveSBR"]
56
helpviewer_keywords: ["/v BSCMAKE option", "Iu BSCMAKE option", "browse information files (.bsc), content", "/Er BSCMAKE option", "NOLOGO BSCMAKE option", "/s BSCMAKE option", "/Ei BSCMAKE option", "/o BSCMAKE option", "/NOLOGO BSCMAKE option", "/Iu BSCMAKE option", "s BSCMAKE option (/s)", "/Em BSCMAKE option", "Em BSCMAKE option", "Es BSCMAKE option", "files [C++], BSCMAKE", "Er BSCMAKE option", "BSCMAKE, options for controlling files", "controlling BSCMAKE options", "El BSCMAKE option", "/El BSCMAKE option", "/Es BSCMAKE option", "Ei BSCMAKE option"]
67
ms.assetid: fa2f1e06-c684-41cf-80dd-6a554835ebd2
@@ -14,53 +15,51 @@ This section describes the options available for controlling BSCMAKE. Several op
1415

1516
Only **/NOLOGO** and **/o** are available from within the Visual Studio development environment. See [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md) for information on access a project's property pages.
1617

17-
**/Ei (** *filename*...**)**<br/>
18+
**/Ei (** *filename*...**)**\
1819
Excludes the contents of the specified include files from the browse information file. To specify multiple files, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one *filename*. Use **/Ei** along with the **/Es** option to exclude files not excluded by **/Es**.
1920

20-
**/El**<br/>
21+
**/El**\
2122
Excludes local symbols. The default is to include local symbols. For more information about local symbols, see [Creating an .sbr File](creating-an-dot-sbr-file.md).
2223

23-
**/Em**<br/>
24+
**/Em**\
2425
Excludes symbols in the body of macros. Use **/Em** to include only the names of macros in the browse information file. The default is to include both the macro names and the result of the macro expansions.
2526

26-
**/Er (** *symbol*...**)**<br/>
27+
**/Er (** *symbol*...**)**\
2728
Excludes the specified symbols from the browse information file. To specify multiple symbol names, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one *symbol*.
2829

29-
**/Es**<br/>
30+
**/Es**\
3031
Excludes from the browse information file every include file specified with an absolute path or found in an absolute path specified in the INCLUDE environment variable. (Usually, these are the system include files, which contain a lot of information that you may not need in your browse information file.) This option does not exclude files specified without a path or with relative paths or files found in a relative path in INCLUDE. You can use the **/Ei** option along with **/Es** to exclude files that **/Es** does not exclude. If you want to exclude only some of the files that **/Es** excludes, use **/Ei** instead of **/Es** and list the files you want to exclude.
3132

32-
**/errorreport:**[**none** &#124; **prompt** &#124; **queue** &#124; **send**]<br/>
33-
Allows you to send information to Microsoft regarding internal errors in bscmake.exe.
33+
**/errorreport:**[**none** &#124; **prompt** &#124; **queue** &#124; **send**]\
34+
This option is deprecated, and has no effect. Starting in Windows Vista, error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings.
3435

35-
For more information on **/errorreport**, see [/errorReport (Report Internal Compiler Errors)](errorreport-report-internal-compiler-errors.md).
36-
37-
**/HELP**<br/>
36+
**/HELP**\
3837
Displays a summary of the BSCMAKE command-line syntax.
3938

40-
**/Iu**<br/>
39+
**/Iu**\
4140
Includes unreferenced symbols. By default, BSCMAKE does not record any symbols that are defined but not referenced. If an .sbr file has been packed, this option has no effect for that input file because the compiler has already removed the unreferenced symbols.
4241

43-
**/n**<br/>
42+
**/n**\
4443
Forces a nonincremental build. Use **/n** to force a full build of the browse information file whether or not a .bsc file exists and to prevent .sbr files from being truncated. See [How BSCMAKE Builds a .bsc File](how-bscmake-builds-a-dot-bsc-file.md).
4544

46-
**/NOLOGO**<br/>
45+
**/NOLOGO**\
4746
Suppresses the BSCMAKE copyright message.
4847

49-
**/o** *filename*<br/>
48+
**/o** *filename*\
5049
Specifies a name for the browse information file. By default, BSCMAKE gives the browse information file the base name of the first .sbr file and a .bsc extension.
5150

52-
**/S (** *filename*...**)**<br/>
51+
**/S (** *filename*...**)**\
5352
Tells BSCMAKE to process the specified include file the first time it is encountered and to exclude it otherwise. Use this option to save processing time when a file (such as a header, or .h, file for a .c or .cpp source file) is included in several source files but is unchanged by preprocessing directives each time. You may also want to use this option if a file is changed in ways that are unimportant for the browse information file you are creating. To specify multiple files, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one *filename*. If you want to exclude the file every time it is included, use the **/Ei** or **/Es** option.
5453

55-
**/v**<br/>
54+
**/v**\
5655
Provides verbose output, which includes the name of each .sbr file being processed and information about the complete BSCMAKE run.
5756

58-
**/?**<br/>
57+
**/?**\
5958
Displays a brief summary of BSCMAKE command-line syntax.
6059

6160
The following command line tells BSCMAKE to do a full build of MAIN.bsc from three .sbr files. It also tells BSCMAKE to exclude duplicate instances of TOOLBOX.h:
6261

63-
```
62+
```cmd
6463
BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr
6564
```
6665

0 commit comments

Comments
 (0)