We're generating groovydocs in runtime in our app. We use groovydoc as a library, not standalone tool.
It mostly works, but we're experiencing issues with some classes ending up unresolved. I found out that this happens because SimpleGroovyClassDoc is calling its getClass().getClassLoader() to get classloader for class resolution. But in our case, most of classes that we want to link should be loaded via different classloader.
Basically, solution that would work for us, is to replace getClass().getClassLoader() calls in SimpleGroovyClassDoc with Thread.currentThread().getContextClassLoader(), but that might be a breaking change.
I'm not sure what the process is for requesting such changes and whether it's something that Groovy team is willing to implement.