This project has moved and is read-only. For the latest updates, please go here.

Any Workaround for Issue with Generics & Inheritance?

Topics: Developer Forum
Jan 15, 2010 at 4:32 PM
Edited Jan 15, 2010 at 4:40 PM

I have the following 4 interfaces (I've removed everything but the bare minimum to show the issue):

public interface MyBase {}

public interface DerivedObject : MyBase {}

public interface IArray<T> : IEnumerable<T> { bool Contains(T item); }

public interface MyArray : IArray<MyBase> { } 


with that setup, the following interface is not handled correctly by SHFB (namely, the IArray methods, in our example Contains, are not documented as existing in the DerivedObjectsArray interface at all)

public interface DerivedObjectArray : IArray<DerivedObject>, MyArray { }




Jan 20, 2010 at 3:36 AM

There appears to be a bug in ApplyVSDocModel.xsl.  The members in question do appear in the output file generated by MRefBuilder.  However, once it is ran through the document model transformation, the members are no longer there.  The XSL in the transformation is rather complex and is beyond my abilities to fix.  I'll submit a bug report to the Sandcastle project with a test case when I get some time.