问题标签 [maven-javadoc-plugin]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
3 回答
2840 浏览

java - 如何使 javadoc 继承适用于外部 API?(使用 Maven2)

当一个类重写具体方法或实现和抽象方法时,Javadoc 会自动继承,除非显式重写。

或者,至少该工具会尝试这样做。似乎它不适用于链接的外部 API。例如,当我在我的代码中实现java.util.Map或来自 JRE 的其他内容时,javadocs 不会从 JRE javadocs/apidocs 继承/复制。

在我的具体情况下,我试图在 Maven2 Javadoc 插件中配置它,但是当我直接运行 javadoc CLI 工具时它是相同的。

我的 Maven2 Javadoc 插件配置当前如下所示:

关于如何进行这项工作的任何指示?

0 投票
2 回答
41 浏览

java - 如何避免在创建 javadoc 期间指定 defaulAuthor 元素

如何避免在使用 javadoc插件创建 javadoc 期间指定 defaulAuthor 元素。我不想要作者元素,因为 javadocs 将被运送给客户。

0 投票
2 回答
1084 浏览

java - 作为 Delphi 程序员理解 Java

我有一个在 Delphi 中创建的数据库,该数据库仍处于测试阶段)。我花了很多时间学习才能达到这一点。我非常感谢这个论坛的帮助和感谢,以及我收到的对我的问题的答复让我听到。

目前最令人兴奋的是Android设备和用java编写但我对Java几乎一无所知。开发人员的忙碌程度是 Delphi 的五倍。Google 应用程序网页平均每天有 40 次点击,而这只是 java 的一部分。我想让 Maven 方法可以访问它来使用我还没有关于如何执行此操作的文档的数据库。

我知道我有 ShortIntegers、LongIntegers,我不确定源自 ANSCI 但可以是 UTRF-8 和其他东西的字符串。我有双号吗?我有日期记录吗?

我在java中有任何其他类型的数据类型吗

任何人都可以启发我。

0 投票
3 回答
7965 浏览

java - Maven站点(Maven 3)生成空站点文件夹

我正在尝试使用 Maven 站点插件创建一个基本的 Maven 站点。所以我把这个添加到我的 pom 中:

然后跑了mvn site --errors

嗯,奇怪的是没有输出。所以当我检查目标/站点时,它是空的。唯一的文件夹是 images/ 、 css/ 和 WEB-INF/ ,其中填充了一些通用图片。没有 javadoc 也没有站点。

这可以用mvn site:siteand重现mvn org.apache.maven.plugins:maven-site-plugin:2.2:site(显然 maven 默认只想使用 2.0.1)

奇怪的是,我可以回到 maven 2.2.1 并成功生成站点。但是当我使用 3.0.1-RC1(恰好与 Netbeans 一起提供)时,它失败了。

我做错了什么会导致站点插件在 3.0.1 而不是 2.2.1 中失败?

0 投票
2 回答
6767 浏览

maven-2 - Maven Release Plugin部署sources.jar和javadoc.jar

我使用 maven 发布插件来生成我的项目的发布。我不想一直生成 Javadoc。另一方面,当我调用 release:perform 时,我想 maven 是否会生成 sources.jar 和 javadoc.jar 并将其部署到 maven 发布存储库。只是因为我很好奇如何禁用部署 source.jar,因为它看起来像是默认部署的。

0 投票
1 回答
5120 浏览

maven - Maven 3:为定义的工件生成 Javadoc

我只想从专用文档项目中为我的项目的某些工件生成 javadocs。

这意味着我想要一个名为“docs”的独立项目。在 docs/pom.xml 中,我想定义应包含在生成的 javadocs 中的工件。

到目前为止,我了解到我必须为我想要包含的项目生成一个单独的 sources.jar。但我不知道如何从那里继续。

现在我只能想象两种方法:

  1. 获取我想要包含的工件 (sources.jar),解压缩它们并以某种方式将 Javadoc 插件指向源目录。

  2. 将我感兴趣的工件定义为依赖项,并使用 javadoc-plugin 的“dependencySourceInclude”选项。但我不确定这是否按预期使用。

任何建议如何解决这个问题?

0 投票
1 回答
5718 浏览

maven - 如何为 Maven 依赖项生成 Javadoc

我有一个带有以下 POM 片段的 Maven 项目:

这个想法是定义一个依赖关系,其中一些源是(这是之前成功创建的)。现在我想在这个依赖项上运行 javadoc。当我打电话

消息失败

不执行 Javadoc,因为项目不是支持 Java 类路径的包

怎么了 ?它会起作用吗?

或者如何从特定的依赖项生成 javadoc(假设这个项目有更多的依赖项)?

谢谢

0 投票
1 回答
312 浏览

maven-2 - 在 Maven Javadoc/站点编译期间忽略兄弟模块

我有一个 Maven 管理的项目,其中包含一些模块,其中一个是实际感兴趣的库。其他模块只是从库构建的附加组件或示例。我希望为此库生成 Maven 站点并自动部署它(作为独立站点,而不是作为多模块站点的一部分),但我在使用 Javadoc 插件时遇到了问题。

执行javadoc:javadoc目标时,javadoc 插件正在尝试访问jar导致失败的其他模块。

创建了一个简单的例子来演示这种现象。确保您clean在任何其他人之前运行目标,以便显示缺陷。虽然先执行打包会解决这个错误,但这无法解决,因为用例发生在 Maven 管理的发布过程中,该过程从干净状态开始。

有没有办法让我在 javadoc 插件中禁用此功能,以便我只获得库模块的文档?

0 投票
1 回答
6209 浏览

java - 带有 javadocs 的 Maven 多模块项目站点

我想使用 Maven 为我的应用程序创建站点。这是一个多模块app,父模块是简单的站点模块,第一个子是app的核心,第二个是GUI(Swing)。

我现在使用 follow 作为父 pom.xml

我核心的pom:

(我从两者中删除了不相关的部分)

问题:我尝试了 mvn site:stage,但没有从核心模块收集 javadoc。我错了什么?

0 投票
0 回答
568 浏览

javadoc - maven-javadoc-plugin 聚合有问题

我有一个包含三个子模块的 Maven 聚合项目,所以项目是这样的:

家长
|
|
- 孩子A |- 孩子B
|- 孩子C

这些类使用聚合和继承:Parent 将子级列为模块,每个 Child 指定 Parent 作为其父级。每个孩子都调用 maven-javadoc-plugin:jar 来生成雕刻的 javadocs,其中包含 javadocs 中包含的特定文件,效果很好。

我想在 Parent pom 中调用 maven-javadoc-plugin:aggregate-jar 以生成一个带有孩子雕刻的 javadoc 组合的单个 javadoc 文件夹,但它似乎不起作用。如果我在 Project 中运行 javadoc:aggregate-jar,它看起来会将任务聚合到子模块,这些子模块无论如何都会执行自己的 maven-javadoc-plugin,然后 Project 本身不会生成任何内容。我尝试运行几个不同的选项并使用现在已弃用的标签无济于事。我还尝试创建依赖于其他三个的第四个孩子来使用 maven-javadoc-plugin 的选项,但这似乎不起作用。令人沮丧的是,在官方 Maven 插件页面或 Google 中几乎没有关于如何使用聚合的示例,这让我相信我

有没有人曾经尝试过做这样的事情并且可以就如何让它工作提供任何帮助?感谢您的任何帮助。