Fix javadoc generation

Author: jozic

.github/workflows/ci.yml

@@ -26,3 +26,5 @@ jobs:
       run: mvn --version
     - name: Build
       run: mvn -ntp -B clean verify
+    - name: Generate site
+      run: mvn clean site -P publicsite

pom.xml

@@ -89,6 +89,8 @@ under the License.
 
         <maven.version>3.9.6</maven.version>
         <maven-plugin-plugin.version>3.10.2</maven-plugin-plugin.version>
+        <maven-reporting-api.version>3.1.1</maven-reporting-api.version>
+        <doxia.version>1.11.1</doxia.version>
 
         <scalac-scoverage-plugin.version>2.0.11</scalac-scoverage-plugin.version>
         <scalac-scoverage-plugin.scala.version>2.13</scalac-scoverage-plugin.scala.version>
@@ -147,13 +149,13 @@ under the License.
         <dependency>
             <groupId>org.apache.maven.reporting</groupId>
             <artifactId>maven-reporting-api</artifactId>
-            <version>3.1.1</version>
+            <version>${maven-reporting-api.version}</version>
         </dependency>
 
         <dependency>
             <groupId>org.apache.maven.doxia</groupId>
             <artifactId>doxia-site-renderer</artifactId>
-            <version>1.11.1</version>
+            <version>${doxia.version}</version>
         </dependency>
 
         <dependency>
@@ -264,10 +266,9 @@ under the License.
                         <subpackages>org.scoverage.plugin</subpackages>
                         <links>
                             <link>https://docs.oracle.com/javase/11/docs/api/</link>
-                            <link>https://maven.apache.org/ref/${maven.version}/maven-plugin-api/apidocs/</link>
-                            <link>https://maven.apache.org/ref/${maven.version}/maven-project/apidocs/</link>
-                            <link>https://maven.apache.org/ref/${maven.version}/maven-reporting/maven-reporting-api/apidocs/</link>
-                            <link>https://maven.apache.org/doxia/doxia/apidocs/</link>
+                            <link>https://maven.apache.org/ref/${maven.version}/apidocs/</link>
+                            <link>https://maven.apache.org/shared-archives/maven-reporting-api-${maven-reporting-api.version}/apidocs/</link>
+                            <link>https://maven.apache.org/doxia/components/doxia-archives/doxia-${doxia.version}/apidocs/</link>
                         </links>
                         <notimestamp>true</notimestamp>
                     </configuration>
@@ -749,13 +750,11 @@ under the License.
                     <plugin>
                         <groupId>org.apache.maven.plugins</groupId>
                         <artifactId>maven-source-plugin</artifactId>
-                        <version>3.3.0</version>
                     </plugin>
 
                     <plugin>
                         <groupId>org.apache.maven.plugins</groupId>
                         <artifactId>maven-javadoc-plugin</artifactId>
-                        <version>3.6.3</version>
                     </plugin>
 
                     <plugin>

src/main/java/org/scoverage/plugin/ScalaVersion.java

@@ -9,13 +9,42 @@
 public class ScalaVersion {
     private static final Pattern regexp = Pattern.compile("(\\d+)\\.(\\d+)(\\.\\d+)?([-\\.].+)?");
 
+    /**
+     * The full version number, including the modifier if any.
+     */
     public String full;
+
+    /**
+     * The binary compatible version number for this Scala version.
+     * e.g. for 2.10.0-M1, this would be 2.10.0-M1, for 2.10.0, this would be 2.10, for 3.3.1, this would be 3.
+     */
     public String compatible;
+
+    /**
+     * The major Scala version number. e.g. for 2.10.0-M1, this would be 2.
+     */
     public int major;
+
+    /**
+     * The minor Scala version number. e.g. for 2.10.0-M1, this would be 10.
+     */
     public int minor;
+
+    /**
+     * The bugfix Scala version number. e.g. for 2.10.0-M1, this would be 0.
+     */
     public int bugfix;
+
+    /**
+     * The modifier for this Scala version. e.g. for 2.10.0-M1, this would be M1.
+     */
     public String modifier;
 
+    /**
+     * Creates a ScalaVersion from a String.
+     *
+     * @param s String to parse
+     */
     public ScalaVersion(String s) {
         full = s;
         // parse
@@ -40,6 +69,9 @@ public ScalaVersion(String s) {
 
     /**
      * Ignores modifier, so can return `true` for any ScalaVersion with matching major, minor, bugfix.
+     *
+     * @param other ScalaVersion to compare to
+     * @return true if this version is of the same or newer Scala version as the other version
      */
     public boolean isAtLeast(ScalaVersion other) {
         return major >= other.major &&
@@ -48,10 +80,20 @@ public boolean isAtLeast(ScalaVersion other) {
 
     }
 
+    /**
+     * Ignores modifier, so can return `true` for any ScalaVersion with matching major, minor, bugfix.
+     *
+     * @param scalaVersion to compare to
+     * @return true if this version is of the same or newer Scala version as the other version
+     */
     public boolean isAtLeast(String scalaVersion) {
         return isAtLeast(new ScalaVersion(scalaVersion));
     }
 
+
+    /**
+     * @return true if this is a Scala 2 version
+     */
     public boolean isScala2() {
         return major == 2;
     }