preprocessor formatting review pr4

Author: mtx48109

docs/preprocessor/predefined-macros.md

@@ -22,7 +22,7 @@ Visual C++ supports the required predefined preprocessor macros specified by the
 
 The compiler supports this predefined identifier specified by ISO C99 and ISO C++11.
 
-- **__func__** The unqualified and unadorned name of the enclosing function as a function-local `static const` array of `char`.
+- **__func__** The unqualified and unadorned name of the enclosing function as a function-local **static const** array of **char**.
 
     ```cpp
     void example(){
@@ -60,7 +60,7 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 - **__AVX2__** Defined as 1 when the [/arch:AVX2](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined.
 
-- **_CHAR_UNSIGNED** Defined as 1 if the default `char` type is unsigned. This is set when the [/J (Default char Type Is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined.
+- **_CHAR_UNSIGNED** Defined as 1 if the default **char** type is unsigned. This is set when the [/J (Default char Type Is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined.
 
 - **__CLR_VER** Defined as an integer literal that represents the version of the common language runtime used when the application was compiled. The value is encoded in the form `Mmmbbbbb`, where `M` is the major version of the runtime, `mm` is the minor version of the runtime, and `bbbbb` is the build number. **__CLR_VER** is defined if the [/clr](../build/reference/clr-common-language-runtime-compilation.md) compiler option is set. Otherwise, undefined.
 
@@ -178,9 +178,9 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 - **_M_ARM_FP** Defined as an integer literal value that indicates which [/arch](../build/reference/arch-arm.md) compiler option was set, if the compilation target is an ARM processor. Otherwise, undefined.
 
-  - In the range 30-39 if no **/arch** ARM option was specified, indicating the default architecture for ARM was set (`VFPv3`).
+  - In the range 30-39 if no `/arch` ARM option was specified, indicating the default architecture for ARM was set (`VFPv3`).
 
-  - In the range 40-49 if **/arch:VFPv4** was set.
+  - In the range 40-49 if `/arch:VFPv4` was set.
 
   - See [/arch (ARM)](../build/reference/arch-arm.md) for more information.
 
@@ -204,11 +204,11 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 - **_M_IX86_FP** Defined as an integer literal value that indicates the [/arch](../build/reference/arch-arm.md) compiler option that was set, or the default. This macro is always defined when the compilation target is an x86 processor. Otherwise, undefined. When defined, the value is:
 
-  - 0 if the **/arch:IA32** compiler option was set.
+  - 0 if the `/arch:IA32` compiler option was set.
 
-  - 1 if the **/arch:SSE** compiler option was set.
+  - 1 if the `/arch:SSE` compiler option was set.
 
-  - 2 if the **/arch:SSE2**, **/arch:AVX** or **/arch:AVX2** compiler option was set. This value is the default if an **/arch** compiler option was not specified. When **/arch:AVX** is specified, the macro **__AVX__** is also defined. When **/arch:AVX2** is specified, both **__AVX__** and **__AVX2__** are also defined.
+  - 2 if the `/arch:SSE2`, `/arch:AVX` or `/arch:AVX2` compiler option was set. This value is the default if an `/arch` compiler option was not specified. When `/arch:AVX` is specified, the macro **__AVX__** is also defined. When `/arch:AVX2` is specified, both **__AVX__** and **__AVX2__** are also defined.
 
   - See [/arch (x86)](../build/reference/arch-x86.md) for more information.
 
@@ -220,9 +220,9 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 - **_MSC_EXTENSIONS** Defined as 1 if the [/Ze (Enable Language Extensions)](../build/reference/za-ze-disable-language-extensions.md) compiler option is set, which is the default. Otherwise, undefined.
 
-- **_MSC_FULL_VER** Defined as an integer literal that encodes the major, minor, and build number elements of the compiler's version number. The major number is the first element of the period-delimited version number, the minor number is the second element, and the build number is the third element. For example, if the version number of the Visual C++ compiler is 15.00.20706.01, the **_MSC_FULL_VER** macro evaluates to 150020706. Enter **cl /?** at the command line to view the compiler's version number. This macro is always defined.
+- **_MSC_FULL_VER** Defined as an integer literal that encodes the major, minor, and build number elements of the compiler's version number. The major number is the first element of the period-delimited version number, the minor number is the second element, and the build number is the third element. For example, if the version number of the Visual C++ compiler is 15.00.20706.01, the **_MSC_FULL_VER** macro evaluates to 150020706. Enter `cl /?` at the command line to view the compiler's version number. This macro is always defined.
 
-- **_MSC_VER** Defined as an integer literal that encodes the major and minor number elements of the compiler's version number. The major number is the first element of the period-delimited version number and the minor number is the second element. For example, if the version number of the Visual C++ compiler is 17.00.51106.1, the **_MSC_VER** macro evaluates to 1700. Enter **cl /?** at the command line to view the compiler's version number. This macro is always defined.
+- **_MSC_VER** Defined as an integer literal that encodes the major and minor number elements of the compiler's version number. The major number is the first element of the period-delimited version number and the minor number is the second element. For example, if the version number of the Visual C++ compiler is 17.00.51106.1, the **_MSC_VER** macro evaluates to 1700. Enter `cl /?` at the command line to view the compiler's version number. This macro is always defined.
 
    |Visual Studio version|_MSC_VER|
    |-|-|
@@ -280,7 +280,7 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 - **_VC_NODEFAULTLIB** Defined as 1 when the [/Zl (Omit Default Library Name)](../build/reference/zl-omit-default-library-name.md) compiler option is set. Otherwise, undefined.
 
-- **_WCHAR_T_DEFINED** Defined as 1 when the default [/Zc:wchar_t](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. The **_WCHAR_T_DEFINED** macro is defined but has no value if the **/Zc:wchar_t-** compiler option is set, and `wchar_t` is defined in a system header file included in your project. Otherwise, undefined.
+- **_WCHAR_T_DEFINED** Defined as 1 when the default [/Zc:wchar_t](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. The **_WCHAR_T_DEFINED** macro is defined but has no value if the `/Zc:wchar_t-` compiler option is set, and **wchar_t** is defined in a system header file included in your project. Otherwise, undefined.
 
 - **_WIN32** Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, or x64. Otherwise, undefined.
 
@@ -298,4 +298,4 @@ Microsoft Visual C++ supports these additional predefined macros.
 
 [Macros (C/C++)](../preprocessor/macros-c-cpp.md)   
 [Preprocessor Operators](../preprocessor/preprocessor-operators.md)   
-[Preprocessor Directives](../preprocessor/preprocessor-directives.md)
+[Preprocessor Directives](../preprocessor/preprocessor-directives.md)

docs/preprocessor/preprocessor-directives.md

@@ -13,9 +13,9 @@ ms.workload: ["cplusplus"]
 ---
 # Preprocessor Directives
 
-Preprocessor directives, such as `#define` and **#ifdef**, are typically used to make source programs easy to change and easy to compile in different execution environments. Directives in the source file tell the preprocessor to perform specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor lines are recognized and carried out before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, that command is not recognized by the preprocessor.
+Preprocessor directives, such as `#define` and `#ifdef`, are typically used to make source programs easy to change and easy to compile in different execution environments. Directives in the source file tell the preprocessor to perform specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor lines are recognized and carried out before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, that command is not recognized by the preprocessor.
 
-Preprocessor statements use the same character set as source file statements, with the exception that escape sequences are not supported. The character set used in preprocessor statements is the same as the [execution character set](http://msdn.microsoft.com/en-us/a7901c61-524d-47c6-beb6-d9dacc2e72ed). The preprocessor also recognizes negative character values.
+Preprocessor statements use the same character set as source file statements, with the exception that escape sequences are not supported. The character set used in preprocessor statements is the same as the [execution character set](http://msdn.microsoft.com/a7901c61-524d-47c6-beb6-d9dacc2e72ed). The preprocessor also recognizes negative character values.
 
 The preprocessor recognizes the following directives:
 

docs/preprocessor/preprocessor-grammar.md

@@ -14,87 +14,88 @@ ms.workload: ["cplusplus"]
 # Preprocessor Grammar
 **#define**  *identifier* *token-string*opt  
 
- *#* **define**  *identifier*[**(** *identifier*opt**,** *...* **,** *identifier*opt **)**] *token-string*opt  
+*#* **define**  *identifier*[**(** *identifier*opt**,** *...* **,** *identifier*opt **)**] *token-string*opt  
 
- **defined(**  *identifier* **)**  
+**defined(**  *identifier* **)**  
 
- **defined**  *identifier*  
+**defined**  *identifier*  
 
- `#include` **"***path-spec***"**  
+`#include` **"***path-spec***"**  
 
- `#include` **\<***path-spec***>**  
+`#include` **\<***path-spec***>**  
 
- **#line**  *digit-sequence*  **"** *filename* **"**opt  
+**#line**  *digit-sequence*  **"** *filename* **"**opt  
 
- *#* **undef**  *identifier*  
+*#* **undef**  *identifier*  
 
- **#error**  *token-string*  
+**#error**  *token-string*  
 
- **#pragma**  *token-string*  
+**#pragma**  *token-string*  
 
- *conditional* :  
- *if-part elif-parts*opt*else-part*opt*endif-line*  
+*conditional* :  
+*if-part elif-parts*opt*else-part*opt*endif-line*  
 
- *if-part* :  
- *if-linetext*  
+*if-part* :  
+*if-linetext*  
 
- *if-line* :  
- **#if**  *constant-expression*  
+*if-line* :  
+**#if**  *constant-expression*  
 
- **#ifdef**  *identifier*  
+**#ifdef**  *identifier*  
 
- **#ifndef**  *identifier*  
+**#ifndef**  *identifier*  
 
- *elif-parts* :  
- *elif-line text*  
+*elif-parts* :  
+*elif-line text*  
 
- *elif-parts elif-line text*  
+*elif-parts elif-line text*  
 
- *elif-line* :  
- **#elif**  *constant-expression*  
+*elif-line* :  
+**#elif**  *constant-expression*  
 
- *else-part* :  
- *else-linetext*  
+*else-part* :  
+*else-linetext*  
 
- *else-line* :  
- `#else`  
+*else-line* :  
+`#else`  
 
- *endif-line* :  
- `#endif`  
+*endif-line* :  
+`#endif`  
 
- *digit-sequence* :  
- *digit*  
+*digit-sequence* :  
+*digit*  
 
- *digit-sequence digit*  
+*digit-sequence digit*  
 
- *digit* : one of  
- **0 1 2 3 4 5 6 7 8 9**  
+*digit* : one of  
+**0 1 2 3 4 5 6 7 8 9**  
 
- *token-string* :  
- String of tokens  
+*token-string* :  
+String of tokens  
 
- *token* :  
- *keyword*  
+*token* :  
+*keyword*  
 
- *identifier*  
+*identifier*  
 
- *constant*  
+*constant*  
 
- *operator*  
+*operator*  
 
- `punctuator`  
+`punctuator`  
 
- *filename* :  
- Legal operating system filename  
+*filename* :  
+Legal operating system filename  
 
- *path-spec* :  
- Legal file path  
+*path-spec* :  
+Legal file path  
 
- *text* :  
- Any sequence of text  
+*text* :  
+Any sequence of text  
 
 > [!NOTE]
->  The following nonterminals are expanded in the [Lexical Conventions](../cpp/lexical-conventions.md) section of the *C++ Language Reference*: `constant`, `constant`-*expression*, *identifier*, *keyword*, `operator`, and `punctuator`.  
+> The following nonterminals are expanded in the [Lexical Conventions](../cpp/lexical-conventions.md) section of the *C++ Language Reference*: `constant`, `constant`-*expression*, *identifier*, *keyword*, `operator`, and `punctuator`.  
   
 ## See Also  
- [Grammar Summary (C/C++)](../preprocessor/grammar-summary-c-cpp.md)
+ 
+[Grammar Summary (C/C++)](../preprocessor/grammar-summary-c-cpp.md)

docs/preprocessor/preprocessor-operators.md

@@ -12,7 +12,7 @@ ms.author: "corob"
 ms.workload: ["cplusplus"]
 ---
 # Preprocessor Operators
-Four preprocessor-specific operators are used in the context of the `#define` directive (see the following list for a summary of each). The stringizing, charizing, and token-pasting operators are discussed in the next three sections. For information on the **defined** operator, see [The #if, #elif, #else, and #endif Directives](../preprocessor/hash-if-hash-elif-hash-else-and-hash-endif-directives-c-cpp.md).  
+Four preprocessor-specific operators are used in the context of the `#define` directive (see the following list for a summary of each). The stringizing, charizing, and token-pasting operators are discussed in the next three sections. For information on the `defined` operator, see [The #if, #elif, #else, and #endif Directives](../preprocessor/hash-if-hash-elif-hash-else-and-hash-endif-directives-c-cpp.md).  
 
 |Operator|Action|  
 |--------------|------------|  
@@ -22,6 +22,7 @@ Four preprocessor-specific operators are used in the context of the `#define` di
 |[defined operator](../preprocessor/hash-if-hash-elif-hash-else-and-hash-endif-directives-c-cpp.md)|Simplifies the writing of compound expressions in certain macro directives|  
 
 ## See Also  
- [Preprocessor Directives](../preprocessor/preprocessor-directives.md)   
- [Predefined Macros](../preprocessor/predefined-macros.md)   
- [C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)
+ 
+[Preprocessor Directives](../preprocessor/preprocessor-directives.md)   
+[Predefined Macros](../preprocessor/predefined-macros.md)   
+[C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)

docs/preprocessor/preprocessor.md

@@ -14,27 +14,29 @@ ms.workload: ["cplusplus"]
 # Preprocessor
 The preprocessor is a text processor that manipulates the text of a source file as part of the first phase of translation. The preprocessor does not parse the source text, but it does break it up into tokens for the purpose of locating macro calls. Although the compiler ordinarily invokes the preprocessor in its first pass, the preprocessor can also be invoked separately to process text without compiling.  
 
- The reference material on the preprocessor includes the following sections:  
+The reference material on the preprocessor includes the following sections:  
 
--   [Preprocessor directives](../preprocessor/preprocessor-directives.md)  
+- [Preprocessor directives](../preprocessor/preprocessor-directives.md)  
 
--   [Preprocessor operators](../preprocessor/preprocessor-operators.md)  
+- [Preprocessor operators](../preprocessor/preprocessor-operators.md)  
 
--   [Predefined macros](../preprocessor/predefined-macros.md)  
+- [Predefined macros](../preprocessor/predefined-macros.md)  
 
--   [Pragmas](../preprocessor/pragma-directives-and-the-pragma-keyword.md)  
+- [Pragmas](../preprocessor/pragma-directives-and-the-pragma-keyword.md)  
 
- **Microsoft Specific**  
+**Microsoft Specific**  
 
- You can obtain a listing of your source code after preprocessing by using the [/E](../build/reference/e-preprocess-to-stdout.md) or [/EP](../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md) compiler option. Both options invoke the preprocessor and output the resulting text to the standard output device, which, in most cases, is the console. The difference between the two options is that /E includes `#line` directives and /EP strips these directives out.  
+You can obtain a listing of your source code after preprocessing by using the [/E](../build/reference/e-preprocess-to-stdout.md) or [/EP](../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md) compiler option. Both options invoke the preprocessor and output the resulting text to the standard output device, which, in most cases, is the console. The difference between the two options is that /E includes `#line` directives and /EP strips these directives out.  
 
- **END Microsoft Specific**  
+**END Microsoft Specific**  
 
 ##  <a name="_predir_special_terminology"></a> Special Terminology  
- In the preprocessor documentation, the term "argument" refers to the entity that is passed to a function. In some cases, it is modified by "actual" or "formal," which describes the argument expression specified in the function call and the argument declaration specified in the function definition, respectively.  
+
+In the preprocessor documentation, the term "argument" refers to the entity that is passed to a function. In some cases, it is modified by "actual" or "formal," which describes the argument expression specified in the function call and the argument declaration specified in the function definition, respectively.  
 
- The term "variable" refers to a simple C-type data object. The term "object" refers to both C++ objects and variables; it is an inclusive term.  
+The term "variable" refers to a simple C-type data object. The term "object" refers to both C++ objects and variables; it is an inclusive term.  
 
 ## See Also  
- [C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)   
- [Phases of Translation](../preprocessor/phases-of-translation.md)
+ 
+[C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)   
+[Phases of Translation](../preprocessor/phases-of-translation.md)

docs/preprocessor/push-macro.md

@@ -18,17 +18,17 @@ Saves the value of the *macro_name* macro on the top of the stack for this macro
 ## Syntax  
 
 ```  
-  
 #pragma push_macro("  
 macro_name  
 ")  
-  
 ```  
 
 ## Remarks  
- You can retrieve the value for *macro_name* with **pop_macro**.  
+ 
+You can retrieve the value for *macro_name* with `pop_macro`.  
 
- See [pop_macro](../preprocessor/pop-macro.md) for a sample.  
+See [pop_macro](../preprocessor/pop-macro.md) for a sample.  
 
 ## See Also  
- [Pragma Directives and the __Pragma Keyword](../preprocessor/pragma-directives-and-the-pragma-keyword.md)
+ 
+[Pragma Directives and the __Pragma Keyword](../preprocessor/pragma-directives-and-the-pragma-keyword.md)