cpp formatting review pr15

mtx48109 · mtx48109 · commit f5ef732d9abb · 2018-07-31T13:11:53.000-07:00
diff --git a/docs/cpp/com-ptr-t-createinstance.md b/docs/cpp/com-ptr-t-createinstance.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 HRESULT CreateInstance(  
    const CLSID& rclsid,  
    IUnknown* pOuter=NULL,  
@@ -65,5 +64,5 @@ HRESULT CreateInstance(
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-detach.md b/docs/cpp/com-ptr-t-detach.md
@@ -20,15 +20,13 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 Interface* Detach( ) throw( );  
-  
 ```  
   
 ## Remarks  
  Extracts and returns the encapsulated interface pointer, and then clears the encapsulated pointer storage to NULL. This removes the interface pointer from encapsulation. It is up to you to call `Release` on the returned interface pointer.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-extractors.md b/docs/cpp/com-ptr-t-extractors.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 operator Interface*( ) const throw( );   
 operator Interface&( ) const;   
 Interface& operator*( ) const;   
@@ -45,5 +44,5 @@ operator bool( ) const throw( );
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-getactiveobject.md b/docs/cpp/com-ptr-t-getactiveobject.md
@@ -20,8 +20,7 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
-      HRESULT GetActiveObject(  
+HRESULT GetActiveObject(  
    const CLSID& rclsid   
 ) throw( );  
 HRESULT GetActiveObject(  
@@ -43,7 +42,7 @@ HRESULT GetActiveObject(
  A multibyte string, using the ANSI code page, that holds either a `CLSID` (starting with "**{**") or a `ProgID`.  
   
 ## Remarks  
- These member functions call `GetActiveObject` to retrieve a pointer to a running object that has been registered with OLE and then queries for this smart pointer's interface type. The resulting pointer is then encapsulated within this `_com_ptr_t` object. `Release` is called to decrement the reference count for the previously encapsulated pointer. This routine returns the HRESULT to indicate success or failure.  
+ These member functions call **GetActiveObject** to retrieve a pointer to a running object that has been registered with OLE and then queries for this smart pointer's interface type. The resulting pointer is then encapsulated within this `_com_ptr_t` object. `Release` is called to decrement the reference count for the previously encapsulated pointer. This routine returns the HRESULT to indicate success or failure.  
   
 -   **GetActiveObject(**  `rclsid`  **)** Attaches to an existing instance of an object given a `CLSID`.  
   
@@ -53,5 +52,5 @@ HRESULT GetActiveObject(
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-getinterfaceptr.md b/docs/cpp/com-ptr-t-getinterfaceptr.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 Interface* GetInterfacePtr( ) const throw( );   
 Interface*& GetInterfacePtr() throw();  
 ```  
@@ -30,5 +29,5 @@ Interface*& GetInterfacePtr() throw();
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-member-functions.md b/docs/cpp/com-ptr-t-member-functions.md
@@ -12,7 +12,7 @@ ms.author: "mblome"
 ms.workload: ["cplusplus"]
 ---
 # _com_ptr_t Member Functions
-For information about the `_com_ptr_t` member functions, see [_com_ptr_t Class](../cpp/com-ptr-t-class.md).  
+For information about the **_com_ptr_t** member functions, see [_com_ptr_t Class](../cpp/com-ptr-t-class.md).  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-operator-equal.md b/docs/cpp/com-ptr-t-operator-equal.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 template<typename _OtherIID>   
 _com_ptr_t& operator=( const _com_ptr_t<_OtherIID>& p );  
   
@@ -62,5 +61,5 @@ _com_ptr_t& operator=( const _variant_t& varSrc );
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-operators.md b/docs/cpp/com-ptr-t-operators.md
@@ -14,5 +14,5 @@ ms.workload: ["cplusplus"]
 # _com_ptr_t Operators
 For information about the `_com_ptr_t` operators, see [_com_ptr_t Class](../cpp/com-ptr-t-class.md).  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-queryinterface.md b/docs/cpp/com-ptr-t-queryinterface.md
@@ -15,12 +15,11 @@ ms.workload: ["cplusplus"]
 # _com_ptr_t::QueryInterface
 **Microsoft Specific**  
   
- Calls the `QueryInterface` member function of `IUnknown` on the encapsulated interface pointer.  
+ Calls the **QueryInterface** member function of `IUnknown` on the encapsulated interface pointer.  
   
 ## Syntax  
   
 ```  
-  
 template<typename _InterfaceType> HRESULT QueryInterface (  
    const IID& iid,  
    _InterfaceType*& p   
@@ -43,5 +42,5 @@ template<typename _InterfaceType> HRESULT QueryInterface (
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-relational-operators.md b/docs/cpp/com-ptr-t-relational-operators.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 template<typename _OtherIID>   
 bool operator==( const _com_ptr_t<_OtherIID>& p );  
   
@@ -94,5 +93,5 @@ bool operator>=( _InterfaceType* p );
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-ptr-t-release.md b/docs/cpp/com-ptr-t-release.md
@@ -15,20 +15,18 @@ ms.workload: ["cplusplus"]
 # _com_ptr_t::Release
 **Microsoft Specific**  
   
- Calls the `Release` member function of `IUnknown` on the encapsulated interface pointer.  
+ Calls the **Release** member function of `IUnknown` on the encapsulated interface pointer.  
   
 ## Syntax  
   
 ```  
-  
 void Release( );  
-  
 ```  
   
 ## Remarks  
- Calls `IUnknown::Release` on the encapsulated interface pointer, raising an E_POINTER error if this interface pointer is NULL.  
+ Calls `IUnknown::Release` on the encapsulated interface pointer, raising an `E_POINTER` error if this interface pointer is NULL.  
   
  **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [_com_ptr_t Class](../cpp/com-ptr-t-class.md)
diff --git a/docs/cpp/com-raise-error.md b/docs/cpp/com-raise-error.md
@@ -20,7 +20,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
 void __stdcall _com_raise_error(  
    HRESULT hr,  
    IErrorInfo* perrinfo = 0  
@@ -35,11 +34,11 @@ void __stdcall _com_raise_error(
  `IErrorInfo` object.  
   
 ## Remarks  
- `_com_raise_error`, which is defined in \<comdef.h>, can be replaced by a user-written version of the same name and prototype. This could be done if you want to use `#import` but do not want to use C++ exception handling. In that case, a user version of `_com_raise_error` might decide to do a `longjmp` or display a message box and halt. The user version should not return, though, because the compiler COM support code does not expect it to return.  
+ **_com_raise_error**, which is defined in \<comdef.h>, can be replaced by a user-written version of the same name and prototype. This could be done if you want to use `#import` but do not want to use C++ exception handling. In that case, a user version of **_com_raise_error** might decide to do a `longjmp` or display a message box and halt. The user version should not return, though, because the compiler COM support code does not expect it to return.  
   
  You can also use [_set_com_error_handler](../cpp/set-com-error-handler.md) to replace the default error-handling function.  
   
- By default, `_com_raise_error` is defined as follows:  
+ By default, **_com_raise_error** is defined as follows:  
   
 ```cpp  
 void __stdcall _com_raise_error(HRESULT hr, IErrorInfo* perrinfo) {  
@@ -54,6 +53,6 @@ void __stdcall _com_raise_error(HRESULT hr, IErrorInfo* perrinfo) {
   
  **Lib:** If the **wchar_t is Native Type** compiler option is on, use comsuppw.lib or comsuppwd.lib. If **wchar_t is Native Type** is off, use comsupp.lib. For more information, see [/Zc:wchar_t (wchar_t Is Native Type)](../build/reference/zc-wchar-t-wchar-t-is-native-type.md).  
   
-## See Also  
+## See also  
  [Compiler COM Global Functions](../cpp/compiler-com-global-functions.md)   
  [_set_com_error_handler](../cpp/set-com-error-handler.md)
diff --git a/docs/cpp/comma-operator.md b/docs/cpp/comma-operator.md
@@ -18,7 +18,6 @@ Allows grouping two statements where one is expected.
 ## Syntax  
   
 ```  
-  
 expression , expression  
 ```  
   
@@ -62,7 +61,7 @@ int main () {
 30  
 ```  
   
-## See Also  
+## See also  
  [Expressions with Binary Operators](../cpp/expressions-with-binary-operators.md)   
  [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)   
- [Sequential-Evaluation Operator](../c-language/sequential-evaluation-operator.md)
+ [Sequential-Evaluation Operator](../c-language/sequential-evaluation-operator.md)
diff --git a/docs/cpp/comments-cpp.md b/docs/cpp/comments-cpp.md
@@ -22,5 +22,5 @@ A comment is text that the compiler ignores but that is useful for programmers.
   
  The comment characters (`/*`, `*/`, and `//`) have no special meaning within a character constant, string literal, or comment. Comments using the first syntax, therefore, cannot be nested.  
   
-## See Also  
+## See also  
  [Lexical Conventions](../cpp/lexical-conventions.md)
diff --git a/docs/cpp/compiler-com-global-functions.md b/docs/cpp/compiler-com-global-functions.md
@@ -20,11 +20,11 @@ ms.workload: ["cplusplus"]
 |--------------|-----------------|  
 |[_com_raise_error](../cpp/com-raise-error.md)|Throws a [_com_error](../cpp/com-error-class.md) in response to a failure.|  
 |[_set_com_error_handler](../cpp/set-com-error-handler.md)|Replaces the default function that is used for COM error-handling.|  
-|[ConvertBSTRToString](../cpp/convertbstrtostring.md)|Converts a `BSTR` value to a **char \***.|  
-|[ConvertStringToBSTR](../cpp/convertstringtobstr.md)|Converts a **char \*** value to a `BSTR`.|  
+|[ConvertBSTRToString](../cpp/convertbstrtostring.md)|Converts a `BSTR` value to a `char *`.|  
+|[ConvertStringToBSTR](../cpp/convertstringtobstr.md)|Converts a `char *` value to a `BSTR`.|  
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Compiler COM Support Classes](../cpp/compiler-com-support-classes.md)   
  [Compiler COM Support](../cpp/compiler-com-support.md)
diff --git a/docs/cpp/compiler-com-support-classes.md b/docs/cpp/compiler-com-support-classes.md
@@ -26,7 +26,7 @@ ms.workload: ["cplusplus"]
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Compiler COM Support](../cpp/compiler-com-support.md)   
  [Compiler COM Global Functions](../cpp/compiler-com-global-functions.md)   
  [C++ Language Reference](../cpp/cpp-language-reference.md)
diff --git a/docs/cpp/compiler-com-support.md b/docs/cpp/compiler-com-support.md
@@ -17,7 +17,7 @@ ms.workload: ["cplusplus"]
   
  By using the [#import preprocessor directive](../preprocessor/hash-import-directive-cpp.md), the compiler can read a type library and convert it into a C++ header file that describes the COM interfaces as classes. A set of `#import` attributes is available for user control of the content for the resulting type library header files.  
   
- You can use the [__declspec](../cpp/declspec.md) extended attribute [uuid](../cpp/uuid-cpp.md) to assign a globally unique identifier (GUID) to a COM object. The keyword [__uuidof](../cpp/uuidof-operator.md) can be used to extract the GUID associated with a COM object. Another `__declspec` attribute, [property](../cpp/property-cpp.md), can be used to specify the **get** and **set** methods for a data member of a COM object.  
+ You can use the [__declspec](../cpp/declspec.md) extended attribute [uuid](../cpp/uuid-cpp.md) to assign a globally unique identifier (GUID) to a COM object. The keyword [__uuidof](../cpp/uuidof-operator.md) can be used to extract the GUID associated with a COM object. Another **__declspec** attribute, [property](../cpp/property-cpp.md), can be used to specify the `get` and `set` methods for a data member of a COM object.  
   
  A set of COM support global functions and classes is provided to support the `VARIANT` and `BSTR` types, implement smart pointers, and encapsulate the error object thrown by `_com_raise_error`:  
   
@@ -33,6 +33,6 @@ ms.workload: ["cplusplus"]
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Compiler COM Support Classes](../cpp/compiler-com-support-classes.md)   
  [Compiler COM Global Functions](../cpp/compiler-com-global-functions.md)
diff --git a/docs/cpp/compiler-limits.md b/docs/cpp/compiler-limits.md
@@ -32,5 +32,5 @@ The C++ standard recommends limits for various language constructs. The followin
   
 -   Template arguments in a template declaration - C++ standard: 1024, Visual C++ compiler: 2046.  
   
-## See Also  
+## See also  
  [Nonstandard Behavior](../cpp/nonstandard-behavior.md)
diff --git a/docs/cpp/compound-statements-blocks.md b/docs/cpp/compound-statements-blocks.md
@@ -18,7 +18,6 @@ A compound statement consists of zero or more statements enclosed in curly brace
 ## Syntax  
   
 ```  
-  
 { [ statement-list ] }  
 ```  
   
@@ -40,5 +39,5 @@ else
 > [!NOTE]
 >  Because a declaration is a statement, a declaration can be one of the statements in the *statement-list*. As a result, names declared inside a compound statement, but not explicitly declared as static, have local scope and (for objects) lifetime. See [Scope](../cpp/scope-visual-cpp.md) for details about treatment of names with local scope.  
   
-## See Also  
+## See also  
  [Overview of C++ Statements](../cpp/overview-of-cpp-statements.md)
diff --git a/docs/cpp/conditional-operator-q.md b/docs/cpp/conditional-operator-q.md
@@ -16,7 +16,6 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ``` 
-  
 expression ? expression : expression  
 ``` 
   
@@ -66,6 +65,6 @@ int main() {
 }  
 ```  
   
-## See Also  
+## See also  
  [C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)   
  [Conditional-Expression Operator](../c-language/conditional-expression-operator.md)
diff --git a/docs/cpp/considerations-for-writing-prolog-epilog-code.md b/docs/cpp/considerations-for-writing-prolog-epilog-code.md
@@ -13,7 +13,7 @@ ms.workload: ["cplusplus"]
 ---
 # Considerations for Writing Prolog/Epilog Code
 ## Microsoft Specific  
- Before writing your own prolog and epilog code sequences, it is important to understand how the stack frame is laid out. It is also useful to know how to use the __LOCAL_SIZE symbol.  
+ Before writing your own prolog and epilog code sequences, it is important to understand how the stack frame is laid out. It is also useful to know how to use the `__LOCAL_SIZE` symbol.  
   
 ##  <a name="_pluslang_c.2b2b_.stack_frame_layout"></a> Stack Frame Layout  
  This example shows the standard prolog code that might appear in a 32-bit function:  
@@ -37,16 +37,16 @@ ret                       ; Return from function
  The stack always grows down (from high to low memory addresses). The base pointer (`ebp`) points to the pushed value of `ebp`. The locals area begins at `ebp-4`. To access local variables, calculate an offset from `ebp` by subtracting the appropriate value from `ebp`.  
   
 ##  <a name="_pluslang___local_size"></a> __LOCAL_SIZE  
- The compiler provides a symbol, __LOCAL_SIZE, for use in the inline assembler block of function prolog code. This symbol is used to allocate space for local variables on the stack frame in custom prolog code.  
+ The compiler provides a symbol, `__LOCAL_SIZE`, for use in the inline assembler block of function prolog code. This symbol is used to allocate space for local variables on the stack frame in custom prolog code.  
   
- The compiler determines the value of __LOCAL_SIZE. Its value is the total number of bytes of all user-defined local variables and compiler-generated temporary variables. __LOCAL_SIZE can be used only as an immediate operand; it cannot be used in an expression. You must not change or redefine the value of this symbol. For example:  
+ The compiler determines the value of `__LOCAL_SIZE`. Its value is the total number of bytes of all user-defined local variables and compiler-generated temporary variables. `__LOCAL_SIZE` can be used only as an immediate operand; it cannot be used in an expression. You must not change or redefine the value of this symbol. For example:  
   
 ```  
 mov        eax, __LOCAL_SIZE           ;Immediate operand--Okay  
 mov        eax, [ebp - __LOCAL_SIZE]   ;Error  
 ```  
   
- The following example of a naked function containing custom prolog and epilog sequences uses the __LOCAL_SIZE symbol in the prolog sequence:  
+ The following example of a naked function containing custom prolog and epilog sequences uses the `__LOCAL_SIZE` symbol in the prolog sequence:  
   
 ```  
 // the__local_size_symbol.cpp  
@@ -72,5 +72,5 @@ __declspec ( naked ) int main() {
   
 **END Microsoft Specific**  
   
-## See Also  
+## See also  
  [Naked Function Calls](../cpp/naked-function-calls.md)
diff --git a/docs/cpp/const-and-volatile-pointers.md b/docs/cpp/const-and-volatile-pointers.md
@@ -57,7 +57,7 @@ char *pch2 = &cch;   // Error
 char *const pch3 = &cch;   // Error  
 ```  
   
- The declaration of `pch2` declares a pointer through which a constant object might be modified and is therefore disallowed. The declaration of `pch3` specifies that the **pointer** is constant, not the object; the declaration is disallowed for the same reason the `pch2` declaration is disallowed.  
+ The declaration of `pch2` declares a pointer through which a constant object might be modified and is therefore disallowed. The declaration of `pch3` specifies that the pointer is constant, not the object; the declaration is disallowed for the same reason the `pch2` declaration is disallowed.  
   
  The following eight assignments show assigning through pointer and changing of pointer value for the preceding declarations; for now, assume that the initialization was correct for `pch1` through `pch8`.  
   
@@ -83,7 +83,7 @@ errno_t strcpy_s( char *strDestination, size_t numberOfElements, const char *str
  The preceding statement declares a function, [strcpy_s](../c-runtime-library/reference/strcpy-s-wcscpy-s-mbscpy-s.md), where two of the three arguments are of type pointer to **char**. Because the arguments are passed by reference and not by value, the function would be free to modify both `strDestination` and `strSource` if `strSource` were not declared as **const**. The declaration of `strSource` as **const** assures the caller that `strSource` cannot be changed by the called function.  
   
 > [!NOTE]
->  Because there is a standard conversion from *typename* **\*** to **const** *typename* **\***, it is legal to pass an argument of type **char \*** to [strcpy_s](../c-runtime-library/reference/strcpy-s-wcscpy-s-mbscpy-s.md). However, the reverse is not true; no implicit conversion exists to remove the **const** attribute from an object or pointer.  
+>  Because there is a standard conversion from *typename* **\*** to **const** *typename* **\***, it is legal to pass an argument of type `char *` to [strcpy_s](../c-runtime-library/reference/strcpy-s-wcscpy-s-mbscpy-s.md). However, the reverse is not true; no implicit conversion exists to remove the **const** attribute from an object or pointer.  
   
  A **const** pointer of a given type can be assigned to a pointer of the same type. However, a pointer that is not **const** cannot be assigned to a **const** pointer. The following code shows correct and incorrect assignments:  
   
@@ -120,5 +120,5 @@ int main() {
 }  
 ```  
   
-## See Also  
+## See also  
  [Pointers](../cpp/pointers-cpp.md)
diff --git a/docs/cpp/const-cast-operator.md b/docs/cpp/const-cast-operator.md
diff --git a/docs/cpp/const-cpp.md b/docs/cpp/const-cpp.md
diff --git a/docs/cpp/constexpr-cpp.md b/docs/cpp/constexpr-cpp.md
diff --git a/docs/cpp/constructors-cpp.md b/docs/cpp/constructors-cpp.md
diff --git a/docs/cpp/containers-modern-cpp.md b/docs/cpp/containers-modern-cpp.md
diff --git a/docs/cpp/continue-statement-cpp.md b/docs/cpp/continue-statement-cpp.md
diff --git a/docs/cpp/convertbstrtostring.md b/docs/cpp/convertbstrtostring.md
diff --git a/docs/cpp/convertstringtobstr.md b/docs/cpp/convertstringtobstr.md
