Address Javadoc warnings

Author: jjohannes

src/main/java/org/gradlex/javamodule/testing/JavaModuleTestingExtension.java

@@ -57,6 +57,8 @@ public JavaModuleTestingExtension(Project project, JavaModuleDetector moduleDete
      * For example:
      *
      * javaModuleTesting.blackbox(testing.suites["integtest"])
+     *
+     * @param jvmTestSuite the JVM Test Suite to configure
      */
     public void blackbox(TestSuite jvmTestSuite) {
         if (jvmTestSuite instanceof JvmTestSuite) {
@@ -69,6 +71,8 @@ public void blackbox(TestSuite jvmTestSuite) {
      * For example:
      *
      * javaModuleTesting.whitebox(testing.suites["test"])
+     *
+     * @param jvmTestSuite the JVM Test Suite to configure
      */
     public void whitebox(TestSuite jvmTestSuite) {
         whitebox(jvmTestSuite, NO_OP_ACTION);
@@ -85,6 +89,9 @@ public void whitebox(TestSuite jvmTestSuite) {
      *   requires.add("org.junit.jupiter.api")
      *   opensTo.add("org.junit.platform.commons")
      * }
+     *
+     * @param jvmTestSuite the JVM Test Suite to configure
+     * @param conf configuration details for the whitebox test setup
      */
     public void whitebox(TestSuite jvmTestSuite, Action<WhiteboxJvmTestSuite> conf) {
         if (jvmTestSuite instanceof JvmTestSuite) {

src/main/java/org/gradlex/javamodule/testing/WhiteboxJvmTestSuite.java

@@ -25,19 +25,25 @@ public interface WhiteboxJvmTestSuite {
     /**
      * Configure which source set contains the 'sources under test' for
      * this Whitebox Test Suite - defaults to 'main'.
+     *
+     * @return the source set under test
      */
     Property<SourceSet> getSourcesUnderTest();
 
     /**
      * Add additional 'requires' directives for the test code.
      * For example, 'requires.add("org.junit.jupiter.api")'.
+     *
+     * @return modifiable list of addition 'requires' (--add-reads)
      */
     ListProperty<String> getRequires();
 
     /**
      * Open all packages of this Whitebox Test Suite to a given Module
      * for reflection at runtime.
      * For example, 'opensTo.add("org.junit.platform.commons")'.
+     *
+     * @return modifiable list of addition '--add-opens'
      */
     ListProperty<String> getOpensTo();
 }