javadoc相关内容

当 Javadoc 标签不完整时,Maven 在 Java 8 中不起作用

自从我使用 Maven 以来,我已经能够在我的本地存储库中构建和安装具有不完整 Javadoc 标记(例如,缺少参数)的项目. 但是,自从我迁移到 Java 8 (1.8.0-ea-b90) 后,Maven 对缺少文档标签绝对严格,并且当我尝试构建或安装一个Javadoc 并不“完美".我试图在本地存储库中编译和安装的一些项目是我无法控制的第三方项目.因此,在我的场景中,仅修复所有这些项目中 ..
发布时间:2021-11-25 20:17:03 Java Web开发

Eclipse:通过本地属性将源/javadoc 附加到库

我的 SVN 存储库中有一个第三方库,我想在 Eclipse 中将 source/javadoc 与其本地关联.即,应该有一些本地设置(例如,local.properties 文件中的一个条目)将源/javadoc 与 JAR 文件相关联,但不会将本地依赖项引入存储库通过 .classpath.理想情况下我会 lib_src_dir =/my/path/to/lib/src 在local.pr ..
发布时间:2021-11-25 20:10:29 Java Web开发

如何从 JavaDoc 生成 PDF(包括概述和包摘要)

我已经为我的应用程序编写了大量 JavaDoc 文档,并在 overview.html 和 package.html 文件中添加了许多有用的信息(包括前者的插图链接在 doc-files/ 中).Maven 的 Javadoc 插件很好地使用了标准的 javadoc 工具来生成经典的 JavaDoc 框架集,但现在我需要生成包含整个文档的 PDF. AurigaDoclet 生成非常漂亮的 ..
发布时间:2021-11-22 17:11:12 Java Web开发

Javadoc 是否有等价于 <![CDATA[ ... ]]>?

不幸的是,HTML 中没有 CDATA. 这很遗憾,因为它非常适合添加包含 XML 的 javadoc 注释,因此您不必转义 ,例如: /**]]>*/ 但是,javadoc 可以识别 CDATA 部分,并将其转换为 HTML.例如: 这会解析 或者它可以使用一些比 CDATA 更​​简单的语法.因为 javadoc 是可扩展 ..
发布时间:2021-11-22 17:11:06 Java Web开发

JavaDoc 样式表

我在想. 你们中有人有 JavaDoc 样式表吗?默认的很丑. 谢谢! 解决方案 红黑一色: http://blog.applegrew.com/2008/05/get-my-javadoc-stylesheet-red-n-black-theme/ 您可能还想看看 doclet.com. ..
发布时间:2021-11-22 17:10:58 Java Web开发

为什么 Double.valueof javadoc 说它缓存值,但它没有缓存?

在 OpenJDK 中,对于方法: public static Double valueOf(double d) javadoc 说: 返回表示指定双精度值的 Double 实例.如果不需要新的 Double 实例,则通常应优先使用此方法而不是构造函数 Double(double),因为此方法通过缓存频繁请求的值可能会显着提高空间和时间性能. 实际代码如下: public sta ..
发布时间:2021-11-22 17:10:46 Java Web开发

Javadoc 链接到另一个包中的类

我有两个包,Shapes 和 Fruits: com.myproject.Shapes.圆圈正方形三角形com.myproject.Fruits.苹果橘子 我正在为 Apple 编写 JavaDoc,需要向 Square 提供一个 {@link}. 我已经尝试了以下所有方法,但都没有奏效: {@link Square}{@link com.myproject.Square} 我已经能 ..
发布时间:2021-11-22 17:10:36 Java Web开发

无法找到 javadoc 命令 - maven

我在我的项目目录中运行这个命令来构建和打包它: mvn clean javadoc:jar 包 我的 JAVA_HOME 变量设置正确.显然: $ which java/usr/bin/java$ sudo ls -l/usr/bin/javalrwxr-xr-x 1 根轮 74 Dec 18 23:42/usr/bin/java ->/System/Library/Frameworks/J ..
发布时间:2021-11-22 17:10:28 Java Web开发

JDK8:找回 JDK7 寻找 javadoc

与 JDK7 相比,我发现很难阅读 JDK8 javadoc 中的新外观.这是一个并排示例. JDK7: JDK8: JDK8 占用更多空间.它现在使用之前使用 Arial 的 DejaVu 字体.这可能有很好的理由.我不知道. 我最大的问题是“参数"和“投掷"参数与其描述之间不再有任何视觉差异的部分.它们都是单间距字体.我认为,用单行距字体编写描述性文本很难看.等距字体用 ..
发布时间:2021-11-22 17:10:17 Java Web开发

在 javadocs 中包含图像

我处理了许多可视化的示例测试用例.有什么方便的方法可以将它们包含在我的 Java 源代码中并将它们链接到 Javadocs 中,这样我的 IDE 就可以在编码时自动显示它们(通过在我的 IDE 中调用 javadoc 渲染器功能?) 我尝试在 Java 源代码旁边放置一个图像并使用 ,但它没有用(我使用了 png). (注意 - 在这种情况下它在我的测试源中) 解决方案 ..
发布时间:2021-11-22 17:10:08 Java Web开发

Intellij 为方法和类生成 javadoc

是否可以将 Intellij 设置为使用 @author 和 @since date 自动生成方法和类的 javadoc? 我在 Eclipse 中有这个功能. 我知道,这些文件有模板,而且我可以手动半自动地将 javadoc 添加到选定的方法/类.但我希望为每个生成的方法/类/枚举/接口/字段等自动生成 这对于例如很有用“提取方法"、“覆盖/实现"、“创建 getter/setter"等 ..
发布时间:2021-11-22 17:09:57 Java Web开发

如何在 javadoc 中生成指向 android 类引用的链接?

当我在 Eclipse 中为我的 Android 项目生成 javadoc 时,有很多警告,比如 找不到符号符号:类 TextView 和 warning - Tag @see:找不到参考:android.app.Dialog 我也试过 -link http://developer.android.com/reference/- 链接 http://java.sun.com/j2se/1 ..
发布时间:2021-11-22 17:09:48 Java Web开发

javadoc:@version 和@since

是否有理由将 @version 和 @since 作为类的一部分包含在内? 它们似乎是相互排斥的. 另外,%I% 和 %G% 是什么意思,如何设置/使用它们? @version %I%, %G% 解决方案 @version 标签应该是相关发行版或文件的当前版本.%I%、%G% 语法是源代码控制软件将替换为文件的当前版本和文件签出日期的宏. @since 标签应该用于定义你 ..
发布时间:2021-11-22 17:09:40 Java Web开发

Android Studio:悬停时 Javadoc 为空

我最近从 Eclipse 转移到了 Android Studio,并且很喜欢它.但是,我想念 Eclipse 的悬停功能的 Javadoc. 我按照此处的说明添加功能,但是,我的悬停不包含 Javadoc.如果我使用文档快捷方式 Ctrl + Shift + Space 它将正确显示文档,但是,我真的希望它出现在工具提示. 下面是我看到的截图.很明显,这个方法应该有一个 Javadoc ..
发布时间:2021-11-22 17:09:31 Java Web开发

有什么方法可以在 Eclipse 中自动生成所有 Javadoc 注释?

我知道你可以按 shift+alt+j 为当前代码块插入一个合适的注释模板,但是有没有什么办法让 eclipse 发疯并像这样做一个完整的项目? 解决方案 对于整个项目,可能不是,但你至少可以: 转到包资源管理器视图 展开你想要生成评论的类(打开每个方法) 从包资源管理器树中选择类中所有打开的元素 alt+shift+J 和瞧:在类和每个方法上生成的注释 不适合所有项目的 ..
发布时间:2021-11-22 17:09:23 Java Web开发

Netbeans:如何更改@author

在 Netbeans IDE 中创建新类或接口时,会出现“@author ...."标记.如何改变它的价值?如果可能,我想通过使用 Netbeans 菜单而不是通过编辑一些配置文件来更改它:) 我使用的是 Netbeans 7.2 解决方案 步骤: 转到工具 -> 模板. 点击设置按钮.IDE 中将出现一个带有模板设置的新面板: 取消对最后一行的注释并将“user"的值更 ..
发布时间:2021-11-22 17:09:14 Java Web开发

如何在javadoc中添加对方法参数的引用?

有没有办法从方法文档正文中添加对一个或多个方法参数的引用?类似的东西: /*** 当 {@paramref a} 为空时,我们依赖 b 进行解调.** @param a 这是参数之一* @param b 另一个参数*/void foo(String a, int b){...} 解决方案 据我所知 javadoc 的文档 没有这样的功能. 不要像其他答案中推荐的那样使用 foo;你可以 ..
发布时间:2021-11-22 17:09:05 Java Web开发

Javadoc 的好例子

是否有一个很好的源文件示例,其中包含Javadoc? 我可以在互联网上找到很多很好的 Javadoc 示例,我只想找出用于创建它们的特定语法,并假设我可以在某处仔细阅读某个库的源代码,但这似乎很多工作. 解决方案 JDK 源代码怎么样,但是通过像 docjar 这样的 3rd 方访问?例如,集合源. 这样,就没有大的下载. ..
发布时间:2021-11-22 17:08:56 Java Web开发

当android库具有也是aar库的依赖项时,如何为它生成javadoc?

我有一个 android 库项目,它依赖于其他 android 库项目.我需要为库生成 javadoc,但它失败了,因为 gradle 将 javadoc 类路径放在 .aar 位置,但 javadoc 需要 .jar 文件. 简化的gradle文件: android {compileSdkVersion 23构建工具版本“23.0.2"配置{文档}默认配置{minSdk 版本 7目标SD ..
发布时间:2021-11-22 17:08:47 Java Web开发

是否“/*(非 javadoc)"有一个很好理解的意思吗?

/* (non-javadoc) 除了向源代码的读者指出注释块故意不是 Javadoc 注释之外,是否还有意义?最近我看到很多这样的代码: /**(非javadoc)** 此方法将小部件转换为小玩意*/公共 Foo bar() {... 这是某种既定的惯例吗?如果是,它是什么意思(超出明显的字面意思)以及何时使用? 解决方案 根据 我能找到的信息,这是为了修复旧版本的 JavaDoc ..
发布时间:2021-11-22 17:08:40 Java Web开发