kevinhartman
diff --git a/‎docs/TOC.md‎
Lines changed: 41 additions & 0 deletions b/‎docs/TOC.md‎
Lines changed: 41 additions & 0 deletions
diff --git a/‎docs/assembler/arm/TOC.md‎
Lines changed: 4 additions & 0 deletions b/‎docs/assembler/arm/TOC.md‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎docs/assembler/arm/arm-assembler-command-line-reference.md‎
Lines changed: 108 additions & 0 deletions b/‎docs/assembler/arm/arm-assembler-command-line-reference.md‎
Lines changed: 108 additions & 0 deletions
diff --git a/‎docs/assembler/arm/arm-assembler-diagnostic-messages.md‎
Lines changed: 142 additions & 0 deletions b/‎docs/assembler/arm/arm-assembler-diagnostic-messages.md‎
Lines changed: 142 additions & 0 deletions
@@ -0,0 +1,41 @@
+# [arm](assembler\arm\TOC.md)
+# [inline](assembler\inline\TOC.md)
+# [masm](assembler\masm\TOC.md)
+# [atl](atl\TOC.md)
+# [atl-mfc-shared](atl-mfc-shared\TOC.md)
+# [reference](atl-mfc-shared\reference\TOC.md)
+# [reference](atl\reference\TOC.md)
+# [build](build\TOC.md)
+# [reference](build\reference\TOC.md)
+# [c-language](c-language\TOC.md)
+# [c-runtime-library](c-runtime-library\TOC.md)
+# [reference](c-runtime-library\reference\TOC.md)
+# [cpp](cpp\TOC.md)
+# [data](data\TOC.md)
+# [ado-rdo](data\ado-rdo\TOC.md)
+# [odbc](data\odbc\TOC.md)
+# [oledb](data\oledb\TOC.md)
+# [dotnet](dotnet\TOC.md)
+# [compiler-errors-1](error-messages\compiler-errors-1\TOC.md)
+# [compiler-errors-2](error-messages\compiler-errors-2\TOC.md)
+# [compiler-warnings](error-messages\compiler-warnings\TOC.md)
+# [tool-errors](error-messages\tool-errors\TOC.md)
+# [ide](ide\TOC.md)
+# [intrinsics](intrinsics\TOC.md)
+# [mfc](mfc\TOC.md)
+# [reference](mfc\reference\TOC.md)
+# [misc](misc\TOC.md)
+# [parallel](parallel\TOC.md)
+# [amp](parallel\amp\TOC.md)
+# [reference](parallel\amp\reference\TOC.md)
+# [concrt](parallel\concrt\TOC.md)
+# [reference](parallel\concrt\reference\TOC.md)
+# [multithreading](parallel\multithreading\TOC.md)
+# [openmp](parallel\openmp\TOC.md)
+# [reference](parallel\openmp\reference\TOC.md)
+# [porting](porting\TOC.md)
+# [preprocessor](preprocessor\TOC.md)
+# [standard-library](standard-library\TOC.md)
+# [text](text\TOC.md)
+# [top](top\TOC.md)
+# [windows](windows\TOC.md)
@@ -0,0 +1,4 @@
+# [ARM Assembler Reference](arm-assembler-reference.md)
+# [ARM Assembler Command-Line Reference](arm-assembler-command-line-reference.md)
+# [ARM Assembler Directives](arm-assembler-directives.md)
+# [ARM Assembler Diagnostic Messages](arm-assembler-diagnostic-messages.md)
@@ -0,0 +1,108 @@
+---
+title: "ARM Assembler Command-Line Reference | Microsoft Docs"
+ms.custom: ""
+ms.date: "11/04/2016"
+ms.prod: "visual-studio-dev14"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "devlang-cpp"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "C++"
+ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
+caps.latest.revision: 12
+author: "corob-msft"
+ms.author: "corob"
+manager: "ghogen"
+translation.priority.ht: 
+  - "cs-cz"
+  - "de-de"
+  - "es-es"
+  - "fr-fr"
+  - "it-it"
+  - "ja-jp"
+  - "ko-kr"
+  - "pl-pl"
+  - "pt-br"
+  - "ru-ru"
+  - "tr-tr"
+  - "zh-cn"
+  - "zh-tw"
+---
+# ARM Assembler Command-Line Reference
+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.  
+  
+## Syntax  
+  
+```  
+armasm [[options]] sourcefile objectfile  
+```  
+  
+```  
+armasm [[options]] -o objectfile sourcefile  
+```  
+  
+#### Parameters  
+ `options`  
+ -errors `filename`  
+ Redirect error and warning messages to `filename`.  
+  
+ -i `dir[;dir]`  
+ Add the specified directories to the include search path.  
+  
+ -predefine `directive`  
+ Specify a SETA, SETL, or SETS directive to predefine a symbol. Example: **armasm.exe -predefine "COUNT SETA 150" source.asm**. For more information, see the [ARM assembler tools guide](http://go.microsoft.com/fwlink/?LinkId=246102).  
+  
+ -nowarn  
+ Disable all warning messages.  
+  
+ -ignore `warning`  
+ Disable the specified warning. For possible values, see the section about warnings.  
+  
+ -help  
+ Print the command-line help message.  
+  
+ -machine `machine`  
+ Specify the machine type to set in the PE header.  Possible values for `machine` are:  
+**ARM**—Sets the machine type to IMAGE_FILE_MACHINE_ARMNT. This is the default.   
+**THUMB**—Sets the machine type to IMAGE_FILE_MACHINE_THUMB.  
+  
+ -oldit  
+ Generate ARMv7-style IT blocks.  By default, ARMv8-compatible IT blocks are generated.  
+  
+ -via `filename`  
+ Read additional command-line arguments from `filename`.  
+  
+ -16  
+ Assemble source as 16-bit Thumb instructions.  This is the default.  
+  
+ -32  
+ Assemble source as 32-bit ARM instructions.  
+  
+ -g  
+ Generate debugging information.  
+  
+ -errorReport: `option`  
+ Specify how internal assembler errors are reported to Microsoft.  Possible values for `option` are:   
+**none**—Do not send reports.   
+**prompt**—Prompt the user to send reports immediately.   
+**queue**—Prompt the user to send reports at the next admin logon. This is the default.   
+**send**—Send reports automatically.  
+  
+ `sourcefile`  
+ The name of the source file.  
+  
+ `objectfile`  
+ The name of the object (output) file.  
+  
+ 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.  
+  
+ **armasm myasmcode.asm -o myasmcode.obj**  
+  
+ **cl myccode.c /link myasmcode.obj**  
+  
+## See Also  
+ [ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)   
+ [ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)
@@ -0,0 +1,142 @@
+---
+title: "ARM Assembler Diagnostic Messages | Microsoft Docs"
+ms.custom: ""
+ms.date: "11/04/2016"
+ms.prod: "visual-studio-dev14"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "devlang-cpp"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "C++"
+ms.assetid: 52b38267-6023-4bdc-a0ef-863362f48eec
+caps.latest.revision: 6
+author: "corob-msft"
+ms.author: "corob"
+manager: "ghogen"
+translation.priority.ht: 
+  - "cs-cz"
+  - "de-de"
+  - "es-es"
+  - "fr-fr"
+  - "it-it"
+  - "ja-jp"
+  - "ko-kr"
+  - "pl-pl"
+  - "pt-br"
+  - "ru-ru"
+  - "tr-tr"
+  - "zh-cn"
+  - "zh-tw"
+---
+# ARM Assembler Diagnostic Messages
+The Microsoft ARM assembler (*armasm*) emits diagnostic warnings and errors when it encounters them. This article describes the most commonly-encountered messages.  
+  
+## Syntax  
+  
+```  
+  
+filename(lineno) : [error|warning] Anum: message  
+```  
+  
+## Diagnostic Messages  
+  
+### Errors  
+ A2193: this instruction generates unpredictable behavior  
+ The ARM architecture cannot guarantee what happens when this instruction is executed.  For details about the well-defined forms of this instruction, consult the [ARM Architecture Reference Manual](http://go.microsoft.com/fwlink/?LinkId=246464).  
+  
+```  
+  
+ADD r0, r8, pc         ; A2193: this instruction generates unpredictable behavior  
+  
+```  
+  
+ A2196: instruction cannot be encoded in 16 bits  
+ The specified instruction cannot be encoded as a 16-bit Thumb instruction.  Specify a 32-bit instruction, or rearrange code to bring the target label into the range of a 16-bit instruction.  
+  
+ The assembler may attempt to encode a branch in 16 bits and fail with this error, even though a 32-bit branch is encodable. You can solve this problem by using the `.W` specifier to explicitly mark the branch as 32-bit.  
+  
+```  
+  
+  ADD.N r0, r1, r2      ; A2196: instruction cannot be encoded in 16 bits  
+  
+  B.W label             ; OK  
+  B.N label             ; A2196: instruction cannot be encoded in 16 bits  
+  SPACE 10000  
+label  
+  
+```  
+  
+ A2202: Pre-UAL instruction syntax not allowed in THUMB region  
+ Thumb code must use the Unified Assembler Language (UAL) syntax.  The old syntax is no longer accepted  
+  
+```  
+  
+ADDEQS r0, r1         ; A2202: Pre-UAL instruction syntax not allowed in THUMB region  
+ADDSEQ r0, r1         ; OK  
+  
+```  
+  
+ A2513: Rotation must be even  
+ In ARM mode, there is an alternate syntax for specifying constants.  Instead of writing `#<const>`, you can write `#<byte>,#<rot>`, which represents the constant value that is obtained by rotating the value `<byte>` right by `<rot>`.  When you use this syntax, you must make the value of `<rot>` even.  
+  
+```  
+  
+MOV r0, #4, #2       ; OK  
+MOV r0, #4, #1       ; A2513: Rotation must be even  
+  
+```  
+  
+ A2557: Incorrect number of bytes to write back  
+ On the NEON structure load and store instructions (`VLDn`, `VSTn`), there is an alternate syntax for specifying writeback to the base register.  Instead of putting an exclamation point (!) after the address, you can specify an immediate value that indicates the offset to be added to the base register.  If you use this syntax, you must specify the exact number of bytes that were loaded or stored by the instruction.  
+  
+```  
+  
+VLD1.8 {d0-d3}, [r0]!         ; OK  
+VLD1.8 {d0-d3}, [r0], #32     ; OK  
+VLD1.8 {d0-d3}, [r0], #100    ; A2557: Incorrect number of bytes to write back  
+  
+```  
+  
+### Warnings  
+ A4228: Alignment value exceeds AREA alignment; alignment not guaranteed  
+ The alignment that is specified in an `ALIGN` directive is greater than the alignment of the enclosing `AREA`.  As a result, the assembler cannot guarantee that the `ALIGN` directive will be honored.  
+  
+ To fix this, you can specify on the `AREA` directive an `ALIGN` attribute that is equal to or greater than the desired alignment.  
+  
+```  
+  
+AREA |.myarea1|  
+ALIGN 8           ; A4228: Alignment value exceeds AREA alignment; alignment not guaranteed  
+  
+AREA |.myarea2|,ALIGN=3  
+ALIGN 8           ; OK  
+  
+```  
+  
+ A4508: Use of this rotated constant is deprecated  
+ In ARM mode, there is an alternate syntax for specifying constants.  Instead of writing `#<const>`, you can write `#<byte>,#<rot>`, which represents the constant value that is obtained by rotating the value `<byte>` right by `<rot>`.  In some contexts, ARM has deprecated the use of these rotated constants. In these cases, use the basic `#<const>` syntax instead.  
+  
+```  
+  
+ANDS r0, r0, #1                ; OK  
+ANDS r0, r0, #4, #2            ; A4508: Use of this rotated constant is deprecated  
+  
+```  
+  
+ A4509: This form of conditional instruction is deprecated  
+ This form of conditional instruction has been deprecated by ARM in the ARMv8 architecture. We recommend that you change the code to use conditional branches. To see which conditional instructions are still supported, consult the [ARM Architecture Reference Manual](http://go.microsoft.com/fwlink/?LinkId=246464).  
+  
+ This warning is not emitted when the `-oldit` command-line switch is used.  
+  
+```  
+  
+ADDEQ r0, r1, r8              ; A4509: This form of conditional instruction is deprecated  
+  
+```  
+  
+## See Also  
+ [ARM Assembler Command-Line Reference](../../assembler/arm/arm-assembler-command-line-reference.md)   
+ [ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)