cpp formatting review pr21

mtx48109 · mtx48109 · commit 6809cac6dda6 · 2018-07-31T16:02:39.000-07:00
diff --git a/docs/cpp/overview-of-cpp-statements.md b/docs/cpp/overview-of-cpp-statements.md
@@ -17,7 +17,6 @@ C++ statements are executed sequentially, except when an expression statement, a
  Statements may be of the following types:  
   
 ```  
-  
 labeled-statement  
 expression-statement  
 compound-statement  
@@ -26,7 +25,6 @@ iteration-statement
 jump-statement  
 declaration-statement  
 try-throw-catch  
-  
 ```  
   
  In most cases, the C++ statement syntax is identical to that of ANSI C. The primary difference between the two is that in C, declarations are allowed only at the start of a block; C++ adds the *declaration-statement*, which effectively removes this restriction. This enables you to introduce variables at a point in the program where a precomputed initialization value can be calculated.  
@@ -44,5 +42,5 @@ try-throw-catch
 |[default](../cpp/switch-statement-cpp.md)|[__finally](../cpp/structured-exception-handling-c-cpp.md)|[switch](../cpp/switch-statement-cpp.md)||  
 |[do](../cpp/do-while-statement-cpp.md)|[if](../cpp/if-else-statement-cpp.md)|[throw](../cpp/try-throw-and-catch-statements-cpp.md)||  
   
-## See Also  
+## See also  
  [Statements](../cpp/statements-cpp.md)
diff --git a/docs/cpp/overview-of-declarators.md b/docs/cpp/overview-of-declarators.md
@@ -162,13 +162,11 @@ int a, *b, c[5], **d, &e=a;
   - pointer-operator declarator   
   - ( declarator )  
 
-  
 - and *pointer-operator* is one of:  
   
   - \* [cv-qualifiers]  
   - & [cv-qualifiers] ::nested-name-specifier \* [cv-qualifiers]  
 
-  
  Because a declarator may contain declarators, it is possible to construct the more complex derived types such as arrays of pointers, functions returning arrays of function pointers, by using the above rules.  To form each step of the construction, start with the identifier representing the base data type and apply the syntax rule above with the previous expression as the `declarator`.  The order that you apply the syntax rules should be the reverse of the way the expression is stated in English.  If applying the *pointer-operator* syntax rule to an array or function expression, use parentheses if you want a pointer to the array or function, as in the last row in the table below.  
   
  The following example shows the construction of "pointer to array of 10 pointers to int".  
diff --git a/docs/cpp/overview-of-file-translation.md b/docs/cpp/overview-of-file-translation.md
@@ -41,5 +41,5 @@ C++ programs, like C programs, consist of one or more files. Each of these files
   
 - The C preprocessor does not recognize the C++ operators: **.\***, **->\***, and `::`. See [Operators](../cpp/cpp-built-in-operators-precedence-and-associativity.md) and [Expressions](../cpp/expressions-cpp.md), for more information about operators.  
   
-## See Also  
+## See also  
  [Lexical Conventions](../cpp/lexical-conventions.md)
diff --git a/docs/cpp/overview-of-member-functions.md b/docs/cpp/overview-of-member-functions.md
@@ -68,5 +68,4 @@ int main()
 > [!NOTE]
 >  Although member functions can be defined either inside a class declaration or separately, no member functions can be added to a class after the class is defined.  
   
- Classes containing member functions can have many declarations, but the member functions themselves must have only one definition in a program. Multiple definitions cause an error message at link time. If a class contains inline function definitions, the function definitions must be identical to observe this "one definition" rule.  
-  
+ Classes containing member functions can have many declarations, but the member functions themselves must have only one definition in a program. Multiple definitions cause an error message at link time. If a class contains inline function definitions, the function definitions must be identical to observe this "one definition" rule.  
diff --git a/docs/cpp/parsing-cpp-command-line-arguments.md b/docs/cpp/parsing-cpp-command-line-arguments.md
@@ -66,5 +66,5 @@ int main( int argc,      // Number of strings in array argv
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [main: Program Startup](../cpp/main-program-startup.md)
diff --git a/docs/cpp/partial-ordering-of-function-templates-cpp.md b/docs/cpp/partial-ordering-of-function-templates-cpp.md
@@ -83,6 +83,5 @@ More specialized function called
 Even more specialized function for const T*  
 ```  
   
-## See Also
-
-[Function Templates](../cpp/function-templates.md)
+## See also
+ [Function Templates](../cpp/function-templates.md)
diff --git a/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md b/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md
@@ -31,7 +31,6 @@ class my_class {
 private:  
    class impl; unique_ptr<impl> pimpl; // opaque type here  
 };  
-  
 ```  
   
  The pimpl idiom avoids rebuild cascades and brittle object layouts. It's well suited for (transitively) popular types.  
@@ -54,7 +53,7 @@ my_class::my_class(): pimpl( new impl )
 ## Best practices  
  Consider whether to add support for non-throwing swap specialization.  
   
-## See Also  
+## See also  
  [Welcome Back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)   
  [C++ Language Reference](../cpp/cpp-language-reference.md)   
  [C++ Standard Library](../standard-library/cpp-standard-library-reference.md)
diff --git a/docs/cpp/point-of-declaration-in-cpp.md b/docs/cpp/point-of-declaration-in-cpp.md
@@ -28,5 +28,5 @@ int main()
   
  If the point of declaration were *after* the initialization, then the local `dVar` would be initialized to 7.0, the value of the global variable `dVar`. However, since that is not the case, `dVar` is initialized to an undefined value.  
   
-## See Also  
+## See also  
  [Scope](../cpp/scope-visual-cpp.md)
diff --git a/docs/cpp/pointer-to-member-operators-dot-star-and-star.md b/docs/cpp/pointer-to-member-operators-dot-star-and-star.md
@@ -124,6 +124,5 @@ int main() {
 > [!NOTE]
 >  If the result of one of the pointer-to-member operators is a function, then the result can be used only as an operand to the function call operator.  
   
-## See Also  
- [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)
-
+## See also  
+ [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)
diff --git a/docs/cpp/pointers-cpp.md b/docs/cpp/pointers-cpp.md
@@ -19,7 +19,7 @@ Pointers are declared using the following sequence.
 [ms-modifier] declarator ;  
 ```  
   
- where any valid pointer declarator may be used for `declarator`.  The syntax for a simple pointer declarator is as follows:  
+ where any valid pointer declarator may be used for `declarator`. The syntax for a simple pointer declarator is as follows:  
   
 ```  
 * [cv-qualifiers] identifier [= expression]  
@@ -236,8 +236,7 @@ int main() {
 ```  
   
 ```Output  
-  
-      a  
+a  
 45  
 d  
 a  
@@ -255,6 +254,6 @@ node 2 = 789
 a (add node)  d (display list)  q (quit)  
 ```  
   
-## See Also  
+## See also  
  [Indirection Operator: *](../cpp/indirection-operator-star.md)   
  [Address-of Operator: &](../cpp/address-of-operator-amp.md)
diff --git a/docs/cpp/pointers-to-members.md b/docs/cpp/pointers-to-members.md
@@ -65,7 +65,7 @@ int main()
 }  
 ```  
   
- In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type **char\***. The type of `pwCaption` is `char * Window::* `. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.  
+ In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type `char*`. The type of `pwCaption` is `char * Window::* `. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.  
   
 ```cpp 
 const char * (Window::*pfnwGC)() = &Window::GetCaption;  
@@ -89,7 +89,7 @@ strcpy_s( pwChildWindow->*pwCaption, cUntitledLen, szUntitled );
   
  The difference between the **.\*** and **->\*** operators (the pointer-to-member operators) is that the **.\*** operator selects members given an object or object reference, while the **->\*** operator selects members through a pointer. (For more about these operators, see [Expressions with Pointer-to-Member Operators](../cpp/pointer-to-member-operators-dot-star-and-star.md).)  
   
- The result of the pointer-to-member operators is the type of the member — in this case, **char \***.  
+ The result of the pointer-to-member operators is the type of the member — in this case, `char *`.  
   
  The following code fragment invokes the member functions `GetCaption` and `SetCaption` using pointers to members:  
   
@@ -159,7 +159,4 @@ int main()
   
 //Output: Print function for class Base  
 Print function for class Derived  
-```  
-  
-## See Also  
- 
+```  
diff --git a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md
@@ -30,7 +30,7 @@ extern "C" {        // functions using explicit "this"
 }  
 ```  
   
-## See Also  
+## See also  
  [Welcome Back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)   
  [C++ Language Reference](../cpp/cpp-language-reference.md)   
  [C++ Standard Library](../standard-library/cpp-standard-library-reference.md)
diff --git a/docs/cpp/postfix-expressions.md b/docs/cpp/postfix-expressions.md
@@ -22,13 +22,12 @@ Postfix expressions consist of primary expressions or expressions in which postf
 |[Function call operator](../cpp/function-call-operator-parens.md)|**( )**|  
 |[Explicit type conversion operator](../cpp/explicit-type-conversion-operator-parens.md)|*type-name* **( )**|  
 |[Member access operator](../cpp/member-access-operators-dot-and.md)|**.** or **->**|  
-|[Postfix increment operator](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md)|`++`|  
+|[Postfix increment operator](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md)|**++**|  
 |[Postfix decrement operator](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md)|**--**|  
   
  The following syntax describes possible postfix expressions:  
   
 ```  
-  
 primary-expression   
 postfix-expression[expression]postfix-expression(expression-list)simple-type-name(expression-list)postfix-expression.namepostfix-expression->namepostfix-expression++postfix-expression--cast-keyword < typename > (expression )typeid ( typename )  
 ```  
@@ -39,7 +38,7 @@ postfix-expression[expression]postfix-expression(expression-list)simple-type-nam
 func(1)->GetValue()++  
 ```  
   
- In the above expression, func is a primary expression, func(1) is a function postfix expression, func(1)->GetData is a postfix expression specifying a member of the class, func(1)->GetData() is another function postfix expression, and the entire expression is a postfix expression incrementing the return value of GetData.  The meaning of the expression as a whole is "call func passing 1 as an argument and get a pointer to a class as a return value.  Then call GetValue() on that class, then increment the value returned.  
+ In the above expression, `func` is a primary expression, `func(1)` is a function postfix expression, `func(1)->GetData` is a postfix expression specifying a member of the class, `func(1)->GetData()` is another function postfix expression, and the entire expression is a postfix expression incrementing the return value of GetData.  The meaning of the expression as a whole is "call func passing 1 as an argument and get a pointer to a class as a return value.  Then call `GetValue()` on that class, then increment the value returned.  
   
  The expressions listed above are assignment expressions, meaning that the result of these expressions must be an r-value.  
   
@@ -179,13 +178,13 @@ void print( const char *string, const char *terminator )
 }  
 ```  
   
- The preceding program declares a function, `print`, that takes two arguments. However, the second argument, `terminator`, has a default value, `"\n"`. In `main`, the first two calls to `print` allow the default second argument to supply a new line to terminate the printed string. The third call specifies an explicit value for the second argument. The output from the program is  
+ The preceding program declares a function, `print`, that takes two arguments. However, the second argument, *terminator*, has a default value, `"\n"`. In `main`, the first two calls to `print` allow the default second argument to supply a new line to terminate the printed string. The third call specifies an explicit value for the second argument. The output from the program is  
   
 ```Output 
 hello,  
 world!  
 good morning, sunshine.  
 ```  
   
-## See Also  
+## See also  
  [Types of Expressions](../cpp/types-of-expressions.md)
diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md
@@ -27,7 +27,7 @@ postfix-expression --
 i++;  
 ```  
   
- The effect of applying the postfix increment operator (`++`) is that the operand's value is increased by one unit of the appropriate type. Similarly, the effect of applying the postfix decrement operator (**--**) is that the operand's value is decreased by one unit of the appropriate type.  
+ The effect of applying the postfix increment operator (**++**) is that the operand's value is increased by one unit of the appropriate type. Similarly, the effect of applying the postfix decrement operator (**--**) is that the operand's value is decreased by one unit of the appropriate type.  
   
  It is important to note that a postfix increment or decrement expression evaluates to the value of the expression *prior to* application of the respective operator. The increment or decrement operation occurs *after* the operand is evaluated. This issue arises only when the postfix increment or decrement operation occurs in the context of a larger expression.  
   
@@ -62,7 +62,7 @@ Compass myCompass;
 for( myCompass = North; myCompass != West; myCompass++ ) // Error  
 ```  
   
-## See Also  
+## See also  
  [Postfix Expressions](../cpp/postfix-expressions.md)   
  [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)   
  [C Postfix Increment and Decrement Operators](../c-language/c-postfix-increment-and-decrement-operators.md)
diff --git a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md
@@ -21,11 +21,11 @@ ms.workload: ["cplusplus"]
 ```  
   
 ## Remarks  
- The prefix increment operator (`++`) adds one to its operand; this incremented value is the result of the expression. The operand must be an l-value not of type **const**. The result is an l-value of the same type as the operand.  
+ The prefix increment operator (**++**) adds one to its operand; this incremented value is the result of the expression. The operand must be an l-value not of type **const**. The result is an l-value of the same type as the operand.  
   
  The prefix decrement operator (**--**) is analogous to the prefix increment operator, except that the operand is decremented by one and the result is this decremented value.  
 
- **Visual Studio 2017 version 15.3 and later** (available with [/std:c++17](../build/reference/std-specify-language-standard-version.md)): The operand of an increment or decrement operator may not be of type `bool`.
+ **Visual Studio 2017 version 15.3 and later** (available with [/std:c++17](../build/reference/std-specify-language-standard-version.md)): The operand of an increment or decrement operator may not be of type **bool**.
   
  Both the prefix and postfix increment and decrement operators affect their operands. The key difference between them is the order in which the increment or decrement takes place in the evaluation of an expression. (For more information, see [Postfix Increment and Decrement Operators](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md).) In the prefix form, the increment or decrement takes place before the value is used in expression evaluation, so the value of the expression is different from the value of the operand. In the postfix form, the increment or decrement takes place after the value is used in expression evaluation, so the value of the expression is the same as the value of the operand. For example, the following program prints "`++i = 6`":  
   
@@ -68,7 +68,7 @@ k = ((++i)<(j))?(j):(++i);
 > [!NOTE]
 >  C++ inline functions are preferable to macros in many cases because they eliminate side effects such as those described here, and allow the language to perform more complete type checking.  
   
-## See Also  
+## See also  
  [Expressions with Unary Operators](../cpp/expressions-with-unary-operators.md)   
  [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)   
  [Prefix Increment and Decrement Operators](../c-language/prefix-increment-and-decrement-operators.md)
diff --git a/docs/cpp/primary-expressions.md b/docs/cpp/primary-expressions.md
@@ -15,7 +15,6 @@ ms.workload: ["cplusplus"]
 Primary expressions are the building blocks of more complex expressions. They are literals, names, and names qualified by the scope-resolution operator (`::`).  A primary expression may have any of the following forms:  
   
 ```  
-  
 literal  
 this
 name  
@@ -70,5 +69,5 @@ A::B   // a qualified name
 A<int> // a template id  
 ```  
   
-## See Also  
+## See also  
  [Types of Expressions](../cpp/types-of-expressions.md)
diff --git a/docs/cpp/private-cpp.md b/docs/cpp/private-cpp.md
@@ -77,6 +77,6 @@ int main() {
 }  
 ```  
   
-## See Also  
+## See also  
  [Controlling Access to Class Members](member-access-control-cpp.md)   
  [Keywords](../cpp/keywords-cpp.md)
diff --git a/docs/cpp/process.md b/docs/cpp/process.md
@@ -14,17 +14,16 @@ ms.workload: ["cplusplus"]
 ---
 # process
 
-Specifies that your managed application process should have a single copy of a particular global variable, static member variable, or static local variable shared across all application domains in the process. This was primarily intended to be used when compiling with **/clr:pure**, which is deprecated in Visual Studio 2017 and unsupported in Visual Studio 2017. When compiling with **/clr**, global and static variables are per-process by default and do not need to use `__declspec(process)`.
+Specifies that your managed application process should have a single copy of a particular global variable, static member variable, or static local variable shared across all application domains in the process. This was primarily intended to be used when compiling with **/clr:pure**, which is deprecated in Visual Studio 2017 and unsupported in Visual Studio 2017. When compiling with **/clr**, global and static variables are per-process by default and do not need to use **__declspec(process)**.
 
-Only a global variable, a static member variable, or a static local variable of native type can be marked with `__declspec(process)`.
+Only a global variable, a static member variable, or a static local variable of native type can be marked with **__declspec(process)**.
 
-`process` is only valid when compiling with [/clr](../build/reference/clr-common-language-runtime-compilation.md).
+**process** is only valid when compiling with [/clr](../build/reference/clr-common-language-runtime-compilation.md).
 
 If you want each application domain to have its own copy of a global variable, use [appdomain](../cpp/appdomain.md).
 
 See [Application Domains and Visual C++](../dotnet/application-domains-and-visual-cpp.md) for more information.
 
 ## See also
-
-- [__declspec](../cpp/declspec.md)
-- [Keywords](../cpp/keywords-cpp.md)
+ [__declspec](../cpp/declspec.md)  
+ [Keywords](../cpp/keywords-cpp.md)
diff --git a/docs/cpp/program-and-linkage-cpp.md b/docs/cpp/program-and-linkage-cpp.md
@@ -58,6 +58,5 @@ extern const int value = 42;
 
 See [extern](extern-cpp.md) for more information.
 
-## See Also
-
+## See also
  [Basic Concepts](../cpp/basic-concepts-cpp.md)
diff --git a/docs/cpp/program-termination.md b/docs/cpp/program-termination.md
@@ -20,5 +20,5 @@ In C++, there are several ways to exit a program:
   
 -   Execute a [return](../cpp/return-statement-in-program-termination-cpp.md) statement from `main`.  
   
-## See Also  
+## See also  
  [main: Program Startup](../cpp/main-program-startup.md)
diff --git a/docs/cpp/property-cpp.md b/docs/cpp/property-cpp.md
diff --git a/docs/cpp/protected-cpp.md b/docs/cpp/protected-cpp.md
diff --git a/docs/cpp/ptr32-ptr64.md b/docs/cpp/ptr32-ptr64.md
diff --git a/docs/cpp/public-cpp.md b/docs/cpp/public-cpp.md
diff --git a/docs/cpp/punctuators-cpp.md b/docs/cpp/punctuators-cpp.md
diff --git a/docs/cpp/raise.md b/docs/cpp/raise.md
diff --git a/docs/cpp/raising-software-exceptions.md b/docs/cpp/raising-software-exceptions.md
diff --git a/docs/cpp/range-based-for-statement-cpp.md b/docs/cpp/range-based-for-statement-cpp.md
diff --git a/docs/cpp/reference-type-function-arguments.md b/docs/cpp/reference-type-function-arguments.md
diff --git a/docs/cpp/reference-type-function-returns.md b/docs/cpp/reference-type-function-returns.md
