Add language identifiers to inline snippets (dotnet#178)

ChrisMaddock · mairaw · commit a174c8a05dd9 · 2018-05-14T16:02:16.000-07:00
diff --git a/xml/Microsoft.Build.Execution/ProjectItemInstance.xml b/xml/Microsoft.Build.Execution/ProjectItemInstance.xml
@@ -440,7 +440,7 @@
   
  The <xref:Microsoft.Build.Framework.ITaskItem.ItemSpec%2A> for the following item declaration in a project file is `File.cs`.  
   
-```  
+```xml  
 <ItemGroup>  
     <Compile Include="File.cs"/>  
 </ItemGroup>  
diff --git a/xml/Microsoft.Build.Framework/ITaskItem.xml b/xml/Microsoft.Build.Framework/ITaskItem.xml
@@ -158,7 +158,7 @@
   
  The <xref:Microsoft.Build.Framework.ITaskItem.ItemSpec%2A> for the following item declaration in a project file is `File.cs`.  
   
-```  
+```xml  
 <ItemGroup>  
     <Compile Include="File.cs"/>  
 </ItemGroup>  
diff --git a/xml/Microsoft.Build.Framework/RequiredAttribute.xml b/xml/Microsoft.Build.Framework/RequiredAttribute.xml
@@ -36,7 +36,7 @@
   
  To run this task use a project file like this:  
   
-```  
+```xml  
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
     <Target Name="MyTarget">  
         <MkDir Directories="NewDir" />  
diff --git a/xml/Microsoft.Build.Tasks/GenerateApplicationManifest.xml b/xml/Microsoft.Build.Tasks/GenerateApplicationManifest.xml
@@ -24,7 +24,7 @@
   
  In [!INCLUDE[vs_orcas_long](~/includes/vs-orcas-long-md.md)], [!INCLUDE[vstecmsbuild](~/includes/vstecmsbuild-md.md)] does not issue this error when the `EntryPoint` task parameter is not specified. Instead, the \<customHostSpecified> tag is inserted as a child of the \<entryPoint> tag, for example, as follows.  
   
-```  
+```xml  
 <entryPoint xmlns="urn:schemas-   
   microsoft-com:asm.v2">  
     <co.v1:customHostSpecified />  
@@ -197,7 +197,7 @@
 ## Remarks  
  File types can be custom. The following is an example of a [\<fileAssociation> Element (ClickOnce Application)](http://msdn.microsoft.com/library/8f951b4f-54f9-412e-a9e5-af4e379fcf08):  
   
-```  
+```xml  
 <FileAssociation Include=".nyt">  
     <ProgId>NewYorkTimes.Document</ProgId>  
     <DefaultIcon>nyt.ico</DefaultIcon>  
diff --git a/xml/Microsoft.Build.Tasks/ResolveAssemblyReference.xml b/xml/Microsoft.Build.Tasks/ResolveAssemblyReference.xml
@@ -480,7 +480,7 @@
   
  Format of the file is like:  etc.  
   
-```  
+```xml  
 <FileList Redist="MatchingRedistListName" >  
   <File AssemblyName="System" Version="2.0.0.0"  
     PublicKeyToken="b77a5c561934e089" Culture="neutral"  
@@ -662,7 +662,7 @@
 ## Remarks  
  This is the format of the file:  
   
-```  
+```xml  
 <FileList Redist="ClientSubset" >  
     <File AssemblyName="System" Version="2.0.0.0"   
       PublicKeyToken="b77a5c561934e089" Culture="neutral"   
diff --git a/xml/Microsoft.Build.Utilities/TaskItem.xml b/xml/Microsoft.Build.Utilities/TaskItem.xml
@@ -278,7 +278,7 @@
 ## Remarks  
  The <xref:Microsoft.Build.Framework.ITaskItem.ItemSpec%2A> for the following item declaration in a project file is `File.cs`.  
   
-```  
+```xml  
 <ItemGroup>  
     <Compile Include="File.cs"/>  
 </ItemGroup>  
diff --git a/xml/Microsoft.Build.Utilities/ToolTask.xml b/xml/Microsoft.Build.Utilities/ToolTask.xml
@@ -238,7 +238,7 @@
   
 ## Examples  
   
-```  
+```csharp  
 using System;  
 using Microsoft.Build.Utilities;  
 using System.Collections.Specialized;  
diff --git a/xml/Microsoft.CSharp/CSharpCodeProvider.xml b/xml/Microsoft.CSharp/CSharpCodeProvider.xml
@@ -109,7 +109,7 @@
 ## Examples  
  The following configuration file example demonstrates how to specify that version 3.5 of the C# code provider should be used.  
   
-```  
+```xml  
 <configuration>  
   <system.codedom>  
     <compilers>  
diff --git a/xml/Microsoft.VisualBasic.ApplicationServices/WindowsFormsApplicationBase.xml b/xml/Microsoft.VisualBasic.ApplicationServices/WindowsFormsApplicationBase.xml
@@ -1412,7 +1412,7 @@
 ## Examples  
  This example demonstrates how to set the GDI+ text rendering engine as the application's default rendering engine by overriding the <xref:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.UseCompatibleTextRendering%2A> property.  
   
-```  
+```vb  
 Protected Overloads Shared ReadOnly Property UseCompatibleTextRendering() As Boolean  
     Get  
         ' Use the GDI+ text rendering engine.  
diff --git a/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml b/xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml
@@ -34,7 +34,7 @@
 ## Examples  
  The following example demonstrates how to declare and use a `FixedLengthString`.  
   
-```  
+```vb  
 Private Sub DemoFixedLengthString()  
     ' Declare a string that has a length of 7 characters and assign the  
     ' initial string. The additional 5 positions will be padded with  
@@ -94,7 +94,7 @@ End Sub
 ## Examples  
  The following example demonstrates how to declare and use a <xref:Microsoft.VisualBasic.Compatibility.VB6.FixedLengthString>.  
   
-```  
+```vb  
 Private Sub DemoFixedLengthString()  
     ' Declare a string that has a length of 7 characters.   
     Dim fixedString As New FixedLengthString(7)  
@@ -144,7 +144,7 @@ End Sub
 ## Examples  
  The following example demonstrates how to declare and use a <xref:Microsoft.VisualBasic.Compatibility.VB6.FixedLengthString>.  
   
-```  
+```vb  
 Private Sub DemoFixedLengthString()  
     ' Declare a string that has a length of 7 characters and assign the  
     ' initial string. The additional 5 positions will be padded with  
@@ -246,7 +246,7 @@ End Sub
 ## Examples  
  The following example demonstrates how to declare and use a <xref:Microsoft.VisualBasic.Compatibility.VB6.FixedLengthString>.  
   
-```  
+```vb  
 Private Sub DemoFixedLengthString()  
     ' Declare a string that has a length of 7 characters and assign the  
     ' initial string. The additional 5 positions will be padded with  
@@ -295,7 +295,7 @@ End Sub
 ## Examples  
  The following example demonstrates how to declare and use a <xref:Microsoft.VisualBasic.Compatibility.VB6.FixedLengthString>.  
   
-```  
+```vb  
 Private Sub DemoFixedLengthString()  
     ' Declare a string that has a length of 7 characters and assign the  
     ' initial string. The additional 5 positions will be padded with  
diff --git a/xml/Microsoft.VisualBasic.Logging/FileLogTraceListener.xml b/xml/Microsoft.VisualBasic.Logging/FileLogTraceListener.xml
@@ -97,7 +97,7 @@
   
  For this example to run, you must provide the fully qualified assembly name. For information about how to obtain the fully qualified assembly name, see [Assembly Names](~/docs/framework/app-domains/assembly-names.md).  
   
-```  
+```xml  
 <configuration>  
     <system.diagnostics>  
         <sharedListeners>  
diff --git a/xml/Microsoft.VisualBasic/Collection.xml b/xml/Microsoft.VisualBasic/Collection.xml
@@ -44,7 +44,7 @@
   
  You can create a collection the same way you create other objects, as the following example illustrates.  
   
-```  
+```vb  
 Dim coll As New Microsoft.VisualBasic.Collection()  
 ```  
   
@@ -110,7 +110,7 @@ Dim coll As New Microsoft.VisualBasic.Collection()
 ## Examples  
  The following example creates a new Visual Basic collection and assigns it to the variable `coll`:  
   
-```  
+```vb  
 Dim coll As New Microsoft.VisualBasic.Collection()  
 ```  
   
diff --git a/xml/Microsoft.VisualBasic/DateAndTime.xml b/xml/Microsoft.VisualBasic/DateAndTime.xml
@@ -30,7 +30,7 @@
 ## Examples  
  This example uses the `Today` property to return the current system date.  
   
-```  
+```vb  
 Dim thisDate As Date  
 thisDate = Today   
 ```  
@@ -806,7 +806,7 @@ Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
   
  To get the current system date or time in the format of your locale, or in a custom format, supply the <xref:Microsoft.VisualBasic.DateAndTime.Now%2A> property to the <xref:Microsoft.VisualBasic.Strings.Format%2A> function, specifying either a predefined or user-defined date/time format. The following example demonstrates this.  
   
-```  
+```vb  
 MsgBox("The formatted date is " & Format(Now, "dddd, d MMM yyyy"))  
 ```  
   
@@ -1412,7 +1412,7 @@ Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
   
  To get the current system date or time in the format of your locale, or in a custom format, supply the <xref:Microsoft.VisualBasic.DateAndTime.Now%2A> property to the <xref:Microsoft.VisualBasic.Strings.Format%2A> function, specifying either a predefined or user-defined date/time format. The following example demonstrates this.  
   
-```  
+```vb  
 MsgBox("The formatted time is " & Format(Now, "hh.mm.ss.fff tt"))  
 ```  
   
diff --git a/xml/Microsoft.VisualBasic/ErrObject.xml b/xml/Microsoft.VisualBasic/ErrObject.xml
@@ -25,7 +25,7 @@
 ## Examples  
  This example uses the properties of the `Err` object in constructing an error-message dialog box. Notice what happens when you use the `Clear` method first: When you then generate a Visual Basic error with the `Raise` method, Visual Basic's default values become the properties of the `Err` object.  
   
-```  
+```vb  
 Dim Msg As String  
 ' If an error occurs, construct an error message.  
 On Error Resume Next   ' Defer error handling.  
diff --git a/xml/Microsoft.VisualBasic/Globals.xml b/xml/Microsoft.VisualBasic/Globals.xml
@@ -30,7 +30,7 @@
 ## Examples  
  The following example uses the `ScriptEngineMajorVersion` property and related properties to return a string describing the current runtime information:  
   
-```  
+```vb  
 Function getRuntimeInfo() As String  
     Dim runtime As String = ScriptEngine & " Version "  
     runtime &= CStr(ScriptEngineMajorVersion) & "."  
diff --git a/xml/Microsoft.VisualBasic/Information.xml b/xml/Microsoft.VisualBasic/Information.xml
@@ -30,7 +30,7 @@
 ## Examples  
  The following example uses the `VbTypeName` function to return data type names for several variables.  
   
-```  
+```vb  
 Dim sysDateName As String = "System.DateTime"  
 Dim sysShortName As String = "Int16"  
 Dim sysBadName As String = "Nonsense"  
diff --git a/xml/Microsoft.VisualBasic/Interaction.xml b/xml/Microsoft.VisualBasic/Interaction.xml
@@ -30,7 +30,7 @@
 ## Examples  
  The following example uses the `Shell` function to run an application specified by the user. Specifying <xref:Microsoft.VisualBasic.AppWinStyle.NormalFocus?displayProperty=nameWithType> as the second argument opens the application in normal size and gives it the focus.  
   
-```  
+```vb  
 Dim procID As Integer  
 ' Run calculator.  
 procID = Shell("C:\Windows\system32\calc.exe", AppWinStyle.NormalFocus)  
@@ -1283,7 +1283,7 @@ ID = Shell("""C:\Program Files\display.exe"" -a -q", , True, 100000)
   
  Each pair of adjacent double quotation marks (`" "`) within the string literal is interpreted as one double quotation character in the string. Therefore, the preceding example presents the following string to the `Shell` function:  
   
-```  
+```console  
 "C:\Program Files\display.exe" -a -q  
 ```  
   
diff --git a/xml/Microsoft.VisualBasic/VBCodeProvider.xml b/xml/Microsoft.VisualBasic/VBCodeProvider.xml
@@ -109,7 +109,7 @@
 ## Examples  
  The following configuration file example demonstrates how to specify that version 3.5 of the Visual Basic code provider should be used.  
   
-```  
+```xml  
 <configuration>  
   <system.codedom>  
     <compilers>  
diff --git a/xml/ns-System.Diagnostics.PerformanceData.xml b/xml/ns-System.Diagnostics.PerformanceData.xml
@@ -19,7 +19,7 @@
   
 2.  After writing your manifest, use the [CTRPP](https://msdn.microsoft.com/library/windows/desktop/aa372128\(v=vs.85\).aspx) tool to compile the manifest (ctrpp provider.man). The tool generates four files: .h, .c, .rc, and *_r.h. You can ignore the .h and .c files. The .rc file contains the localized strings defined in your manifest. You use the .rc and *_r.h files to create the compiled resource file (.res) that you include in your project. The following call shows how to compile the resource file:  
   
-    ```  
+    ```console  
     rc /r /i "c:\Program Files\Microsoft SDKs\Windows\v6.0\Include" provider.rc  
     ```  
   
@@ -39,7 +39,7 @@
   
 4.  After you finish your provider, use the LodCtr tool to register the counters on the computer. For example,  
   
-    ```  
+    ```console  
     lodctr /m:provider.man  
     ```  
   
@@ -52,7 +52,7 @@
 ## Examples  
  The following shows a simple manifest:  
   
-```  
+```xml  
 <!-- <?xml version="1.0" encoding="UTF-16"?> -->  
 <instrumentationManifest xsi:schemaLocation="http://schemas.microsoft.com/win/2004/08/events eventman.xsd"   
      xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"   
@@ -154,7 +154,7 @@
   
  The following shows a simple provider implementation for the manifest:  
   
-```  
+```cs  
 using System.Diagnostics.PerformanceData;  
   
         private static Guid providerId = new Guid("{51D1685C-35ED-45be-99FE-17261A4F27F3}");  
diff --git a/xml/ns-System.Xml.xml b/xml/ns-System.Xml.xml
@@ -56,7 +56,7 @@
   
  For example, the following schema includes elements that have the same name but different types in the same content model, and substitution groups are used. This should cause an error, but <xref:System.Xml> compiles and validates the schema without errors.  
   
-```  
+```xml  
 <?xml version="1.0" encoding="utf-8" ?>   
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">  
   
@@ -98,7 +98,7 @@
   
  For example, in the schema below the content model is ambiguous and should cause a compilation error, but <xref:System.Xml> compiles the schema without errors.  
   
-```  
+```xml  
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">  
   
   <xs:element name="e1" type="xs:int"/>  
@@ -117,7 +117,7 @@
   
  If you try to validate the following XML against the schema above, the validation will fail with the following message: "The element 'e3' has invalid child element 'e2'." and an <xref:System.Xml.Schema.XmlSchemaValidationException> exception will be thrown.  
   
-```  
+```xml  
 <e3>  
   <e2>1</e2>  
   <e2>2</e2>  
@@ -126,7 +126,7 @@
   
  To work around this problem, you can swap element declarations in the XSD document. For example:  
   
-```  
+```xml  
 <xs:sequence>  
   <xs:element ref="e1" minOccurs="0" maxOccurs="1"/>  
   <xs:element name="e2" type="xs:int" minOccurs="0" maxOccurs="1"/>  
@@ -135,7 +135,7 @@
   
  becomes this:  
   
-```  
+```xml  
 <xs:sequence>  
   <xs:element name="e2" type="xs:int" minOccurs="0" maxOccurs="1"/>  
   <xs:element ref="e1" minOccurs="0" maxOccurs="1"/>  
@@ -144,7 +144,7 @@
   
  Here's another example of the same issue:  
   
-```  
+```xml  
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">  
    <xs:element name="e1" type="xs:string"/>  
    <xs:element name="e2" type="xs:string" substitutionGroup="e1"/>  
@@ -161,7 +161,7 @@
   
  If you try to validate the following XML against the schema above, the validation will fail with the following exception: "Unhandled Exception: System.Xml.Schema.XmlSchemaValidationException: The 'e2' el element is invalid - The value 'abc' is invalid according to its datatype 'http://www.w3.org/2001/XMLSchema:int' - The string 'abc' is not a valid Int32 value."\  
   
-```  
+```xml  
 <e3><e2>abc</e2></e3>  
 ```  
   
