mdoc/Mono.Documentation/Updater/EcmaDocumentationImporter.cs


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

using System;
using System.Xml;

using StringList = System.Collections.Generic.List<string>;

namespace Mono.Documentation.Updater
{
    class EcmaDocumentationImporter : DocumentationImporter
    {

        XmlReader ecmadocs;

        public EcmaDocumentationImporter (XmlReader ecmaDocs)
        {
            this.ecmadocs = ecmaDocs;
        }

        public override void ImportDocumentation (DocsNodeInfo info)
        {
            if (!ecmadocs.IsStartElement ("Docs"))
            {
                return;
            }

            XmlElement e = info.Node;

            int depth = ecmadocs.Depth;
            ecmadocs.ReadStartElement ("Docs");
            while (ecmadocs.Read ())
            {
                if (ecmadocs.Name == "Docs")
                {
                    if (ecmadocs.Depth == depth && ecmadocs.NodeType == XmlNodeType.EndElement)
                        break;
                    else
                        throw new InvalidOperationException ("Skipped past current <Docs/> element!");
                }
                if (!ecmadocs.IsStartElement ())
                    continue;
                switch (ecmadocs.Name)
                {
                    case "param":
                    case "typeparam":
                        {
                            string name = ecmadocs.GetAttribute ("name");
                            if (name == null)
                                break;
                            XmlNode doc = e.SelectSingleNode (
                                    ecmadocs.Name + "[@name='" + name + "']");
                            string value = ecmadocs.ReadInnerXml ();
                            if (doc != null)
                                doc.InnerXml = value.Replace ("\r", "");
                            break;
                        }
                    case "altmember":
                    case "exception":
                    case "permission":
                    case "seealso":
                        {
                            string name = ecmadocs.Name;
                            string cref = ecmadocs.GetAttribute ("cref");
                            if (cref == null)
                                break;
                            XmlNode doc = e.SelectSingleNode (
                                    ecmadocs.Name + "[@cref='" + cref + "']");
                            string value = ecmadocs.ReadInnerXml ().Replace ("\r", "");
                            if (doc != null)
                                doc.InnerXml = value;
                            else
                            {
                                XmlElement n = e.OwnerDocument.CreateElement (name);
                                n.SetAttribute ("cref", cref);
                                n.InnerXml = value;
                                e.AppendChild (n);
                            }
                            break;
                        }
                    default:
                        {
                            string name = ecmadocs.Name;
                            string xpath = ecmadocs.Name;
                            StringList attributes = new StringList (ecmadocs.AttributeCount);
                            if (ecmadocs.MoveToFirstAttribute ())
                            {
                                do
                                {
                                    attributes.Add ("@" + ecmadocs.Name + "=\"" + ecmadocs.Value + "\"");
                                } while (ecmadocs.MoveToNextAttribute ());
                                ecmadocs.MoveToContent ();
                            }
                            if (attributes.Count > 0)
                            {
                                xpath += "[" + string.Join (" and ", attributes.ToArray ()) + "]";
                            }
                            XmlNode doc = e.SelectSingleNode (xpath);
                            string value = ecmadocs.ReadInnerXml ().Replace ("\r", "");
                            if (doc != null)
                            {
                                doc.InnerXml = value;
                            }
                            else
                            {
                                XmlElement n = e.OwnerDocument.CreateElement (name);
                                n.InnerXml = value;
                                foreach (string a in attributes)
                                {
                                    int eq = a.IndexOf ('=');
                                    n.SetAttribute (a.Substring (1, eq - 1), a.Substring (eq + 2, a.Length - eq - 3));
                                }
                                e.AppendChild (n);
                            }
                            break;
                        }
                }
            }
        }
    }
}