0

Cannot document any constructor with an overload.

GeoFrameworks

22 April 2008 23:10

None

Follow

The embedded editor for DocumentX is losing my work any time I try to document any object which has more than one protected overload.  It is so critical that work be saved!  When I document ten constructors and find out later that two hours of work is simply gone, it really kills my momentum. 

On the bright side, the patch you sent for protected overloads does indeed work.  Can you issue me another patch for the overloded constructors?

• Facebook
• Twitter
• LinkedIn

2 comments

• 0
  
  GeoFrameworks 22 April 2008 23:30

  Here's a class with every possible member combination I can think of.  Please test DocumentX to make sure documentation for each member will actually get saved to the source code.

  namespace Testing
  {
      public abstract class Test1
      {
          object VariableTest;
          private object PrivateVariableTest;
          protected internal object ProtectedInternalVariableTest;
          protected object ProtectedVariableTest;
          internal static object InternalStaticVariableTest;
          public static object StaticVariableTest;
  
          protected Test1()
          { }
  
          static Test1()
          { }
  
          internal Test1(object param1)
          { }
  
          protected internal Test1(object param1, object param2)
          { }
  
          protected void ProtectedTest()
          { }
  
          protected void ProtectedTest(object param1)
          { }
  
          protected void ProtectedTest(params object[] param1)
          { }
  
          protected internal void ProtectedInternalTest()
          { }
  
          protected internal void ProtectedInternalTest(object param1)
          { }
  
          protected internal void ProtectedInternalTest(params object[] param1)
          { }
  
          internal void InternalTest()
          { }
  
          internal void InternalTest(object param1)
          { }
  
          internal void InternalTest(params object[] param1)
          { }
  
          public void PublicTest()
          { }
  
          public void PublicTest(object param1)
          { }
  
          public void PublicTest(params object[] param1)
          { }
  
          static void StaticTest()
          { }
  
          static void StaticTest(object param1)
          { }
  
          static void StaticTest(params object[] param1)
          { }
  
          internal object InternalPropertyTest { get { return null; } }
  
          public object PublicPropertyTest { get { return null; } }
  
          public static object PublicStaticPropertyTest { get { return null; } }
  
          protected object ProtectedPropertyTest { get { return null; } }
  
          protected internal object ProtectedInternalPropertyTest { get { return null; } }
  
          internal object InternalMethodTest() { return null; }
  
          public object PublicMethodTest() { return null; }
  
          public static object PublicStaticMethodTest() { return null; }
  
          protected object ProtectedMethodTest() { return null; }
  
          protected internal object ProtectedInternalMethodTest() { return null; }
  
          internal virtual object VirtualInternalPropertyTest { get { return null; } }
  
          public virtual object VirtualPublicPropertyTest { get { return null; } }
  
          protected virtual object VirtualProtectedPropertyTest { get { return null; } }
  
          protected virtual internal object VirtualProtectedInternalPropertyTest { get { return null; } }
  
          internal virtual object VirtualInternalMethodTest() { return null; }
  
          public virtual object VirtualPublicMethodTest() { return null; }
  
          protected virtual object VirtualProtectedMethodTest() { return null; }
  
          protected virtual internal object VirtualProtectedInternalMethodTest() { return null; }
  
          internal abstract object AbstractInternalPropertyTest { get; }
  
          public abstract object AbstractPublicPropertyTest { get; }
  
          protected abstract object AbstractProtectedPropertyTest { get;  }
  
          protected abstract internal object AbstractProtectedInternalPropertyTest { get; }
  
          internal abstract object AbstractInternalMethodTest();
  
          public abstract object AbstractPublicMethodTest();
  
          protected abstract object AbstractProtectedMethodTest();
  
          protected abstract internal object AbstractProtectedInternalMethodTest();
      }
  }
  

• 0
  
  Matt Bates 23 April 2008 10:13

  The hotfix was tested on all types of overloads including protected constructors, can you try re-applying the hotfix.

  I also ran tests documenting the above code you supplied with the hotfix applied and all the comments came through to the Visual Studio Integrated editor. Are you seeing any issues with a specific member from your sample?