Problem with @InheritConstructors with multiple level of inheritance (part 1 of 2 - document the current limitation)

See also GROOVY-5274 which will be the actual fix, changing the focus of this issue to updating the doco to outline the current limitations.

=======================

See test eclipse project attached.

• Class Hierarchy : A <-- inherit – B <-- inherit – C

• A define constructor public A(String dummy) {...}

• B and C use @InheritConstructors.

• In the main(...) : C.class.newInstance("tata")

• Result : Exception in thread "main" groovy.lang.GroovyRuntimeException: Could not find matching constructor for: data.C(java.lang.String)
  at groovy.lang.MetaClassImpl.invokeConstructor(MetaClassImpl.java:1474)
  at groovy.lang.MetaClassImpl.invokeConstructor(MetaClassImpl.java:1390)
  at org.codehaus.groovy.runtime.InvokerHelper.invokeConstructorOf(InvokerHelper.java:824)
  at org.codehaus.groovy.runtime.DefaultGroovyMethods.newInstance(DefaultGroovyMethods.java:17689)
  at org.codehaus.groovy.runtime.dgm$511.doMethodInvoke(Unknown Source)
  at org.codehaus.groovy.runtime.callsite.StaticMetaMethodSite.invoke(StaticMetaMethodSite.java:43)
  at org.codehaus.groovy.runtime.callsite.StaticMetaMethodSite.call(StaticMetaMethodSite.java:88)
  at org.codehaus.groovy.runtime.callsite.CallSiteArray.defaultCall(CallSiteArray.java:42)
  at org.codehaus.groovy.runtime.callsite.AbstractCallSite.call(AbstractCallSite.java:108)
  at org.codehaus.groovy.runtime.callsite.AbstractCallSite.call(AbstractCallSite.java:116)
  at Main.MainLaunch.main(MainLaunch.groovy:7)