mdoc: Support for alternate inheritance chains in frameworks.

If a framework has a different inheritance chain, another `Base/BaseTypeName`
element will be added with a `FrameworkAlternate` attribute.

Resolves #16

8 files changed, 202 insertions, 0 deletions

diff --git a/mdoc/Test/DocTest-framework-inheritance.cs b/mdoc/Test/DocTest-framework-inheritance.cs
new file mode 100644
index 00000000..ca18dfff
--- /dev/null
+++ b/mdoc/Test/DocTest-framework-inheritance.cs
@@ -0,0 +1,13 @@
+namespace MyNamespace {
+	public abstract class MyBaseClassOne {}
+    public abstract class MyBaseClassTwo {}
+
+    public class MyClass
+    #if FXONE
+        : MyBaseClassOne
+    #endif
+    #if FXTWO
+        : MyBaseClassTwo
+    #endif
+    {}
+}
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/One.xml b/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/One.xml
new file mode 100644
index 00000000..5c82e3fc
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/One.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Framework Name="One">
+  <Namespace Name="MyNamespace">
+    <Type Name="MyNamespace.MyBaseClassOne" Id="T:MyNamespace.MyBaseClassOne">
+      <Member Id="M:MyNamespace.MyBaseClassOne.#ctor" />
+    </Type>
+    <Type Name="MyNamespace.MyBaseClassTwo" Id="T:MyNamespace.MyBaseClassTwo">
+      <Member Id="M:MyNamespace.MyBaseClassTwo.#ctor" />
+    </Type>
+    <Type Name="MyNamespace.MyClass" Id="T:MyNamespace.MyClass">
+      <Member Id="M:MyNamespace.MyClass.#ctor" />
+    </Type>
+  </Namespace>
+</Framework>
\ No newline at end of file
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/Two.xml b/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/Two.xml
new file mode 100644
index 00000000..10bc5828
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/FrameworksIndex/Two.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Framework Name="Two">
+  <Namespace Name="MyNamespace">
+    <Type Name="MyNamespace.MyBaseClassOne" Id="T:MyNamespace.MyBaseClassOne">
+      <Member Id="M:MyNamespace.MyBaseClassOne.#ctor" />
+    </Type>
+    <Type Name="MyNamespace.MyBaseClassTwo" Id="T:MyNamespace.MyBaseClassTwo">
+      <Member Id="M:MyNamespace.MyBaseClassTwo.#ctor" />
+    </Type>
+    <Type Name="MyNamespace.MyClass" Id="T:MyNamespace.MyClass">
+      <Member Id="M:MyNamespace.MyClass.#ctor" />
+    </Type>
+  </Namespace>
+</Framework>
\ No newline at end of file
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassOne.xml b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassOne.xml
new file mode 100644
index 00000000..1f242b13
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassOne.xml
@@ -0,0 +1,40 @@
+<Type Name="MyBaseClassOne" FullName="MyNamespace.MyBaseClassOne">
+  <TypeSignature Language="C#" Value="public abstract class MyBaseClassOne" />
+  <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit MyBaseClassOne extends System.Object" />
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <Base>
+    <BaseTypeName>System.Object</BaseTypeName>
+  </Base>
+  <Interfaces />
+  <Docs>
+    <summary>To be added.</summary>
+    <remarks>To be added.</remarks>
+  </Docs>
+  <Members>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="protected MyBaseClassOne ();" />
+      <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" />
+      <MemberType>Constructor</MemberType>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <Parameters />
+      <Docs>
+        <summary>To be added.</summary>
+        <remarks>To be added.</remarks>
+      </Docs>
+    </Member>
+  </Members>
+</Type>
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassTwo.xml b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassTwo.xml
new file mode 100644
index 00000000..7596f8b8
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyBaseClassTwo.xml
@@ -0,0 +1,40 @@
+<Type Name="MyBaseClassTwo" FullName="MyNamespace.MyBaseClassTwo">
+  <TypeSignature Language="C#" Value="public abstract class MyBaseClassTwo" />
+  <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit MyBaseClassTwo extends System.Object" />
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <Base>
+    <BaseTypeName>System.Object</BaseTypeName>
+  </Base>
+  <Interfaces />
+  <Docs>
+    <summary>To be added.</summary>
+    <remarks>To be added.</remarks>
+  </Docs>
+  <Members>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="protected MyBaseClassTwo ();" />
+      <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" />
+      <MemberType>Constructor</MemberType>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <Parameters />
+      <Docs>
+        <summary>To be added.</summary>
+        <remarks>To be added.</remarks>
+      </Docs>
+    </Member>
+  </Members>
+</Type>
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyClass.xml b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyClass.xml
new file mode 100644
index 00000000..090b4202
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/MyNamespace/MyClass.xml
@@ -0,0 +1,41 @@
+<Type Name="MyClass" FullName="MyNamespace.MyClass">
+  <TypeSignature Language="C#" Value="public class MyClass : MyNamespace.MyBaseClassTwo" />
+  <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit MyClass extends MyNamespace.MyBaseClassTwo" />
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <AssemblyInfo>
+    <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+    <AssemblyVersion>0.0.0.0</AssemblyVersion>
+  </AssemblyInfo>
+  <Base>
+    <BaseTypeName>MyNamespace.MyBaseClassOne</BaseTypeName>
+    <BaseTypeName FrameworkAlternate="Two">MyNamespace.MyBaseClassTwo</BaseTypeName>
+  </Base>
+  <Interfaces />
+  <Docs>
+    <summary>To be added.</summary>
+    <remarks>To be added.</remarks>
+  </Docs>
+  <Members>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="public MyClass ();" />
+      <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
+      <MemberType>Constructor</MemberType>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-one</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <AssemblyInfo>
+        <AssemblyName>DocTest-framework-inheritance-two</AssemblyName>
+        <AssemblyVersion>0.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <Parameters />
+      <Docs>
+        <summary>To be added.</summary>
+        <remarks>To be added.</remarks>
+      </Docs>
+    </Member>
+  </Members>
+</Type>
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/index.xml b/mdoc/Test/en.expected-frameworks-inheritance/index.xml
new file mode 100644
index 00000000..81ba359f
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/index.xml
@@ -0,0 +1,34 @@
+<Overview>
+  <Assemblies>
+    <Assembly Name="DocTest-framework-inheritance-one" Version="0.0.0.0">
+      <Attributes>
+        <Attribute>
+          <AttributeName>System.Diagnostics.Debuggable(System.Diagnostics.DebuggableAttribute+DebuggingModes.IgnoreSymbolStoreSequencePoints)</AttributeName>
+        </Attribute>
+        <Attribute>
+          <AttributeName>System.Runtime.CompilerServices.RuntimeCompatibility(WrapNonExceptionThrows=true)</AttributeName>
+        </Attribute>
+      </Attributes>
+    </Assembly>
+    <Assembly Name="DocTest-framework-inheritance-two" Version="0.0.0.0">
+      <Attributes>
+        <Attribute>
+          <AttributeName>System.Diagnostics.Debuggable(System.Diagnostics.DebuggableAttribute+DebuggingModes.IgnoreSymbolStoreSequencePoints)</AttributeName>
+        </Attribute>
+        <Attribute>
+          <AttributeName>System.Runtime.CompilerServices.RuntimeCompatibility(WrapNonExceptionThrows=true)</AttributeName>
+        </Attribute>
+      </Attributes>
+    </Assembly>
+  </Assemblies>
+  <Remarks>To be added.</Remarks>
+  <Copyright>To be added.</Copyright>
+  <Types>
+    <Namespace Name="MyNamespace">
+      <Type Name="MyBaseClassOne" Kind="Class" />
+      <Type Name="MyBaseClassTwo" Kind="Class" />
+      <Type Name="MyClass" Kind="Class" />
+    </Namespace>
+  </Types>
+  <Title>Untitled</Title>
+</Overview>
diff --git a/mdoc/Test/en.expected-frameworks-inheritance/ns-MyNamespace.xml b/mdoc/Test/en.expected-frameworks-inheritance/ns-MyNamespace.xml
new file mode 100644
index 00000000..bd8d4316
--- /dev/null
+++ b/mdoc/Test/en.expected-frameworks-inheritance/ns-MyNamespace.xml
@@ -0,0 +1,6 @@
+<Namespace Name="MyNamespace">
+  <Docs>
+    <summary>To be added.</summary>
+    <remarks>To be added.</remarks>
+  </Docs>
+</Namespace>