Validate Java 11

asciidoctor · Apr 20, 2024 · f5016b4 · f5016b4
1 parent ab68303
commit f5016b4
Show file tree

Hide file tree

Showing 2 changed files with 37 additions and 3 deletions.
diff --git a/docs/modules/ROOT/pages/usage.adoc b/docs/modules/ROOT/pages/usage.adoc
@@ -87,6 +87,43 @@ Asciidoclet may be used via a `maven-javadoc-plugin` doclet for the supported Ja
 
 Asciidoclet may be used via a doclet in the `Javadoc` task:
 
+[source,groovy]
+.Java 11+
+----
+plugins {
+    id 'java'
+}
+
+configurations {
+    asciidoclet
+}
+
+dependencies {
+    asciidoclet 'org.asciidoctor:asciidoclet:2.0.+'
+}
+
+javadoc {
+    options {
+        docletpath = configurations.asciidoclet.files.asType(List)
+        doclet = 'org.asciidoctor.asciidoclet.Asciidoclet'
+        overview = "src/main/java/overview.adoc"
+        addStringOption "-base-dir", "${projectDir}" // <1>
+        addStringOption \
+            "-attribute", // <2>
+                "name=${project.name}," +
+                "version=${project.version}," +
+                "title-link=https://example.com[${project.name} ${project.version}]"
+        jFlags \
+            "--add-exports=jdk.javadoc/jdk.javadoc.internal.tool=ALL-UNNAMED"
+    }
+}
+----
+<1> Option names passed to Gradle's `javadoc` task must omit the leading "-", so here "-base-dir" means "--base-dir".
+ifdef::site-gen-antora[See xref:options.adoc[].]
+ifndef::site-gen-antora[See <<doclet-options>> below.]
+<2> Gradle's `javadoc` task does not allow multiple occurrences of the same option.
+Multiple attributes can be specified in a single string, separated by commas.
+
 [source,groovy]
 .Java 17+
 ----

diff --git a/src/it/java-11/class-comments/pom.xml b/src/it/java-11/class-comments/pom.xml
@@ -21,9 +21,6 @@
 					<source>11</source>
 					<additionalJOptions>
 						<additionalJOption>-J--add-exports=jdk.javadoc/jdk.javadoc.internal.tool=ALL-UNNAMED</additionalJOption>
-						<additionalJOption>-J--add-exports=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED</additionalJOption>
-						<additionalJOption>-J--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED</additionalJOption>
-						<additionalJOption>-J--add-exports=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED</additionalJOption>
 						<additionalJOption>-Xdoclint:all,-html,-accessibility</additionalJOption>
 					</additionalJOptions>
 					<doclet>org.asciidoctor.asciidoclet.Asciidoclet</doclet>