I want my Javadoc to inherit comments from standard JDK classes. For this, I need to add JDK sources to -sourcepath javadoc option. Not to generate documentation for JDK classes themselves, I would specify packages via -packagenames or -subpackages javadoc options, but Javadoc Gradle task doesn’t support them.
This question on SO: http://stackoverflow.com/questions/25266023/how-to-accomplish-inheriting-javadoc-comments-from-jdk-with-gradle-javadoc-task