port javadoc improvements for GROOVY-5901