[
https://issues.apache.org/jira/browse/MJAVADOC-623?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17165167#comment-17165167
]
Anthony Vanelverdinghe commented on MJAVADOC-623:
-------------------------------------------------
What kind of issues are you referring to? I just did a test, building with
`java-api-element-list-10` and using both:
* a class that wasn't in JDK 10, but whose package was
(`java.text.CompactNumberFormat`)
* a class that wasn't in JDK 10, and whose package wasn't either
(`java.lang.constant.ConstantDesc`)
and it works: there's no warnings/errors in the output, and the generated
Javadoc contains all links as expected, i.e. only
`java.lang.constant.ConstantDesc` is unlinked.
By providing a fallback, I see several advantages:
* the plugin doesn't necessarily need to release a new version every 6 months,
just before the matching JDK release, to prevent breakage (e.g. for JDK 11 and
13, the plugin release was only available about 6 months after the JDK release)
* the plugin works with early-access releases as well. Currently there are
already EA releases for both JDK 15 and 16. So by falling back to the element
list of JDK 14, it's still possible to generate the Javadoc as expected
* (users aren't forced to upgrade the plugin version when upgrading the JDK)
Thanks for the JDK link. I agree this ought to be part of javadoc itself, but
it doesn't seem like that issue will be done anytime soon.
> [ERROR] Error fetching link:
> %{project.basedir}/target/javadoc-bundle-options. Ignored it.
> ------------------------------------------------------------------------------------------
>
> Key: MJAVADOC-623
> URL: https://issues.apache.org/jira/browse/MJAVADOC-623
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Affects Versions: 3.1.1
> Reporter: Yaytay
> Priority: Minor
>
> Not sure whether this is a bug or a something missing my side.
> Using the javadoc plugin with maven 3.6.2 and JDK 13 and a minimal
> configuration:
> {code:xml}
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-javadoc-plugin</artifactId>
> <version>3.1.1</version>
> <executions>
> <execution>
> <id>attach-javadocs</id>
> <goals>
> <goal>jar</goal>
> </goals>
> </execution>
> </executions>
> </plugin>
> {code}
> I get this error:
> [ERROR] Error fetching link:
> ${project.basedir}/target/javadoc-bundle-options. Ignored it.
> (with the ${project.basedir} being the absolute path for the project).
> If this error can be ignored it shouldn't be logged at Error level (debug or
> info would be preferable).
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
