Add a test to verify xml/intellisense docs are present

This assumes all the xml docs are only present in the targeting packs,
and not anywhere else.

I am not sure if the ignore list is correct: do all the packages listed
look okay?

Fixes: #2127

Author: omajid

smoke-test.sh

@@ -334,6 +334,219 @@ function runWebTests() {
     doCommand F# webapi "$@" new restore build run multi-rid-publish
 }
 
+function runXmlDocTests() {
+    targetingPacksDir="$dotnetDir/packs/"
+    echo "Looking for xml docs in targeting packs in $targetingPacksDir"
+
+    netstandardIgnoreList=(
+        Microsoft.Win32.Primitives.xml
+        mscorlib.xml
+        System.AppContext.xml
+        System.Buffers.xml
+        System.Collections.Concurrent.xml
+        System.Collections.NonGeneric.xml
+        System.Collections.Specialized.xml
+        System.Collections.xml
+        System.ComponentModel.Composition.xml
+        System.ComponentModel.EventBasedAsync.xml
+        System.ComponentModel.Primitives.xml
+        System.ComponentModel.TypeConverter.xml
+        System.ComponentModel.xml
+        System.Console.xml
+        System.Core.xml
+        System.Data.Common.xml
+        System.Data.xml
+        System.Diagnostics.Contracts.xml
+        System.Diagnostics.Debug.xml
+        System.Diagnostics.FileVersionInfo.xml
+        System.Diagnostics.Process.xml
+        System.Diagnostics.StackTrace.xml
+        System.Diagnostics.TextWriterTraceListener.xml
+        System.Diagnostics.Tools.xml
+        System.Diagnostics.TraceSource.xml
+        System.Diagnostics.Tracing.xml
+        System.Drawing.Primitives.xml
+        System.Drawing.xml
+        System.Dynamic.Runtime.xml
+        System.Globalization.Calendars.xml
+        System.Globalization.Extensions.xml
+        System.Globalization.xml
+        System.IO.Compression.FileSystem.xml
+        System.IO.Compression.xml
+        System.IO.Compression.ZipFile.xml
+        System.IO.FileSystem.DriveInfo.xml
+        System.IO.FileSystem.Primitives.xml
+        System.IO.FileSystem.Watcher.xml
+        System.IO.FileSystem.xml
+        System.IO.IsolatedStorage.xml
+        System.IO.MemoryMappedFiles.xml
+        System.IO.Pipes.xml
+        System.IO.UnmanagedMemoryStream.xml
+        System.IO.xml
+        System.Linq.Expressions.xml
+        System.Linq.Parallel.xml
+        System.Linq.Queryable.xml
+        System.Linq.xml
+        System.Memory.xml
+        System.Net.Http.xml
+        System.Net.NameResolution.xml
+        System.Net.NetworkInformation.xml
+        System.Net.Ping.xml
+        System.Net.Primitives.xml
+        System.Net.Requests.xml
+        System.Net.Security.xml
+        System.Net.Sockets.xml
+        System.Net.WebHeaderCollection.xml
+        System.Net.WebSockets.Client.xml
+        System.Net.WebSockets.xml
+        System.Net.xml
+        System.Numerics.Vectors.xml
+        System.Numerics.xml
+        System.ObjectModel.xml
+        System.Reflection.DispatchProxy.xml
+        System.Reflection.Emit.ILGeneration.xml
+        System.Reflection.Emit.Lightweight.xml
+        System.Reflection.Emit.xml
+        System.Reflection.Extensions.xml
+        System.Reflection.Primitives.xml
+        System.Reflection.xml
+        System.Resources.Reader.xml
+        System.Resources.ResourceManager.xml
+        System.Resources.Writer.xml
+        System.Runtime.CompilerServices.VisualC.xml
+        System.Runtime.Extensions.xml
+        System.Runtime.Handles.xml
+        System.Runtime.InteropServices.RuntimeInformation.xml
+        System.Runtime.InteropServices.xml
+        System.Runtime.Numerics.xml
+        System.Runtime.Serialization.Formatters.xml
+        System.Runtime.Serialization.Json.xml
+        System.Runtime.Serialization.Primitives.xml
+        System.Runtime.Serialization.xml
+        System.Runtime.Serialization.Xml.xml
+        System.Runtime.xml
+        System.Security.Claims.xml
+        System.Security.Cryptography.Algorithms.xml
+        System.Security.Cryptography.Csp.xml
+        System.Security.Cryptography.Encoding.xml
+        System.Security.Cryptography.Primitives.xml
+        System.Security.Cryptography.X509Certificates.xml
+        System.Security.Principal.xml
+        System.Security.SecureString.xml
+        System.ServiceModel.Web.xml
+        System.Text.Encoding.Extensions.xml
+        System.Text.Encoding.xml
+        System.Text.RegularExpressions.xml
+        System.Threading.Overlapped.xml
+        System.Threading.Tasks.Extensions.xml
+        System.Threading.Tasks.Parallel.xml
+        System.Threading.Tasks.xml
+        System.Threading.ThreadPool.xml
+        System.Threading.Thread.xml
+        System.Threading.Timer.xml
+        System.Threading.xml
+        System.Transactions.xml
+        System.ValueTuple.xml
+        System.Web.xml
+        System.Windows.xml
+        System.xml
+        System.Xml.Linq.xml
+        System.Xml.ReaderWriter.xml
+        System.Xml.Serialization.xml
+        System.Xml.XDocument.xml
+        System.Xml.xml
+        System.Xml.XmlDocument.xml
+        System.Xml.XmlSerializer.xml
+        System.Xml.XPath.XDocument.xml
+        System.Xml.XPath.xml
+    )
+
+    netcoreappIgnoreList=(
+        Microsoft.VisualBasic.xml
+        netstandard.xml
+        System.AppContext.xml
+        System.Buffers.xml
+        System.ComponentModel.DataAnnotations.xml
+        System.Configuration.xml
+        System.Core.xml
+        System.Data.DataSetExtensions.xml
+        System.Data.xml
+        System.Diagnostics.Debug.xml
+        System.Diagnostics.Tools.xml
+        System.Drawing.xml
+        System.Dynamic.Runtime.xml
+        System.Globalization.Calendars.xml
+        System.Globalization.Extensions.xml
+        System.Globalization.xml
+        System.IO.Compression.FileSystem.xml
+        System.IO.FileSystem.Primitives.xml
+        System.IO.UnmanagedMemoryStream.xml
+        System.IO.xml
+        System.Net.xml
+        System.Numerics.xml
+        System.Reflection.Extensions.xml
+        System.Reflection.xml
+        System.Resources.Reader.xml
+        System.Resources.ResourceManager.xml
+        System.Runtime.Extensions.xml
+        System.Runtime.Handles.xml
+        System.Runtime.Serialization.xml
+        System.Security.Principal.xml
+        System.Security.SecureString.xml
+        System.Security.xml
+        System.ServiceModel.Web.xml
+        System.ServiceProcess.xml
+        System.Text.Encoding.xml
+        System.Threading.Tasks.Extensions.xml
+        System.Threading.Tasks.xml
+        System.Threading.Timer.xml
+        System.Transactions.xml
+        System.ValueTuple.xml
+        System.Web.xml
+        System.Windows.xml
+        System.xml
+        System.Xml.Linq.xml
+        System.Xml.Serialization.xml
+        System.Xml.xml
+        System.Xml.XmlDocument.xml
+    )
+
+    error=0
+    while IFS= read -r -d '' dllFile; do
+        xmlDocFile=${dllFile%.*}.xml
+        skip=0
+        if [[ "$xmlDocFile" == *"/packs/Microsoft.NETCore.App.Ref"* ]]; then
+            xmlFileBasename=$(basename "$xmlDocFile")
+            for ignoreItem in "${netcoreappIgnoreList[@]}"; do
+                if [[ "$ignoreItem" == "$xmlFileBasename" ]]; then
+                    skip=1;
+                    break
+                fi
+            done
+        fi
+        if [[ "$xmlDocFile" == *"/packs/NETStandard.Library.Ref"* ]]; then
+            xmlFileBasename=$(basename "$xmlDocFile")
+            for ignoreItem in "${netstandardIgnoreList[@]}"; do
+                if [[ "$ignoreItem" == "$xmlFileBasename" ]]; then
+                    skip=1;
+                    break
+                fi
+            done
+        fi
+        if [[ $skip == 0 ]] && [[ ! -f "$xmlDocFile" ]]; then
+            error=1
+            echo "error: missing $xmlDocFile"
+        fi
+    done < <(find "$targetingPacksDir" -name '*.dll' -print0)
+
+    if [[ $error != 0 ]]; then
+        echo "error: Missing xml documents"
+        exit 1
+    else
+        echo "All expected xml docs are present"
+    fi
+}
+
 function resetCaches() {
     rm -rf "$testingHome"
     mkdir "$testingHome"
@@ -456,4 +669,6 @@ if [ "$excludeOnlineTests" == "false" ]; then
     echo "ONLINE RESTORE SOURCE - ALL TESTS PASSED!"
 fi
 
+runXmlDocTests
+
 echo "ALL TESTS PASSED!"