fixes per peer review and added toc entry

mikeblome · mikeblome · commit dcb02f3ac373 · 2019-12-18T13:11:39.000-08:00
diff --git a/docs/assembler/masm/dosseg.md b/docs/assembler/masm/dosseg.md
@@ -1,13 +1,13 @@
 ---
 title: "DOSSEG"
-ms.date: "11/05/2019"
+ms.date: "12/17/2019"
 f1_keywords: ["DOSSEG"]
 helpviewer_keywords: ["DOSSEG directive"]
 ms.assetid: 4312826a-1547-4d48-bfd7-cfaf6d037609
 ---
 # DOSSEG
 
-(32-bit MASM only.) Identical to [.DOSSEG](dot-dosseg.md), which is the preferred form. (32-bit MASM only.)
+(32-bit MASM only.) Identical to [.DOSSEG](dot-dosseg.md), which is the preferred form.
 
 ## Syntax
 
diff --git a/docs/assembler/masm/dot-code.md b/docs/assembler/masm/dot-code.md
@@ -24,4 +24,5 @@ Optional parameter that specifies the name of the code segment. The default name
 
 [Directives Reference](directives-reference.md)\
 [.DATA](dot-data.md)\
-[MASM BNF Grammar](masm-bnf-grammar.md)\
+[MASM BNF Grammar](masm-bnf-grammar.md)
+
diff --git a/docs/assembler/masm/dot-data-q.md b/docs/assembler/masm/dot-data-q.md
@@ -5,14 +5,15 @@ f1_keywords: [".DATA?"]
 helpviewer_keywords: [".DATA? directive"]
 ms.assetid: f454f8d7-e23b-458c-a2c4-8441f1afdc82
 ---
-# .DATA? (32-bit MASM)
+# .DATA?
 
-When used with [.MODEL](dot-model.md), starts a near data segment for uninitialized data (segment name _BSS).
+(32-bit MASM only.) When used with [.MODEL](dot-model.md), starts a near data segment for uninitialized data (segment name _BSS).
 
 ## Syntax
 
-> **.DATA?** 
+> **.DATA?**\
 > ⟦ *segmentItem* ⟧...
+
 ## See also
 
 [Directives Reference](directives-reference.md)\
diff --git a/docs/assembler/masm/dot-data.md b/docs/assembler/masm/dot-data.md
@@ -12,7 +12,7 @@ ms.assetid: 32797935-9c79-46e0-bf6f-07d0c2bf1dc1
 ## Syntax
 
 > **.DATA**\
-> ⟦ *segmentItem* ⟧...\
+> ⟦ *segmentItem* ⟧...
 
 ## See also
 
@@ -21,4 +21,5 @@ ms.assetid: 32797935-9c79-46e0-bf6f-07d0c2bf1dc1
 [.CONST](dot-const.md)\
 [.FARDATA](dot-fardata.md)\
 [.FARDATA?](dot-fardata-q.md)\
-[MASM BNF Grammar](masm-bnf-grammar.md)\
+[MASM BNF Grammar](masm-bnf-grammar.md)
+
diff --git a/docs/assembler/masm/dot-pushreg.md b/docs/assembler/masm/dot-pushreg.md
@@ -17,7 +17,8 @@ Generates a `UWOP_PUSH_NONVOL` unwind code entry for the specified register numb
 
 **.PUSHREG** allows ml64.exe users to specify how a frame function unwinds, and is only allowed within the prologue, which extends from the [PROC](proc.md) **FRAME** declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. **.PUSHREG** should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement.
 
-*register* may be one of `RAX | RCX | RDX | RBX | RDI | RSI | RBP | R8 | R9 | R10 | R11 | R12 | R13 | R14 | R15`.
+*register* may be one of:\
+RAX | RCX | RDX | RBX | RDI | RSI | RBP | R8 | R9 | R10 | R11 | R12 | R13 | R14 | R15.
 
 For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md).
 
@@ -51,5 +52,5 @@ END
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/dot-savereg.md b/docs/assembler/masm/dot-savereg.md
@@ -21,5 +21,5 @@ For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md).
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/dot-sfcond.md b/docs/assembler/masm/dot-sfcond.md
@@ -15,5 +15,5 @@ See [.NOLISTIF](dot-nolistif.md).
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/elseif-masm.md b/docs/assembler/masm/elseif-masm.md
@@ -15,7 +15,7 @@ Combines [ELSE](else-masm.md) and [IF](if-masm.md) into one statement.
 > *statements*\
 > ⟦**ELSE**\
 > *else-statements*⟧\
-> **ENDIF**\
+> **ENDIF**
 
 ## Remarks
 
@@ -24,4 +24,4 @@ See [IF](if-masm.md) for more information.
 ## See also
 
 [Directives reference](directives-reference.md)\
-[MASM BNF Grammar](masm-bnf-grammar.md)
+[MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/if-masm.md b/docs/assembler/masm/if-masm.md
@@ -25,5 +25,5 @@ The following directives may be substituted for [ELSEIF](elseif-masm.md): **ELSE
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/invoke.md b/docs/assembler/masm/invoke.md
@@ -7,7 +7,7 @@ ms.assetid: 12d9bb40-33b9-411e-b801-45a1d675967e
 ---
 # INVOKE
 
-(32-bit MASM only.) Calls the procedure at the address given by *expression*, passing the arguments on the stack or in registers according to the standard calling conventions of the language type. (32-bit MASM only.)
+(32-bit MASM only.) Calls the procedure at the address given by *expression*, passing the arguments on the stack or in registers according to the standard calling conventions of the language type.     
 
 ## Syntax
 
diff --git a/docs/assembler/masm/local-masm.md b/docs/assembler/masm/local-masm.md
@@ -13,13 +13,13 @@ In the first directive, within a macro, **LOCAL** defines labels that are unique
 
 > **LOCAL** *localId* ⟦, *localId* ...⟧
 >
-> **LOCAL** *label* ⟦ __\[__*count*__]__ ⟧ ⟦__:__*qualifiedType*⟧ ⟦__,__ *label* ⟦ __\[__*count*__]__ ⟧ ⟦*qualifiedType*⟧ ...⟧
+> **LOCAL** *labelId* ⟦ __\[__*count*__]__ ⟧ ⟦__:__*qualifiedType*⟧ ⟦__,__ *labelId* ⟦ __\[__*count*__]__ ⟧ ⟦*qualifiedType*⟧ ...⟧
 
 ## Remarks
 
 In the second directive, within a procedure definition (**PROC**), **LOCAL** creates stack-based variables that exist for the duration of the procedure. The *labelId* may be a simple variable or an array containing *count* elements, where *count* is a constant expression.
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/macro.md b/docs/assembler/masm/macro.md
@@ -19,11 +19,12 @@ Marks a macro block called *name* and establishes *parameter* placeholders for a
 
 ## Remarks
 
-A macro function returns *value* to the calling statement. 
+A macro function returns *value* to the calling statement.
 
 ## See also
 
-[Directives reference](directives-reference.md)
-[GOTO (MASM)](goto-masm.md)
-[ENDM](endm.md)
+[Directives reference](directives-reference.md)\
+[GOTO (MASM)](goto-masm.md)\
+[ENDM](endm.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
+
diff --git a/docs/assembler/masm/masm-bnf-grammar.md b/docs/assembler/masm/masm-bnf-grammar.md
@@ -253,21 +253,19 @@ possible definition for qualifiedType, which is also a component of the definiti
 &nbsp;&nbsp;&nbsp;&nbsp;**OFFSET** *e10*\
 &nbsp;&nbsp;&nbsp;&nbsp;| **SEG** *e10*\
 &nbsp;&nbsp;&nbsp;&nbsp;| **LROFFSET** *e10*\
-&nbsp;&nbsp;&nbsp;&nbsp;| **TYPE**\
-&nbsp;&nbsp;&nbsp;&nbsp;e10\\
-&nbsp;&nbsp;&nbsp;&nbsp;| **THIS**\
-&nbsp;&nbsp;&nbsp;&nbsp;e10\
+&nbsp;&nbsp;&nbsp;&nbsp;| **TYPE** *e10*\
+&nbsp;&nbsp;&nbsp;&nbsp;| **THIS** *e10*\
 &nbsp;&nbsp;&nbsp;&nbsp;| *e09* **PTR** *e10*\
 &nbsp;&nbsp;&nbsp;&nbsp;| *e09* : *e10*\
 &nbsp;&nbsp;&nbsp;&nbsp;| *e10*
 
 *e10*\
-e10 . *e11*\
+&nbsp;&nbsp;&nbsp;&nbsp;*e10* . *e11*\
 &nbsp;&nbsp;&nbsp;&nbsp;| *e10* ⟦ *expr* ⟧\
 &nbsp;&nbsp;&nbsp;&nbsp;| *e11*
 
 *e11*\
-( *expr* )\
+&nbsp;&nbsp;&nbsp;&nbsp;( *expr* )\
 &nbsp;&nbsp;&nbsp;&nbsp;| ⟦ *expr* ⟧\
 &nbsp;&nbsp;&nbsp;&nbsp;| **WIDTH** *id*\
 &nbsp;&nbsp;&nbsp;&nbsp;| **MASK** *id*\
@@ -1059,8 +1057,7 @@ untilDir ;;
 &nbsp;&nbsp;&nbsp;&nbsp;*id*
 
 *untilDir*\
-&nbsp;&nbsp;&nbsp;&nbsp;**.UNTIL**\
-&nbsp;&nbsp;&nbsp;&nbsp;*cExpr* ;;\
+&nbsp;&nbsp;&nbsp;&nbsp;**.UNTIL** *cExpr* ;;\
 &nbsp;&nbsp;&nbsp;&nbsp;**.UNTILCXZ** ⟦ *cxzExpr* ⟧ ;;
 
 *usesRegs*\
diff --git a/docs/assembler/masm/microsoft-macro-assembler-reference.md b/docs/assembler/masm/microsoft-macro-assembler-reference.md
@@ -31,7 +31,8 @@ Provides links to websites that may contain programming information about proces
 [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md)\
 Information about how to create output files for x64.
 
-[MASM BNF Grammar](masm-bnf-grammar.md)\
+[MASM BNF Grammar](masm-bnf-grammar.md)
+
 Formal BNF description of MASM for x64.
 
 ## Related Sections
diff --git a/docs/assembler/masm/mmword.md b/docs/assembler/masm/mmword.md
@@ -29,7 +29,7 @@ While both instructions work on 64-bit operands, **QWORD** is the type for 64-bi
 
 ```asm
     movq     mm0, mmword ptr [ebx]
-```\
+```
 
 ## See Also
 
diff --git a/docs/assembler/masm/operators-reference.md b/docs/assembler/masm/operators-reference.md
@@ -82,5 +82,5 @@ ms.assetid: c069cab7-d6b0-4f82-a6ce-0ca3fc7e6428
 
 ## See also
 
-[Microsoft Macro Assembler Reference](microsoft-macro-assembler-reference.md)\\
+[Microsoft Macro Assembler Reference](microsoft-macro-assembler-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/page.md b/docs/assembler/masm/page.md
@@ -17,5 +17,5 @@ The first directive sets line *length* and character *width* of the program list
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/public-masm.md b/docs/assembler/masm/public-masm.md
@@ -19,5 +19,5 @@ The *language-type* argument is valid in 32-bit MASM only.
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/record-masm.md b/docs/assembler/masm/record-masm.md
@@ -15,5 +15,5 @@ Declares a record type consisting of the specified fields. *fieldname* names the
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/segment.md b/docs/assembler/masm/segment.md
@@ -56,5 +56,5 @@ For `ALIGN(n)`, *n* may be any power of 2 from 1 to 8192; not supported with **/
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/substr.md b/docs/assembler/masm/substr.md
@@ -15,5 +15,5 @@ Returns a substring of *textitem*, starting at *position*. The *textitem* can be
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/subtitle.md b/docs/assembler/masm/subtitle.md
@@ -15,5 +15,5 @@ Defines the listing subtitle. Same as [SUBTTL](subttl.md).
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/title.md b/docs/assembler/masm/title.md
@@ -15,5 +15,5 @@ Defines the program listing title.
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/assembler/masm/typedef-masm.md b/docs/assembler/masm/typedef-masm.md
@@ -11,7 +11,7 @@ Defines a new type or **PROTO** called *name*, which is equivalent to *type* or
 
 ## Syntax
 
-> *name* **TYPEDEF** *type* | ⟦**PROTO** *protoDefinition*⟧
+> *name* **TYPEDEF** *type* | **PROTO** *protoDefinition*
 
 ## See also
 
diff --git a/docs/assembler/masm/while-masm.md b/docs/assembler/masm/while-masm.md
@@ -17,5 +17,5 @@ Repeats assembly of block *statements* as long as *constantExpression* remains t
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)
diff --git a/docs/toc.yml b/docs/toc.yml
@@ -5869,6 +5869,8 @@
                       href: assembler/masm/ml-warning-a4012.md
                     - name: ML warning A4014
                       href: assembler/masm/ml-warning-a4014.md
+            - name: MASM BNF grammar
+              href: assembler/masm/masm-bnf-grammar.md
         - name: Component extensions for .NET and UWP
           expanded: false
           items: 
