windows formatting review pr33

mtx48109 · mtx48109 · commit eb126fdfd642 · 2018-08-08T09:21:40.000-07:00
diff --git a/docs/windows/immediatebind.md b/docs/windows/immediatebind.md
@@ -17,7 +17,7 @@ Indicates that the database will be notified immediately of all changes to a pro
   
 ## Syntax  
   
-```  
+```cpp  
 [immediatebind]  
 ```  
   
diff --git a/docs/windows/implements-cancastto-method.md b/docs/windows/implements-cancastto-method.md
@@ -17,7 +17,7 @@ Gets a pointer to the specified interface.
   
 ## Syntax  
   
-```  
+```cpp  
 __forceinline HRESULT CanCastTo(  
    REFIID riid,  
    _Deref_out_ void **ppv  
diff --git a/docs/windows/implements-casttounknown-method.md b/docs/windows/implements-casttounknown-method.md
@@ -17,7 +17,7 @@ Gets a pointer to the underlying `IUnknown` interface.
   
 ## Syntax  
   
-```  
+```cpp  
 __forceinline IUnknown* CastToUnknown();  
 ```  
   
diff --git a/docs/windows/implements-category.md b/docs/windows/implements-category.md
@@ -17,7 +17,7 @@ Specifies the component categories implemented by the target class.
   
 ## Syntax  
   
-```  
+```cpp  
 [ implements_category(  
    implements_category="uuid"  
 ) ]  
@@ -33,7 +33,7 @@ Specifies the component categories implemented by the target class.
  This attribute requires that the [coclass](../windows/coclass.md), [progid](../windows/progid.md), or [vi_progid](../windows/vi-progid.md) attribute (or another attribute that implies one of these) also be applied to the same element. If any single attribute is used, the other two are automatically applied. For example, if `progid` is applied, `vi_progid` and `coclass` are also applied.  
   
 ## Example  
- The following code specifies that the following object implements the Control category.  
+ The following code specifies that the following object implements the `Control` category.  
   
 ```cpp  
 // cpp_attr_ref_implements_category.cpp  
diff --git a/docs/windows/implements-cpp.md b/docs/windows/implements-cpp.md
@@ -17,7 +17,7 @@ Specifies dispatch interfaces that are forced to be members of the IDL coclass.
   
 ## Syntax  
   
-```  
+```cpp  
 [ implements(   
    interfaces={interfaces},  
    dispinterfaces={dispinterfaces}  
@@ -32,7 +32,7 @@ Specifies dispatch interfaces that are forced to be members of the IDL coclass.
  A comma separated list of the dispinterface that will be a member of the IDL coclass. A shorthand method for specifying a single dispinterface is **implements(dispinterfaces** *= dispinterface_name***)**.  
   
 ## Remarks  
- By default, only COM-interfaces that are base classes of the coclass are added in the IDL coclass. **implements** lets you force other interfaces to be IDL coclass members.  
+ By default, only COM-interfaces that are base classes of the `coclass` are added in the IDL coclass. **implements** lets you force other interfaces to be IDL `coclass` members.  
   
 ## Requirements  
   
diff --git a/docs/windows/implements-fillarraywithiid-method.md b/docs/windows/implements-fillarraywithiid-method.md
@@ -17,7 +17,7 @@ Inserts the interface ID specified by the current zeroth template parameter into
   
 ## Syntax  
   
-```  
+```cpp  
 __forceinline static void FillArrayWithIid(  
    unsigned long &index,  
    _In_ IID* iids  
diff --git a/docs/windows/implements-iidcount-constant.md b/docs/windows/implements-iidcount-constant.md
@@ -16,7 +16,7 @@ Holds the number of implemented interface IDs.
   
 ## Syntax  
   
-```  
+```cpp  
 static const unsigned long IidCount;  
 ```  
   
diff --git a/docs/windows/implements-structure.md b/docs/windows/implements-structure.md
@@ -17,7 +17,7 @@ Implements `QueryInterface` and `GetIid` for the specified interfaces.
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename I0,  
    typename I1 = Details::Nil,  
diff --git a/docs/windows/implementsbase-structure.md b/docs/windows/implementsbase-structure.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 struct ImplementsBase;  
 ```  
   
diff --git a/docs/windows/implementshelper-cancastto-method.md b/docs/windows/implementshelper-cancastto-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 HRESULT CanCastTo(  
    REFIID riid,  
    _Deref_out_ void **ppv  
diff --git a/docs/windows/implementshelper-casttounknown-method.md b/docs/windows/implementshelper-casttounknown-method.md
@@ -17,12 +17,12 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 IUnknown* CastToUnknown();  
 ```  
   
 ## Return Value  
- Pointer to the underlying IUnknown interface.  
+ Pointer to the underlying `IUnknown` interface.  
   
 ## Remarks  
  Gets a pointer to the underlying `IUnknown` interface for the current `Implements` structure.  
diff --git a/docs/windows/implementshelper-fillarraywithiid-method.md b/docs/windows/implementshelper-fillarraywithiid-method.md
@@ -17,13 +17,13 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 void FillArrayWithIid(  
    _Inout_ unsigned long *index,   
    _Inout_ IID* iids) throw();  
 ```  
   
-#### Parameters  
+### Parameters  
  *index*  
  A zero-based index that indicates the starting array element for this operation. When this operation completes, *index* is incremented by 1.  
   
diff --git a/docs/windows/implementshelper-iidcount-constant.md b/docs/windows/implementshelper-iidcount-constant.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 static const unsigned long IidCount;  
 ```  
   
diff --git a/docs/windows/implementshelper-structure.md b/docs/windows/implementshelper-structure.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename RuntimeClassFlagsT,  
    typename ILst,  
@@ -39,7 +39,7 @@ friend struct Details::ImplementsHelper;
 ## Remarks  
  Helps implement the [Implements](../windows/implements-structure.md) structure.  
   
- This template traverses a list of interfaces and adds them as base classes, and as information necessary to enable QueryInterface.  
+ This template traverses a list of interfaces and adds them as base classes, and as information necessary to enable `QueryInterface`.  
   
 ## Members  
   
diff --git a/docs/windows/import.md b/docs/windows/import.md
@@ -17,7 +17,7 @@ Specifies another .idl, .odl, or header file containing definitions you want to
   
 ## Syntax  
   
-```  
+```cpp  
 [ import(  
    idl_file  
 ) ];  
diff --git a/docs/windows/importidl.md b/docs/windows/importidl.md
@@ -17,7 +17,7 @@ Inserts the specified .idl file into the generated .idl file.
   
 ## Syntax  
   
-```  
+```cpp  
 [ importidl(  
    idl_file  
 ) ];  
diff --git a/docs/windows/importlib.md b/docs/windows/importlib.md
@@ -17,7 +17,7 @@ Makes types that have already been compiled into another type library available
   
 ## Syntax  
   
-```  
+```cpp  
 [ importlib(  
    "tlb_file"  
 ) ];  
diff --git a/docs/windows/in-cpp.md b/docs/windows/in-cpp.md
@@ -17,7 +17,7 @@ Indicates that a parameter is to be passed from the calling procedure to the cal
   
 ## Syntax  
   
-```  
+```cpp  
 [in]  
 ```  
   
diff --git a/docs/windows/include-cpp.md b/docs/windows/include-cpp.md
@@ -17,7 +17,7 @@ Specifies one or more header files to be included in the generated .idl file.
   
 ## Syntax  
   
-```  
+```cpp  
 [ include(  
    header_file  
 ) ];  
@@ -33,7 +33,7 @@ Specifies one or more header files to be included in the generated .idl file.
  The **include** C++ attribute has the same functionality as the [include](http://msdn.microsoft.com/library/windows/desktop/aa367052) MIDL attribute.  
   
 ## Example  
- The following code shows an example of how to use **include**. For this example, the file include.h contains only a #include statement.  
+ The following code shows an example of how to use **include**. For this example, the file include.h contains only a `#include` statement.  
   
 ```cpp  
 // cpp_attr_ref_include.cpp  
diff --git a/docs/windows/includelib-cpp.md b/docs/windows/includelib-cpp.md
@@ -17,7 +17,7 @@ Causes an .idl or .h file to be included in the generated .idl file.
   
 ## Syntax  
   
-```  
+```cpp  
 [ includelib(  
    name.idl  
 ) ];  
diff --git a/docs/windows/including-shared-read-only-or-calculated-symbols.md b/docs/windows/including-shared-read-only-or-calculated-symbols.md
@@ -19,7 +19,7 @@ The first time the development environment reads a resource file created by anot
   
  You can also use included symbol files when you have existing resources with symbol definitions that use expressions rather than simple integers to define the symbol value. For example:  
   
-```  
+```cpp  
 #define   IDC_CONTROL1 2100  
 #define   IDC_CONTROL2 (IDC_CONTROL1+1)  
 ```  
@@ -42,9 +42,9 @@ The first time the development environment reads a resource file created by anot
     > [!NOTE]
     >  If your project doesn't already contain an .rc file, please see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md).  
   
-2.  In the **Read-only symbol directives** box, use the **#include** compiler directive to specify the file where you want the read-only symbols to be kept.  
+2.  In the **Read-only symbol directives** box, use the `#include` compiler directive to specify the file where you want the read-only symbols to be kept.  
   
-     Do not call the file Resource.h, since that is the filename normally used by the main symbol header file.  
+     Do not call the file `Resource.h`, since that is the filename normally used by the main symbol header file.  
   
     > [!NOTE]
     >  **Important** What you type in the Read-Only symbol directives box is included in the resource file exactly as you type it. Make sure what you type does not contain any spelling or syntax errors.  
@@ -58,7 +58,6 @@ The first time the development environment reads a resource file created by anot
 4.  Click **OK**.  
   
 ## Requirements  
-  
  Win32  
   
 ## See Also  
diff --git a/docs/windows/insert-activex-control-dialog-box.md b/docs/windows/insert-activex-control-dialog-box.md
@@ -15,13 +15,13 @@ ms.workload: ["cplusplus", "uwp"]
 # Insert ActiveX Control Dialog Box
 This dialog box enables you to [insert ActiveX controls into your dialog box](../windows/viewing-and-adding-activex-controls-to-a-dialog-box.md) while using the [Dialog editor](../windows/dialog-editor.md).  
   
- **ActiveX Control**  
+### ActiveX Control 
  Displays a list of Active X controls. Inserting a control from this dialog box does not generate a wrapper class. If you need a wrapper class, use [Class View](http://msdn.microsoft.com/8d7430a9-3e33-454c-a9e1-a85e3d2db925) to create one (for more information, see [Adding a Class](../ide/adding-a-class-visual-cpp.md)). If an Active X control does not appear in this dialog box, try installing the control according to the vendor's instructions.  
   
- **Path**  
+### Path  
  Displays the file in which the ActiveX control is found.  
   
- You can place controls in the Toolbox window for easy access. For more information, see [Customize Toolbox dialog box](http://msdn.microsoft.com/bd07835f-18a8-433e-bccc-7141f65263bb).  
+ You can place controls in the **Toolbox** window for easy access. For more information, see [Customize Toolbox dialog box](http://msdn.microsoft.com/bd07835f-18a8-433e-bccc-7141f65263bb).  
   
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).  
   
diff --git a/docs/windows/inserting-a-new-menu-between-existing-menus.md b/docs/windows/inserting-a-new-menu-between-existing-menus.md
@@ -14,7 +14,7 @@ ms.workload: ["cplusplus", "uwp"]
 # Inserting a New Menu Between Existing Menus
 ### To insert a new menu between existing menus  
   
-1.  Select an existing menu name and press the **INSERT** key. The **New Item** box is inserted before the selected item.  
+1.  Select an existing menu name and press the **Insert** key. The **New Item** box is inserted before the selected item.  
   
      \- or -  
   
@@ -23,7 +23,6 @@ ms.workload: ["cplusplus", "uwp"]
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*.  
   
 ## Requirements  
-  
  Win32  
   
 ## See Also  
diff --git a/docs/windows/inserting-a-space-between-buttons-on-a-toolbar.md b/docs/windows/inserting-a-space-between-buttons-on-a-toolbar.md
@@ -29,7 +29,6 @@ In general, to insert a space between buttons, simply drag them away from one an
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).  
   
 ## Requirements  
-  
  MFC or ATL  
   
 ## See Also  
diff --git a/docs/windows/interface-class-cpp-component-extensions.md b/docs/windows/interface-class-cpp-component-extensions.md
@@ -19,14 +19,13 @@ Declares an interface.  For information on native interfaces, see [__interface](
 
 ### Syntax  
   
-```  
+```cpp  
 interface_access  
 interface class  
  name :  inherit_accessbase_interface{};interface_accessinterface structname :  inherit_accessbase_interface{};  
 ```  
   
 ### Parameters  
-  
  *interface_access*  
  The accessibility of an interface outside the assembly.  Possible values are **public** and **private**.  **private** is the default. Nested interfaces cannot have an *interface_access* specifier.  
   
@@ -62,15 +61,15 @@ interface class
  In the development environment, you can get F1 help on these keywords by highlighting the keyword, (`interface class`, for example) and pressing F1.  
   
 ## Windows Runtime  
- **Remarks**  
+### Remarks 
   
  (There are no remarks for this language feature that apply to only the Windows Runtime.)  
   
 ### Requirements  
  Compiler option: `/ZW`  
   
 ## Common Language Runtime 
- **Remarks**  
+### Remarks
   
  (There are no remarks for this language feature that apply to only the common language runtime.)  
   
@@ -171,8 +170,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 in Function_3  
   
diff --git a/docs/windows/interfacelist-structure.md b/docs/windows/interfacelist-structure.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename T,  
    typename U  
diff --git a/docs/windows/interfacelisthelper-structure.md b/docs/windows/interfacelisthelper-structure.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename T0,  
    typename T1 = Nil,  
diff --git a/docs/windows/interfacetraits-cancastto-method.md b/docs/windows/interfacetraits-cancastto-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template<typename T>  
 static __forceinline bool CanCastTo(  
    _In_ T* ptr,  
diff --git a/docs/windows/interfacetraits-casttobase-method.md b/docs/windows/interfacetraits-casttobase-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template<typename T>  
 static __forceinline Base* CastToBase(  
    _In_ T* ptr  
diff --git a/docs/windows/interfacetraits-casttounknown-method.md b/docs/windows/interfacetraits-casttounknown-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template<typename T>  
 static __forceinline IUnknown* CastToUnknown(  
    _In_ T* ptr  
diff --git a/docs/windows/interfacetraits-fillarraywithiid-method.md b/docs/windows/interfacetraits-fillarraywithiid-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 __forceinline static void FillArrayWithIid(  
    _Inout_ unsigned long &index,  
    _In_ IID* iids  
diff --git a/docs/windows/interfacetraits-iidcount-constant.md b/docs/windows/interfacetraits-iidcount-constant.md
diff --git a/docs/windows/interfacetraits-structure.md b/docs/windows/interfacetraits-structure.md
diff --git a/docs/windows/interfacetraits-verify-method.md b/docs/windows/interfacetraits-verify-method.md
diff --git a/docs/windows/interior-ptr-cpp-cli.md b/docs/windows/interior-ptr-cpp-cli.md
diff --git a/docs/windows/inverting-the-colors-in-a-selection-image-editor-for-icons.md b/docs/windows/inverting-the-colors-in-a-selection-image-editor-for-icons.md
diff --git a/docs/windows/invokehelper-callback-data-member.md b/docs/windows/invokehelper-callback-data-member.md
diff --git a/docs/windows/invokehelper-invoke-method.md b/docs/windows/invokehelper-invoke-method.md
diff --git a/docs/windows/invokehelper-invokehelper-constructor.md b/docs/windows/invokehelper-invokehelper-constructor.md
diff --git a/docs/windows/invokehelper-structure.md b/docs/windows/invokehelper-structure.md
