Imported Upstream version 6.6.0.89

Former-commit-id: b39a328747c2f3414dc52e009fb6f0aa80ca2492
2019-09-24 08:53:40 +00:00
parent cf815e07e0
commit 95fdb59ea6
2556 changed files with 138145 additions and 47453 deletions
--- a/external/api-doc-tools/mdoc/Mono.Documentation/Updater/DocsNodeInfo.cs
+++ b/external/api-doc-tools/mdoc/Mono.Documentation/Updater/DocsNodeInfo.cs
@@ -0,0 +1,105 @@
+using System;
+using System.Collections.Generic;
+using System.Xml;
+
+using Mono.Cecil;
+
+using Mono.Documentation.Util;
+
+namespace Mono.Documentation.Updater
+{
+    public class DocsNodeInfo
+    {
+        public DocsNodeInfo (XmlElement node)
+        {
+            this.Node = node;
+        }
+
+        public DocsNodeInfo (XmlElement node, TypeDefinition type)
+            : this (node)
+        {
+            SetType (type);
+        }
+
+        public DocsNodeInfo (XmlElement node, MemberReference member)
+            : this (node)
+        {
+            SetMemberInfo (member);
+        }
+
+        void SetType (TypeDefinition type)
+        {
+            if (type == null)
+                throw new ArgumentNullException ("type");
+            Type = type;
+            GenericParameters = new List<GenericParameter> (type.GenericParameters);
+            List<TypeReference> declTypes = DocUtils.GetDeclaringTypes (type);
+            int maxGenArgs = DocUtils.GetGenericArgumentCount (type);
+            for (int i = 0; i < declTypes.Count - 1; ++i)
+            {
+                int remove = System.Math.Min (maxGenArgs,
+                        DocUtils.GetGenericArgumentCount (declTypes[i]));
+                maxGenArgs -= remove;
+                while (remove-- > 0)
+                    GenericParameters.RemoveAt (0);
+            }
+            if (DocUtils.IsDelegate (type))
+            {
+                Parameters = type.GetMethod ("Invoke").Parameters;
+                ReturnType = type.GetMethod ("Invoke").ReturnType;
+                ReturnIsReturn = true;
+            }
+        }
+
+        void SetMemberInfo (MemberReference member)
+        {
+            if (member == null)
+                throw new ArgumentNullException ("member");
+            ReturnIsReturn = true;
+            AddRemarks = true;
+            Member = member;
+
+            if (member is MethodReference)
+            {
+                MethodReference mr = (MethodReference)member;
+                Parameters = mr.Parameters;
+                if (mr.IsGenericMethod ())
+                {
+                    GenericParameters = new List<GenericParameter> (mr.GenericParameters);
+                }
+            }
+            else if (member is PropertyDefinition)
+            {
+                Parameters = ((PropertyDefinition)member).Parameters;
+            }
+
+            if (member is MethodDefinition)
+            {
+                ReturnType = ((MethodDefinition)member).ReturnType;
+            }
+            else if (member is PropertyDefinition)
+            {
+                ReturnType = ((PropertyDefinition)member).PropertyType;
+                ReturnIsReturn = false;
+            }
+
+            // no remarks section for enum members
+            if (member.DeclaringType != null && ((TypeDefinition)member.DeclaringType).IsEnum)
+                AddRemarks = false;
+        }
+
+        public TypeReference ReturnType;
+        public List<GenericParameter> GenericParameters;
+        public IList<ParameterDefinition> Parameters;
+        public bool ReturnIsReturn;
+        public XmlElement Node;
+        public bool AddRemarks = true;
+        public MemberReference Member;
+        public TypeDefinition Type;
+
+        public override string ToString ()
+        {
+            return string.Format ("{0} - {1} - {2}", Type, Member, Node == null ? "no xml" : "with xml");
+        }
+    }
+}