javadoc相关内容

如何在JavaDoc中显示示例代码,而无需手动复制/粘贴?

我需要在我的库的JavaDoc文档中直接显示我的示例代码,包括其输出。但是我想自动化此过程,因此示例代码可以通过外部进程进行单元测试,除非实际工作,否则不显示 。 我还没有想到这样做,除非手动复制粘贴源代码(和输出)每次进行更改 - 这是无法管理的,因为现在已经有超过一百个示例类在我的各种项目。或者,我可以简单地不显示这些示例,而是提供一个链接。 这两个解决方案都是不可接受的,我希望可 ..
发布时间:2017-06-15 22:38:26 Java开发

如果超类有文档,请忽略丢失的文档

有没有办法告诉SonarQube,如果覆盖的方法被记录在案,不要将重要的方法计入公开记录的api统计数据?由于以下情况,SonarQube发现许多缺少注释的方法。 $ b $我知道有一个注释忽略了SonarQube的某些规则,但是我们不想为我们的项目添加代码,以满足SonarQube。 解决方案 您可以使用继承文档。 / ** * {@ inheritDoc} * / ..
发布时间:2017-06-15 22:31:40 Java开发

如何分析javadoc?

我正在使用Java来读取javadoc。 我的java对象有属性 描述 包名称 方法名称,方法说明 是否有任何现有的api可以做到这一点? 如何读取javadoc,以便我可以提取上述属性? 解决方案 a href =“http://download.oracle.com/javase/6/docs/technotes/guides/javadoc/index.html” ..
发布时间:2017-06-15 22:19:49 Java开发

用于普通lisp的Man或javadoc样式文档

是否有任何类似的常见的lisp文档,如javadoc,man甚至类似智能感的弹出窗口?我刚刚开始学习常用的lisp,没有足够的手记忆。 我使用emacs和粘液 - 它有标签完成,但似乎不是很丰富。 谢谢! 解决方案 如果这个问题是为了询问参考文献 - 在线可以有几个Hyperspec。如果您在Google上搜索“hyperspec功能名称”,那么您很有可能会在其中一个登陆。 ..
发布时间:2017-06-15 22:08:13 其他开发

开源工具通过Maven2生成Javadoc,使用自动UML图如ydoc

我想通过maven的站点生成插件生成javadoc,我想要在javadoc中创建并嵌入自动的UML图。 statsvn 项目使用 yDoc 生成他们的UML文档,但我认为他们使用的是Maven1。 yDoc是一个商业共享软件产品,所以我不确定开源的statsvn项目如何与它集成(或者如果有一个免费版本用于javadoc生成)。 示例svnstat yDoc javadoc: Chur ..
发布时间:2017-06-15 22:02:46 Java开发

CODE Delphi的文档创建工具

可能重复: 类似于javadoc或c#xml doc的delphi的代码文档 我想开始记录一个非常大的Delphi应用程序,目前它没有任何文档。我的同事建议使用javadoc类型的文档样式,因为我们可以运行一个自动化程序来创建可搜索和漂亮的漂亮文档。 (*功能描述 @param S某些字符串 @param索引字符串索引s @retval TRUE条件是真的 @retva ..
发布时间:2017-06-15 21:38:58 其他开发

如何使用JDK 7的旧的javadoc样式/主题?

对于javadoc,JDK 7中的新主题很难让我阅读。它可能不漂亮,但我真的会喜欢旧的主题。除了安装旧的JDK并在他们之间切换,我可以用某种方式使用旧的doclet吗? 解决方案 不得不承认我没有t经历了这个,但是我发现你可以自定义java文档的CSS。 这里是说明。 您可能有兴趣运行此操作: C:> javadoc -stylesheetfile C:\user\examp ..
发布时间:2017-06-15 21:25:58 Java开发

Clojure文档工具的最新技术

在过去的一年左右,我看到了关于Clojure讨论列表和其他地方关于Clojure代码记录工具的各种公告。这些范围包括像Marginalia这样的全面的识字编程系统,用于创建“Clojure in Small Pieces”(甚至是emacs组织模式)的工具,更为传统的Javadoc样式的解决方案,如Autodoc和Javadoc本身据报道可以与Clojure一起使用。谷歌搜索会产生不同的其他人,也 ..

如何在Javadoc中添加包级注释?

我正在使用Check-Style,FindBugs和PMD来验证我的Java代码。我已经修复了几乎所有这些工具捕获的错误。 我无法理解如何编写“package comment”,这是checkstyle捕获的错误。我已经阅读了Check-Style的文档,但我不明白。 有人可以帮我在Java中编写包级别的评论吗? 解决方案 包级javadoc注释放在名为的文件中package- ..
发布时间:2017-06-15 21:14:01 Java开发

Javadocs链接到外部javadoc

我正在生成Javadoc。现在我想自动将所有的库和JDK类链接到该lib或JDK的官方文档。这是可能的,如果是这样,哪个命令行参考我需要 解决方案 解决对标准Java类的引用需要你有Java文档的本地副本。 JDK 7 JavaDocs可用这里附加资源 然后运行javadoc,使用 -link 选项。 它需要您要引用的文档的URL(例如, http: //docs.oracl ..
发布时间:2017-06-15 20:59:29 Java开发

Javadoc像C#的XML注释的文档

我正在寻找一些可以将我的C#XML注释变成文档的东西。我不喜欢CHM,也不喜欢MSDN的外观和感觉。我喜欢使用javadocs。它们很容易导航,一切都可以访问。我正在寻找一个工具,我可以用来将我的代码中的注释转换成像javadoc一样的外观和感觉。 有没有什么可以做到这一点?我已经尝试过Sandcastle,它是各种GUI,但是它们不会做我想要的。 解决方案 Doxygen 也许? ..
发布时间:2017-06-15 20:57:01 C#/.NET

javadoc:@version和@since

有没有理由将 @version和@since 同时包含在一起? 他们似乎是相互排斥的。 另外,%I%和%G%是什么意思,以及如何设置/使用它们? @version%I%,%G% / pre> 谢谢 解决方案 @version 标签应该是当前版本的发行版或文件。 %I%,%G%语法是源控制软件将替换当前版本的文件和文件检出日期。 应该使用 @s ..
发布时间:2017-06-15 20:42:58 Java开发

Javadoc模板生成器

我有一个没有Javadoc的大代码库,我想运行一个程序来写一个基本的Javadoc信息的框架(例如,对于每个方法的参数写@param ...),所以我只需要填补空白 任何人都知道一个很好的解决方案? 编辑: / p> JAutodoc是我正在寻找的。它有Ant任务,一个Eclipse插件,并使用Velocity进行模板定义。 解决方案 JAVAtooc eclipse的插 ..
发布时间:2017-06-15 20:17:22 Java开发

有没有一些好的和现代的替代品Javadoc?

让我们面对它:你不需要设计师看到 默认值 Javadoc看起来很丑陋。 网络上有一些资源提供重新设计的Javadoc。但是默认行为代表了产品,应该是相当好看的。 另一个问题是Javadoc的可用性不及时更新其他类似的资源。 特别是巨大的项目很难使用Firefox的快速搜索导航。 实用问题: 是否有任何独立(桌面)应用程序能够以比浏览器更可用的方式浏览 现有的Jav ..
发布时间:2017-06-15 20:14:25 Java开发

如何将Java API文档添加到Eclipse?

我已经从 http:// www .oracle.com / technetwork / java / javase / downloads / index.html#docs ,并据此将其附加到Eclipse使用 窗口 - >首选项 - > Java->安装 JREs->编辑 - >“选择rt.jar” - > Javadoc 位置 该位置已被接受,“验证”就可以了。然而,对于我 ..
发布时间:2017-06-15 20:13:46 Java开发

使用javadoc进行Python文档

我目前从Python开始,我有一个强大的PHP背景,在PHP中我习惯了使用 javadoc 作为文档模板。 我想知道如果 javadoc 在Python中具有 docstring 文档的位置。这样的东西太复杂了,以适应Python的心态,还是应该尽可能的简洁一些? “”“ 用值替换模板占位符 @param string timestamp格式化日期显示 @param stri ..
发布时间:2017-06-15 20:10:19 Python