windows formatting review pr30

mtx48109 · mtx48109 · commit d884ac70e1fa · 2018-08-07T15:58:27.000-07:00
diff --git a/docs/windows/event-source.md b/docs/windows/event-source.md
@@ -17,7 +17,7 @@ Creates an event source.
   
 ## Syntax  
   
-```  
+```cpp  
 [ event_source(  
    type,  
    optimize=[speed | size],  
@@ -33,7 +33,7 @@ Creates an event source.
   
 -   `com` for COM code. You must use `coclass` when `type`=`com`. This value requires that you include the following header files:  
   
-    ```  
+    ```cpp  
     #define _ATL_ATTRIBUTES  
     #include <atlbase.h>  
     #include <atlcom.h>  
diff --git a/docs/windows/eventsource-add-method.md b/docs/windows/eventsource-add-method.md
@@ -17,7 +17,7 @@ Appends the event handler represented by the specified delegate interface to the
   
 ## Syntax  
   
-```  
+```cpp  
 HRESULT Add(  
    _In_ TDelegateInterface* delegateInterface,  
    _Out_ EventRegistrationToken* token  
diff --git a/docs/windows/eventsource-addremovelock-data-member.md b/docs/windows/eventsource-addremovelock-data-member.md
@@ -17,7 +17,7 @@ Synchronizes access to the [targets_](../windows/eventsource-targets-data-member
   
 ## Syntax  
   
-```  
+```cpp  
 Wrappers::SRWLock addRemoveLock_;  
 ```  
   
diff --git a/docs/windows/eventsource-class.md b/docs/windows/eventsource-class.md
@@ -17,7 +17,7 @@ Represents a non-agile event. **EventSource** member functions add, remove, and
   
 ## Syntax  
   
-```  
+```cpp  
 template<typename TDelegateInterface>  
 class EventSource;  
 ```  
diff --git a/docs/windows/eventsource-eventsource-constructor.md b/docs/windows/eventsource-eventsource-constructor.md
@@ -17,7 +17,7 @@ Initializes a new instance of the **EventSource** class.
   
 ## Syntax  
   
-```  
+```cpp  
 EventSource();  
 ```  
   
diff --git a/docs/windows/eventsource-getsize-method.md b/docs/windows/eventsource-getsize-method.md
@@ -17,7 +17,7 @@ Retrieves the number of event handlers associated with the current **EventSource
   
 ## Syntax  
   
-```  
+```cpp  
 size_t GetSize() const;  
 ```  
   
diff --git a/docs/windows/eventsource-invokeall-method.md b/docs/windows/eventsource-invokeall-method.md
@@ -17,7 +17,7 @@ Calls each event handler associated with the current [EventSource](../windows/ev
   
 ## Syntax  
   
-```  
+```cpp  
 void InvokeAll();  
 template <  
    typename T0  
diff --git a/docs/windows/eventsource-remove-method.md b/docs/windows/eventsource-remove-method.md
@@ -17,7 +17,7 @@ Deletes the event handler represented by the specified event registration token
   
 ## Syntax  
   
-```  
+```cpp  
 HRESULT Remove(  
    EventRegistrationToken token  
 );  
@@ -31,7 +31,7 @@ HRESULT Remove(
  S_OK if successful; otherwise, an HRESULT that indicates the error.  
   
 ## Remarks  
- For more information about the EventRegistrationToken structure, see the `Windows::Foundation::EventRegistrationToken` Structure topic in the Windows Runtime reference documentation.  
+ For more information about the `EventRegistrationToken` structure, see the **Windows::Foundation::EventRegistrationToken Structure** topic in the **Windows Runtime** reference documentation.  
   
 ## Requirements  
  **Header:** event.h  
diff --git a/docs/windows/eventsource-targets-data-member.md b/docs/windows/eventsource-targets-data-member.md
@@ -17,7 +17,7 @@ An array of one or more event handlers.
   
 ## Syntax  
   
-```  
+```cpp  
 ComPtr<Details::EventTargetArray> targets_;  
 ```  
   
diff --git a/docs/windows/eventsource-targetspointerlock-data-member.md b/docs/windows/eventsource-targetspointerlock-data-member.md
@@ -17,7 +17,7 @@ Synchronizes access to internal data members even while event handlers for this
   
 ## Syntax  
   
-```  
+```cpp  
 Wrappers::SRWLock targetsPointerLock_;  
 ```  
   
diff --git a/docs/windows/eventtargetarray-addtail-method.md b/docs/windows/eventtargetarray-addtail-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 void AddTail(  
    _In_ IUnknown* element  
 );  
diff --git a/docs/windows/eventtargetarray-begin-method.md b/docs/windows/eventtargetarray-begin-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 ComPtr<IUnknown>* Begin();  
 ```  
   
diff --git a/docs/windows/eventtargetarray-class.md b/docs/windows/eventtargetarray-class.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 class EventTargetArray : public Microsoft::WRL::RuntimeClass<Microsoft::WRL::RuntimeClassFlags<ClassicCom>, IUnknown>;  
 ```  
   
diff --git a/docs/windows/eventtargetarray-end-method.md b/docs/windows/eventtargetarray-end-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 ComPtr<IUnknown>* End();  
 ```  
   
diff --git a/docs/windows/eventtargetarray-eventtargetarray-constructor.md b/docs/windows/eventtargetarray-eventtargetarray-constructor.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 EventTargetArray(  
    _Out_ HRESULT* hr,  
    size_t items  
diff --git a/docs/windows/eventtargetarray-length-method.md b/docs/windows/eventtargetarray-length-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 size_t Length();  
 ```  
   
diff --git a/docs/windows/eventtargetarray-tilde-eventtargetarray-destructor.md b/docs/windows/eventtargetarray-tilde-eventtargetarray-destructor.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 ~EventTargetArray();  
 ```  
   
diff --git a/docs/windows/eventtraits-structure.md b/docs/windows/eventtraits-structure.md
@@ -17,7 +17,7 @@ Defines characteristics of an `Event` class handle.
   
 ## Syntax  
   
-```  
+```cpp  
 struct EventTraits : HANDLENullTraits;  
 ```  
   
diff --git a/docs/windows/explicit-overrides-cpp-component-extensions.md b/docs/windows/explicit-overrides-cpp-component-extensions.md
@@ -15,15 +15,14 @@ ms.workload: ["cplusplus", "uwp"]
 This topic discusses how to explicitly override a member of a base class or interface. A named (explicit) override should only be used to override a method with a derived method that has a different name.  
   
 ## All Runtimes  
- **Syntax**  
+### Syntax
   
-```  
+```cpp  
 overriding-function-declarator = type::function [,type::function] { overriding-function-definition }  
 overriding-function-declarator = function { overriding-function-definition }  
 ```  
-  
- **Parameters**  
-  
+
+### Parameters 
  *overriding-function-declarator*  
  The return type, name, and argument list of the overriding function.  Note that the overriding function does not have to have the same name as the function being overridden.  
   
@@ -36,7 +35,7 @@ overriding-function-declarator = function { overriding-function-definition }
  *overriding-function-definition*  
  The function body statements that define the overriding function.  
   
- **Remarks**  
+### Remarks
   
  Use explicit overrides to create an alias for a method signature, or to provide different implementations for methods witht the same signature.  
   
@@ -48,15 +47,14 @@ overriding-function-declarator = function { overriding-function-definition }
  Compiler option: `/ZW`  
   
 ## Common Language Runtime 
- **Remarks**  
+### Remarks
   
  For information about explicit overrides in native code or code compiled with `/clr:oldSyntax`, see [Explicit Overrides](../cpp/explicit-overrides-cpp.md).  
   
 ### Requirements  
  Compiler option: `/clr`  
   
-### Examples  
- **Example**  
+### Examples   
   
  The following code example shows a simple, implicit override and implementation of a member in a base interface, not using explicit overrides.  
   
@@ -80,14 +78,10 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 X::f override of I1::f  
 ```  
   
- **Example**  
-  
  The following code example shows how to implement all interface members with a common signature, using explicit override syntax.  
   
 ```cpp  
@@ -115,18 +109,14 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 X::f override of I1::f and I2::f  
 X::f override of I1::f and I2::f  
 ```  
   
- **Example**  
-  
  The following code example shows how a function override can have a different name from the function it is implementing.  
   
-```  
+```cpp  
 // explicit_override_3.cpp  
 // compile with: /clr  
 interface struct I1 {  
@@ -146,14 +136,10 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 X::g  
 ```  
   
- **Example**  
-  
  The following code example shows an explicit interface implementation that implements a type safe collection.  
   
 ```cpp  
diff --git a/docs/windows/export.md b/docs/windows/export.md
@@ -17,7 +17,7 @@ Causes a data structure to be placed in the .idl file.
   
 ## Syntax  
   
-```  
+```cpp  
 [export]  
 ```  
   
diff --git a/docs/windows/factorycache-cookie-data-member.md b/docs/windows/factorycache-cookie-data-member.md
@@ -17,7 +17,7 @@ Supports the Windows Runtime C++ Template Library infrastructure and is not inte
   
 ## Syntax  
   
-```  
+```cpp  
 union {   
    WINRT_REGISTRATION_COOKIE winrt;  
    DWORD com;   
diff --git a/docs/windows/factorycache-factory-data-member.md b/docs/windows/factorycache-factory-data-member.md
@@ -17,7 +17,7 @@ Supports the Windows Runtime C++ Template Library infrastructure and is not inte
   
 ## Syntax  
   
-```  
+```cpp  
 IUnknown* factory;  
 ```  
   
diff --git a/docs/windows/factorycache-structure.md b/docs/windows/factorycache-structure.md
@@ -17,7 +17,7 @@ Supports the Windows Runtime C++ Template Library infrastructure and is not inte
   
 ## Syntax  
   
-```  
+```cpp  
 struct FactoryCache;  
 ```  
   
diff --git a/docs/windows/filehandletraits-structure.md b/docs/windows/filehandletraits-structure.md
@@ -17,7 +17,7 @@ Defines characteristics of a file handle.
   
 ## Syntax  
   
-```  
+```cpp  
 struct FileHandleTraits : HANDLETraits;  
 ```  
   
diff --git a/docs/windows/files-affected-by-resource-editing.md b/docs/windows/files-affected-by-resource-editing.md
@@ -20,8 +20,6 @@ The Visual Studio environment works with the files shown in the following table
 |Filename.aps|Binary version of the current resource script file; used for quick loading.<br /><br /> The resource editors do not directly read .rc or resource.h files. The resource compiler compiles them into .aps files, which are consumed by the resource editors. This file is a compile step and only stores symbolic data. As with a normal compile process, information that is not symbolic (for example, comments) is discarded during the compile process. Whenever the .aps file gets out of synch with the .rc file, the .rc file is regenerated (for example, when you Save, the resource editor overwrites the .rc file and the resource.h file). Any changes to the resources themselves will remain incorporated in the .rc file, but comments will always be lost once the .rc file is overwritten. For information on how to preserve comments, see [Including Resources at Compile Time](../windows/how-to-include-resources-at-compile-time.md). (Typically, you should not include the .aps file in source control.)|  
 |.rc|Resource script file that contains script for the resources in your current project. This file is overwritten by the .aps file whenever you save. (Include this file in source control.)|  
   
-
-  
 ## Requirements  
  Win32  
   
diff --git a/docs/windows/filling-a-bounded-area-of-an-image-with-a-color-image-editor-for-icons.md b/docs/windows/filling-a-bounded-area-of-an-image-with-a-color-image-editor-for-icons.md
@@ -30,7 +30,6 @@ The Image editor provides the **Fill** tool for filling any enclosed image area
  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  
-  
  None  
   
 ## See Also  
diff --git a/docs/windows/finding-a-string.md b/docs/windows/finding-a-string.md
@@ -36,7 +36,6 @@ You can search for one or more strings in the string table, and use [regular exp
  For information on adding resources to managed projects (those that target the common language runtime), 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 resources strings to properties, see [Walkthrough: Localizing Windows Forms](http://msdn.microsoft.com/9a96220d-a19b-4de0-9f48-01e5d82679e5) and [Walkthrough: Using Resources for Localization with ASP.NET](http://msdn.microsoft.com/Library/bb4e5b44-e2b0-48ab-bbe9-609fb33900b6).  
   
 ## Requirements  
-  
  Win32  
   
 ## See Also  
diff --git a/docs/windows/finding-an-entry-in-an-accelerator-table.md b/docs/windows/finding-an-entry-in-an-accelerator-table.md
@@ -26,7 +26,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/finding-binary-data.md b/docs/windows/finding-binary-data.md
@@ -28,7 +28,6 @@ You can search for either ASCII strings or hexadecimal bytes. For example, to fi
  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  
-  
  None  
   
 ## See Also  
diff --git a/docs/windows/first-is.md b/docs/windows/first-is.md
@@ -17,7 +17,7 @@ Specifies the index of the first array element to be transmitted.
   
 ## Syntax  
   
-```  
+```cpp  
 [ first_is(  
    "expression"  
 ) ]  
diff --git a/docs/windows/flipping-an-image-image-editor-for-icons.md b/docs/windows/flipping-an-image-image-editor-for-icons.md
@@ -38,7 +38,6 @@ You can flip or rotate an image to:
  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  
-  
  None  
   
 ## See Also  
diff --git a/docs/windows/ftmbase-class.md b/docs/windows/ftmbase-class.md
@@ -17,7 +17,7 @@ Represents a free-threaded marshaler object.
   
 ## Syntax  
   
-```  
+```cpp  
 class FtmBase : public Microsoft::WRL::Implements<  
    Microsoft::WRL::RuntimeClassFlags<WinRtClassicComMix>,   
    Microsoft::WRL::CloakedIid<IMarshal> >;  
diff --git a/docs/windows/ftmbase-createglobalinterfacetable-method.md b/docs/windows/ftmbase-createglobalinterfacetable-method.md
diff --git a/docs/windows/ftmbase-disconnectobject-method.md b/docs/windows/ftmbase-disconnectobject-method.md
diff --git a/docs/windows/ftmbase-ftmbase-constructor.md b/docs/windows/ftmbase-ftmbase-constructor.md
diff --git a/docs/windows/ftmbase-getmarshalsizemax-method.md b/docs/windows/ftmbase-getmarshalsizemax-method.md
diff --git a/docs/windows/ftmbase-getunmarshalclass-method.md b/docs/windows/ftmbase-getunmarshalclass-method.md
diff --git a/docs/windows/ftmbase-marshalinterface-method.md b/docs/windows/ftmbase-marshalinterface-method.md
diff --git a/docs/windows/ftmbase-marshaller-data-member.md b/docs/windows/ftmbase-marshaller-data-member.md
diff --git a/docs/windows/ftmbase-releasemarshaldata-method.md b/docs/windows/ftmbase-releasemarshaldata-method.md
