Tag: maven javadoc plugin

如何使javadocinheritance适用于外部API？（与Maven2）: 当类重写具体方法或实现和抽象方法时，除非显式覆盖，否则Javadoc会自动inheritance。或者，至少该工具尝试这样做。它似乎不适用于链接的外部API。例如，当我在我的代码中实现java.util.Map或JRE中的其他内容时，javadocs不会从JRE javadocs / apidocsinheritance/复制。在我的具体情况下，我试图在Maven2 Javadoc插件中配置它，但是当我直接运行javadoc CLI工具时它是一样的。我的Maven2 Javadoc插件配置目前看起来像这样： org.apache.maven.plugins maven-javadoc-plugin 2.7 maven http://download.oracle.com/javase/6/docs/api 有关如何使这项工作的任何指示？

使用Eclipse编译器而不是javac会导致javadoc崩溃: 概要：我遇到了一个有趣的问题，我不太确定如何侦察它：我们的项目已经建好几个月了我更改了maven-compiler-plugin以使用eclipse编译器而不是javac 现在当我运行mvn site ， maven-javadoc-plugin失败了根据堆栈跟踪，看起来Javadoc工具正在崩溃Eclipse编译器创建的类文件有没有什么办法解决这一问题？如果没有，是否至少有进一步调试的方法？详细信息：我正在使用Java 1.6.0_27和Maven 3.0.2。我一直在使用javac编译器来构建我们的代码库，但我对尝试Eclipse编译器很感兴趣，因为它产生了更好的警告（并且在其他方面更易于配置）。所以我将pom.xml中maven-compiler-plugin的定义更改为： maven-compiler-plugin 2.3.2 eclipse 1.6 1.6 -warn:+boxing,enumSwitch,javadoc,hashCode true true org.codehaus.plexus plexus-compiler-eclipse 1.8.2 在我的部分中，我有： org.apache.maven.plugins maven-javadoc-plugin 2.8 到现在为止还挺好。我做了一个mvn clean install ，一切都很好，所有测试都通过，一切看起来都很棒。但是当我尝试运行mvn site ，当它到达Javadoc报告时，它失败了，似乎是一个Javadoc崩溃： [ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.0:site (default-site) on project framework: Error during page generation: Error […]

Maven站点（Maven 3）生成空站点文件夹: 我正在尝试使用maven网站插件创建一个基本的maven网站。所以我把它添加到我的pom： org.apache.maven.plugins maven-javadoc-plugin 2.7 Leon Blakey ${project.version} http://download.oracle.com/javase/6/docs/api 并运行mvn site –errors [INFO] Error stacktraces are turned on. [INFO] Scanning for projects… [INFO] [INFO] ———————————————————————— [INFO] Building pircbotx 1.3-SNAPSHOT [INFO] ———————————————————————— [INFO] [INFO] — maven-site-plugin:2.0.1:site (default-site) @ pircbotx — [INFO] ———————————————————————— [INFO] BUILD SUCCESS [INFO] ———————————————————————— [INFO] Total time: 2.688s [INFO] Finished at: Wed Jan […]

目标org.apache.maven.plugins执行attach-javadocs：maven-javadoc-plugin：3.0.0：jar使用Java10失败: 在链接升级到Java 10之后，将Javadoc注释中的链接断开到JDK包并尝试重现相同的内容，同时我可以将构建配置设置为： org.apache.maven.plugins maven-compiler-plugin 3.7.0 9 9 org.ow2.asm asm 6.1 org.apache.maven.plugins maven-javadoc-plugin 3.0.0 -html5 true true true public true attach-javadocs jar 注 – 在执行mvn clean verify -X这与Java-9一起成功运行。另一方面，如果我将源和目标更改为10（Java-10），则构建将失败，并出现由NullPointerException引起的PluginExecutionException以及以下堆栈跟踪： Execution attach-javadocs of goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.0:jar failed. at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:213) at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:154) at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:146) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:117) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:81) at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build (SingleThreadedBuilder.java:56) at org.apache.maven.lifecycle.internal.LifecycleStarter.execute (LifecycleStarter.java:128) […]

无法在Javadoc注释中链接到JDK10: 从Java 9升级到10后，使用Javadoc工具生成文档时，指向JDK的链接不再有效（例如，对于导入java.util.Optional的文件， {@link Optional}呈现为Optional而不是Optional ;同样的问题与@return see， @return @param ， @return以及其他任何你通常看到Javadoc链接的地方）。我有一个简单的模块化项目，我正在使用Maven和Javadoc插件（在编译器插件的configuration部分中将source和target选项设置为10 ）。我的理解是默认情况下它将-link https://docs.oracle.com/javase/10/docs/api/传递给Javadoc工具。这也是我的理解，从历史上看，Javadoc工具期望一个名为package-list的文本文件出现在它被告知要查找外部文档的URL中。 Java 8 有一个。 Java 9 有一个。 Java 10 没有（404错误）。显然，Javadoc工具现在为模块化项目输出一个名为element-list而不是package-list的文本文件，但似乎也没有提供（Java9也没有提供，但它可用于早期访问的Java构建11 ）。通过IntelliJ生成Javadoc，并启用了启用Link to JDK documentation的选项Link to JDK documentation可以产生相同的结果。它说传递-link https://docs.oracle.com/javase/10/docs/api/到javadoc.exe ，它报告javadoc: error – Error fetching URL: https://docs.oracle.com/javase/10/docs/api/ 。尽管有错误，它确实输出了Javadoc，但与Maven一样，没有JDK链接。这应该怎么样？当他们将JDK文档放到网上时，Oracle是否搞砸了？我的pom.xml的相关部分： org.apache.maven.plugins maven-compiler-plugin 3.7.0 […]