cpp formatting review pr13

mtx48109 · mtx48109 · commit 3de675435fcc · 2018-07-31T11:59:55.000-07:00
diff --git a/docs/cpp/based-grammar.md b/docs/cpp/based-grammar.md
@@ -35,5 +35,5 @@ ms.workload: ["cplusplus"]
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Based Pointers](../cpp/based-pointers-cpp.md)
diff --git a/docs/cpp/based-pointers-cpp.md b/docs/cpp/based-pointers-cpp.md
@@ -84,6 +84,6 @@ int main() {
 11  
 ```  
   
-## See Also  
+## See also  
  [Keywords](../cpp/keywords-cpp.md)   
  [alloc_text](../preprocessor/alloc-text.md)
diff --git a/docs/cpp/basic-concepts-cpp.md b/docs/cpp/basic-concepts-cpp.md
@@ -32,5 +32,5 @@ This section explains concepts that are critical to understanding C++. C program
   
 -   [Trivial, standard-layout and POD types](../cpp/trivial-standard-layout-and-pod-types.md)  
   
-## See Also  
+## See also  
  [C++ Language Reference](../cpp/cpp-language-reference.md)
diff --git a/docs/cpp/binary-operators.md b/docs/cpp/binary-operators.md
@@ -68,5 +68,4 @@ where *ret-type* and *op* are as described for member operator functions and *ar
 > There is no restriction on the return types of the binary operators; however, most user-defined binary operators return either a class type or a reference to a class type.
 
 ## See also
-
-- [Operator Overloading](../cpp/operator-overloading.md)
+ [Operator Overloading](../cpp/operator-overloading.md)
diff --git a/docs/cpp/bitwise-and-operator-amp.md b/docs/cpp/bitwise-and-operator-amp.md
@@ -17,9 +17,7 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```
-
 expression & expression  
-
 ```
   
 ## Remarks  
@@ -48,7 +46,7 @@ int main() {
 }  
 ```  
   
-## See Also  
+## See also  
  [C++ Built-in Operators, Precedence and Associativity](cpp-built-in-operators-precedence-and-associativity.md)  
  [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)   
  [C Bitwise Operators](../c-language/c-bitwise-operators.md)
diff --git a/docs/cpp/bitwise-exclusive-or-operator-hat.md b/docs/cpp/bitwise-exclusive-or-operator-hat.md
@@ -42,7 +42,5 @@ int main() {
 }  
 ```  
   
-## 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/bitwise-inclusive-or-operator-pipe.md b/docs/cpp/bitwise-inclusive-or-operator-pipe.md
@@ -46,6 +46,5 @@ int main() {
 ```
 
 ## See also
-
-- [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)
-- [C Bitwise Operators](../c-language/c-bitwise-operators.md)
+ [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)  
+ [C Bitwise Operators](../c-language/c-bitwise-operators.md)  
diff --git a/docs/cpp/bool-cpp.md b/docs/cpp/bool-cpp.md
@@ -48,6 +48,5 @@ The postfix or prefix **--** operator cannot be applied to a variable of this ty
  The **bool** type participates in integral promotions. An r-value of type **bool** can be converted to an r-value of type **int**, with FALSE becoming zero and TRUE becoming one. As a distinct type, **bool** participates in overload resolution.  
   
 ## See also
-
-[Keywords](../cpp/keywords-cpp.md)<br/>
-[Fundamental Types](../cpp/fundamental-types-cpp.md)<br/>
+[Keywords](../cpp/keywords-cpp.md)  
+[Fundamental Types](../cpp/fundamental-types-cpp.md)  
diff --git a/docs/cpp/break-statement-cpp.md b/docs/cpp/break-statement-cpp.md
@@ -147,7 +147,7 @@ int main() {
 }  
 ```  
   
-## See Also  
+## See also  
  [Jump Statements](../cpp/jump-statements-cpp.md)   
  [Keywords](../cpp/keywords-cpp.md)   
  [continue Statement](../cpp/continue-statement-cpp.md)
diff --git a/docs/cpp/bstr-t-assign.md b/docs/cpp/bstr-t-assign.md
@@ -30,7 +30,7 @@ void Assign(
  A `BSTR` to be copied into the `BSTR` wrapped by a `_bstr_t`.  
   
 ## Remarks  
- `Assign` does a binary copy, which means the entire length of the `BSTR` is copied, regardless of content.  
+ **Assign** does a binary copy, which means the entire length of the `BSTR` is copied, regardless of content.  
   
 ## Example  
   
@@ -107,5 +107,5 @@ bstrWrapper2 = some text
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-attach.md b/docs/cpp/bstr-t-attach.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 void Attach(  
    BSTR s  
 );  
@@ -38,5 +37,5 @@ void Attach(
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-bstr-t.md b/docs/cpp/bstr-t-bstr-t.md
@@ -68,10 +68,10 @@ _bstr_t(
 |`_bstr_t( char*`  `s2`  `)`|Constructs a `_bstr_t` object by calling `SysAllocString` to create a new `BSTR` object and then encapsulates it.<br /><br /> This constructor first performs a multibyte to Unicode conversion.|  
 |`_bstr_t( wchar_t*`  `s3`  `)`|Constructs a `_bstr_t` object by calling `SysAllocString` to create a new `BSTR` object and then encapsulates it.|  
 |`_bstr_t( _variant_t&`  `var`  `)`|Constructs a `_bstr_t` object from a `_variant_t` object by first retrieving a `BSTR` object from the encapsulated VARIANT object.|  
-|`_bstr_t( BSTR`  `bstr` `, bool`  `fCopy`  `)`|Constructs a `_bstr_t` object from an existing `BSTR` (as opposed to a `wchar_t*` string). If `fCopy` is false, the supplied `BSTR` is attached to the new object without making a new copy with `SysAllocString`.<br /><br /> This constructor is used by wrapper functions in the type library headers to encapsulate and take ownership of a `BSTR` that is returned by an interface method.|  
+|`_bstr_t( BSTR`  `bstr` `, bool`  `fCopy`  `)`|Constructs a `_bstr_t` object from an existing `BSTR` (as opposed to a `wchar_t*` string). If *fCopy* is false, the supplied `BSTR` is attached to the new object without making a new copy with `SysAllocString`.<br /><br /> This constructor is used by wrapper functions in the type library headers to encapsulate and take ownership of a `BSTR` that is returned by an interface method.|  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)   
  [_variant_t Class](../cpp/variant-t-class.md)
diff --git a/docs/cpp/bstr-t-class.md b/docs/cpp/bstr-t-class.md
@@ -15,7 +15,7 @@ ms.workload: ["cplusplus"]
 # _bstr_t Class
 **Microsoft Specific**  
   
- A `_bstr_t` object encapsulates the [BSTR data type](http://msdn.microsoft.com/1b2d7d2c-47af-4389-a6b6-b01b7e915228). The class manages resource allocation and deallocation through function calls to `SysAllocString` and `SysFreeString` and other `BSTR` APIs when appropriate. The `_bstr_t` class uses reference counting to avoid excessive overhead.  
+ A `_bstr_t` object encapsulates the [BSTR data type](http://msdn.microsoft.com/1b2d7d2c-47af-4389-a6b6-b01b7e915228). The class manages resource allocation and deallocation through function calls to `SysAllocString` and `SysFreeString` and other `BSTR` APIs when appropriate. The **_bstr_t** class uses reference counting to avoid excessive overhead.  
   
 ### Construction  
   
@@ -53,5 +53,5 @@ ms.workload: ["cplusplus"]
   
  **Lib:** comsuppw.lib or comsuppwd.lib (see [/Zc:wchar_t (wchar_t Is Native Type)](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) for more information)  
   
-## See Also  
+## See also  
  [Compiler COM Support Classes](../cpp/compiler-com-support-classes.md)
diff --git a/docs/cpp/bstr-t-copy.md b/docs/cpp/bstr-t-copy.md
@@ -20,13 +20,12 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 BSTR copy( bool fCopy = true ) const;  
 ```  
   
 #### Parameters  
  *fCopy*  
- If TRUE, `copy` returns a copy of the contained `BSTR`, otherwise `copy` returns the actual BSTR.  
+ If TRUE, **copy** returns a copy of the contained `BSTR`, otherwise **copy** returns the actual BSTR.  
   
 ## Remarks  
  Returns a newly allocated copy of the encapsulated `BSTR` object.  
@@ -41,5 +40,5 @@ STDMETHODIMP CAlertMsg::get_ConnectionStr(BSTR *pVal){ //  m_bsConStr is _bstr_t
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-detach.md b/docs/cpp/bstr-t-detach.md
@@ -20,18 +20,16 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 BSTR Detach( ) throw;  
-  
 ```  
   
 ## Return Value  
  The `BSTR` wrapped by the `_bstr_t`.  
   
 ## Example  
- See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for a example using `Detach`.  
+ See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for a example using **Detach**.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-getaddress.md b/docs/cpp/bstr-t-getaddress.md
@@ -20,21 +20,19 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 BSTR* GetAddress( );  
-  
 ```  
   
 ## Return Value  
  A pointer to the `BSTR` wrapped by the `_bstr_t`.  
   
 ## Remarks  
- `GetAddress` affects all `_bstr_t` objects that share a `BSTR`. More than one `_bstr_t` can share a `BSTR` through the use of the copy constructor and and **operator=**.  
+ **GetAddress** affects all `_bstr_t` objects that share a `BSTR`. More than one `_bstr_t` can share a `BSTR` through the use of the copy constructor and and **operator=**.  
   
 ## Example  
- See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for a example using `GetAddress`.  
+ See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for a example using **GetAddress**.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-getbstr.md b/docs/cpp/bstr-t-getbstr.md
@@ -20,21 +20,19 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 BSTR& GetBSTR( );  
-  
 ```  
   
 ## Return Value  
  The beginning of the `BSTR` wrapped by the `_bstr_t`.  
   
 ## Remarks  
- `GetBSTR` affects all `_bstr_t` objects that share a `BSTR`. More than one `_bstr_t` can share a `BSTR` through the use of the copy constructor and and **operator=**.  
+ **GetBSTR** affects all `_bstr_t` objects that share a `BSTR`. More than one `_bstr_t` can share a `BSTR` through the use of the copy constructor and and **operator=**.  
   
 ## Example  
- See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for an example using `GetBSTR`.  
+ See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for an example using **GetBSTR**.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-length.md b/docs/cpp/bstr-t-length.md
@@ -20,13 +20,11 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 unsigned int length ( ) const throw( );  
-  
 ```  
   
 ## Remarks  
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-member-functions.md b/docs/cpp/bstr-t-member-functions.md
@@ -14,5 +14,5 @@ ms.workload: ["cplusplus"]
 # _bstr_t Member Functions
 For information about `_bstr_t` member functions, see [_bstr_t Class](../cpp/bstr-t-class.md).  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-operator-add-equal-plus.md b/docs/cpp/bstr-t-operator-add-equal-plus.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 _bstr_t& operator+=( const _bstr_t& s1 );  
 _bstr_t operator+( const _bstr_t& s1 );  
 friend _bstr_t operator+( const char* s2, const _bstr_t& s1);  
@@ -50,5 +49,5 @@ friend _bstr_t operator+( const wchar_t* s3, const _bstr_t& s1);
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-operator-equal.md b/docs/cpp/bstr-t-operator-equal.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 _bstr_t& operator=(const _bstr_t& s1) throw ( );  
 _bstr_t& operator=(const char* s2);  
 _bstr_t& operator=(const wchar_t* s3);  
@@ -45,5 +44,5 @@ _bstr_t& operator=(const _variant_t& var);
 ## Example  
  See [_bstr_t::Assign](../cpp/bstr-t-assign.md) for an example of using **operator=**.  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-operator-logical-not.md b/docs/cpp/bstr-t-operator-logical-not.md
@@ -20,15 +20,13 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 bool operator!( ) const throw( );  
-  
 ```  
   
 ## Return Value  
  It returns TRUE if yes, FALSE if not.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-operators.md b/docs/cpp/bstr-t-operators.md
@@ -14,5 +14,5 @@ ms.workload: ["cplusplus"]
 # _bstr_t Operators
 For information about the `_bstr_t` operators, see [_bstr_t Class](../cpp/bstr-t-class.md).  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-relational-operators.md b/docs/cpp/bstr-t-relational-operators.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 bool operator!( ) const throw( );   
 bool operator==(const _bstr_t& str) const throw( );  
 bool operator!=(const _bstr_t& str) const throw( );  
@@ -35,5 +34,5 @@ bool operator>=(const _bstr_t& str) const throw( );
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/bstr-t-wchar-t-star-bstr-t-char-star.md b/docs/cpp/bstr-t-wchar-t-star-bstr-t-char-star.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 operator const wchar_t*( ) const throw( );   
 operator wchar_t*( ) const throw( );   
 operator const char*( ) const;   
@@ -32,5 +31,5 @@ operator char*( ) const;
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_bstr_t Class](../cpp/bstr-t-class.md)
diff --git a/docs/cpp/calling-conventions.md b/docs/cpp/calling-conventions.md
@@ -30,5 +30,5 @@ The Visual C/C++ compiler provides several different conventions for calling int
   
 -   [Obsolete calling conventions](../cpp/obsolete-calling-conventions.md)  
   
-## See Also  
+## See also  
  [Microsoft-Specific Modifiers](../cpp/microsoft-specific-modifiers.md)
diff --git a/docs/cpp/calling-example-function-prototype-and-call.md b/docs/cpp/calling-example-function-prototype-and-call.md
@@ -38,5 +38,5 @@ MyFunc ('x', 12, 8192, 2.7183);
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Calling Conventions](../cpp/calling-conventions.md)
diff --git a/docs/cpp/cast-operator-parens.md b/docs/cpp/cast-operator-parens.md
diff --git a/docs/cpp/casting-operators.md b/docs/cpp/casting-operators.md
diff --git a/docs/cpp/casting.md b/docs/cpp/casting.md

Original file line number	Diff line number	Diff line change
`@@ -84,6 +84,6 @@ int main() {`
`84`	`84`	`11`
`85`	`85`	```
`86`	`86`
`87`		`-## See Also`
	`87`	`+## See also`
`88`	`88`	`[Keywords](../cpp/keywords-cpp.md)`
`89`	`89`	`[alloc_text](../preprocessor/alloc-text.md)`
Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,5 @@ int main() {`
`42`	`42`	`}`
`43`	`43`	```
`44`	`44`
`45`		`-## See Also`
`46`		`- [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)`
`47`		`-`
`48`		`-`
	`45`	`+## See also`
	`46`	`+ [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)`
Original file line number	Diff line number	Diff line change
`@@ -147,7 +147,7 @@ int main() {`
`147`	`147`	`}`
`148`	`148`	```
`149`	`149`
`150`		`-## See Also`
	`150`	`+## See also`
`151`	`151`	`[Jump Statements](../cpp/jump-statements-cpp.md)`
`152`	`152`	`[Keywords](../cpp/keywords-cpp.md)`
`153`	`153`	`[continue Statement](../cpp/continue-statement-cpp.md)`