Move java-9 profile above the platform profiles

ctrueden · ctrueden · commit 1dc5c0abd880 · 2022-08-23T16:16:00.000-05:00
And add a comment explaining it.
diff --git a/pom.xml b/pom.xml
@@ -2058,6 +2058,31 @@
 			</build>
 		</profile>
 
+		<!--
+		The java-9 profile includes adjustments for Java 9+; in particular, it
+		configures the release value, and fixes the path to the javadoc executable.
+		-->
+		<profile>
+			<id>java-9</id>
+			<activation>
+				<jdk>[9,)</jdk>
+			</activation>
+			<properties>
+				<maven.compiler.release>${scijava.jvm.version}</maven.compiler.release>
+			</properties>
+			<build>
+				<plugins>
+					<plugin>
+						<groupId>org.apache.maven.plugins</groupId>
+						<artifactId>maven-javadoc-plugin</artifactId>
+						<configuration>
+							<javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
+						</configuration>
+					</plugin>
+				</plugins>
+			</build>
+		</profile>
+
 		<!--
 		The following profiles set the scijava.platform system properties to
 		match the detected architecture. The main intended use case is for
@@ -2187,25 +2212,5 @@
 				<scijava.platform.arch>64</scijava.platform.arch>
 			</properties>
 		</profile>
-		<profile>
-			<id>java-9</id>
-			<activation>
-				<jdk>[9,)</jdk>
-			</activation>
-			<properties>
-				<maven.compiler.release>${scijava.jvm.version}</maven.compiler.release>
-			</properties>
-			<build>
-				<plugins>
-					<plugin>
-						<groupId>org.apache.maven.plugins</groupId>
-						<artifactId>maven-javadoc-plugin</artifactId>
-						<configuration>
-							<javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
-						</configuration>
-					</plugin>
-				</plugins>
-			</build>
-		</profile>
 	</profiles>
 </project>
