Merge pull request #3252 from corob-msft/docs/corob/lexical-grammar

Lexical Grammar update for C17

Author: ttorble

.openpublishing.redirection.json

@@ -700,6 +700,41 @@
       "redirect_url": "/cpp/build-insights/reference/wpa-views",
       "redirect_document_id": false
     },
+    {
+      "source_path": "docs/c-language/operators-c.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/punctuators.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/summary-of-constants.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/summary-of-identifiers.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/summary-of-keywords.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/summary-of-string-literals.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-language/summary-of-tokens.md",
+      "redirect_url": "/cpp/c-language/lexical-grammar",
+      "redirect_document_id": false
+    },
     {
       "source_path": "docs/cloud/index.md",
       "redirect_url": "/cpp/cloud/cloud-and-web-programming-in-visual-cpp",

docs/c-language/c-assignment-operators.md

@@ -1,6 +1,7 @@
 ---
 title: "C Assignment Operators"
-ms.date: "06/14/2018"
+description: "The standard C language assignment operators, their syntax and meaning."
+ms.date: 10/30/2020
 helpviewer_keywords: ["remainder assignment operator (%=)", "&= operator", "bitwise-AND assignment operator", "operators [C], assignment", "operators [C], shift", "^= operator, assignment operators", "+= operator", ">>= operator", "|= operator", "division assignment operator", "subtraction operator", "right shift operators", "subtraction operator, C assignment operators", "= operator, assignment operators", "*= operator", ">> operator", "%= operator", "assignment operators, C", "= operator", "assignment operators", "assignment conversions", "-= operator", "multiplication assignment operator (*=)", "shift operators, right", "/= operator", "operator >>=, C assignment operators", "<<= operator"]
 ms.assetid: 11688dcb-c941-44e7-a636-3fc98e7dac40
 ---
@@ -10,28 +11,28 @@ An assignment operation assigns the value of the right-hand operand to the stora
 
 ## Syntax
 
-*assignment-expression*:<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;*conditional-expression*<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;*unary-expression* *assignment-operator* *assignment-expression*
+*`assignment-expression`*:\
+&emsp;*`conditional-expression`*\
+&emsp;*`unary-expression`* *`assignment-operator`* *`assignment-expression`*
 
-*assignment-operator*: one of<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;**=** **\*=** **/=** **%=** **+=** **-=** **\<\<=** **>>=** **&=** **^=** **|=**
+*`assignment-operator`*: one of<br/>
+&emsp;**`=`** **`*=`** **`/=`** **`%=`** **`+=`** **`-=`** **`<<=`** **`>>=`** **`&=`** **`^=`** **`|=`**
 
 The assignment operators in C can both transform and assign values in a single operation. C provides the following assignment operators:
 
 |Operator|Operation Performed|
 |--------------|-------------------------|
-|**=**|Simple assignment|
-|**&#42;=**|Multiplication assignment|
-|**/=**|Division assignment|
-|**%=**|Remainder assignment|
-|**+=**|Addition assignment|
-|**-=**|Subtraction assignment|
-|**<\<=**|Left-shift assignment|
-|**>>=**|Right-shift assignment|
-|**&=**|Bitwise-AND assignment|
-|**^=**|Bitwise-exclusive-OR assignment|
-|**&#124;=**|Bitwise-inclusive-OR assignment|
+|**`=`**|Simple assignment|
+|**`*=`**|Multiplication assignment|
+|**`/=`**|Division assignment|
+|**`%=`**|Remainder assignment|
+|**`+=`**|Addition assignment|
+|**`-=`**|Subtraction assignment|
+|**`<<=`**|Left-shift assignment|
+|**`>>=`**|Right-shift assignment|
+|**`&=`**|Bitwise-AND assignment|
+|**`^=`**|Bitwise-exclusive-OR assignment|
+|**`|=`**|Bitwise-inclusive-OR assignment|
 
 In assignment, the type of the right-hand value is converted to the type of the left-hand value, and the value is stored in the left operand after the assignment has taken place. The left operand must not be an array, a function, or a constant. The specific conversion path, which depends on the two types, is outlined in detail in [Type Conversions](../c-language/type-conversions-c.md).
 

docs/c-language/c-keywords.md

@@ -1,7 +1,7 @@
 ---
 title: "C Keywords"
 description: "Keywords in Standard C and Microsoft C compiler extensions."
-ms.date: 10/15/2020
+ms.date: 10/30/2020
 helpviewer_keywords: ["keywords [C]", "redefining keywords", "Microsoft-specific keywords"]
 ms.assetid: 2d932335-97bf-45cd-b367-4ae00db0ff42
 ---
@@ -87,31 +87,30 @@ The following keywords and special identifiers are recognized by the Microsoft C
 :::row:::
     :::column:::
         **`__asm`**<sup>5</sup>\
-        **`dllimport`**<sup>4</sup>\
-        **`__int8`**<sup>5</sup>\
-        **`naked`**<sup>4</sup>\
-        **`__based`**<sup>3, 5</sup>
-    :::column-end:::
-    :::column:::
-        **`__except`**<sup>5</sup>\
-        **`__int16`**<sup>5</sup>\
-        **`__stdcall`**<sup>5</sup>\
+        **`__based`**<sup>3, 5</sup>\
         **`__cdecl`**<sup>5</sup>\
-        **`__fastcall`**
+        **`__declspec`**<sup>5</sup>\
+        **`__except`**<sup>5</sup>\
+        **`__fastcall`**\
+        **`__finally`**<sup>5</sup>
     :::column-end:::
     :::column:::
+        **`__inline`**<sup>5</sup>\
+        **`__int16`**<sup>5</sup>\
         **`__int32`**<sup>5</sup>\
-        **`thread`**<sup>4</sup>\
-        **`__declspec`**<sup>5</sup>\
-        **`__finally`**<sup>5</sup>\
-        **`__int64`**<sup>5</sup>
+        **`__int64`**<sup>5</sup>\
+        **`__int8`**<sup>5</sup>\
+        **`__leave`**<sup>5</sup>\
+        **`__restrict`**
     :::column-end:::
     :::column:::
+        **`__stdcall`**<sup>5</sup>\
         **`__try`**<sup>5</sup>\
         **`dllexport`**<sup>4</sup>\
-        **`__inline`**<sup>5</sup>\
-        **`__leave`**<sup>5</sup>\
-        **`static_assert`**<sup>6</sup>
+        **`dllimport`**<sup>4</sup>\
+        **`naked`**<sup>4</sup>\
+        **`static_assert`**<sup>6</sup>\
+        **`thread`**<sup>4</sup>
     :::column-end:::
 :::row-end:::