假设我有两个类:abstractclassGenericA{publicvoidgo(Ee){...}}publicclassIntegerAextendsGenericA{}请注意,GenericA是包私有(private)的和通用的,而IntegerA是公共(public)的而不是通用的。现在,当我生成公共(public)Javadoc(使用Eclipse)时,我在IntegerA方法部分看到以下内容:publicvoidgo(Ee)问题是Javadoc的读者不知道E是什么;即,E代表Integer。我宁愿让Javadoc说publicvoidgo(Integere)有没有办法让J
是否有将新功能引入Javadoc规范的版本控制流程?我的问题受到看似新标签的启发:出现在Java8源文档中的@apiNote、@implSpec和@implNote。I'mawarethatthesetagsarenotstandardandsubjecttochange--如果Java之神决定这些标记在新版本的Javadoc中是标准的,那么开发人员可以在哪里找到这些信息?我读过Oracle文档引用从1.1开始到1.4结束的Javadoc版本,这可能让人相信每个Java版本都有一个新的Javadoc版本,但我不能找到任何证据来支持这一假设。我找到的与Javadoc规范/最佳实践/接受标
我已经指定了我在项目中使用的库文档的URL,每次我想查看文档时,它都会从互联网上下载。我在本地有一个包含完整JavaDoc的JAR。我应该指定这个JAR文件,还是强制IDEA下载所有文档? 最佳答案 Attachthejarfile与图书馆的文件。 关于java-如何强制IntellijIDEA下载JavaDoc,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.com/questions/9381971/
我正在开发一个pt_BR项目,该项目提供最终用户API以扩展功能。我需要生成此类的javadoc(在Java中),但是,当使用javadoc.exe时,输出文档的静态文本(而不是内容)是英文的。因此,我想在pt_BR中生成文档。我试过这样使用:javadoc-localept_BR-sourcepathscr-dc:\TEMP但是没有用。注意:为了清楚起见,我无意翻译内容(已经在pt_BR中),而是翻译静态文本(导航栏、标题等)。我该怎么做? 最佳答案 我们必须在我们的项目中这样做。这就是我们所做的:首先,我们从Java的tools
Javadoc似乎只处理声明引用字段的类上的@value标记,并且只处理没有类名的引用。示例:我有课/**{@value#F}*/publicclassA{publicstaticfinalStringF="field";}和/**{@valueA#F}*/publicclassB{}jdk1.7javadoc工具处理A上的@value标记,但对于B我收到以下警告:warning-A#F(referencedby@valuetag)isanunknownreference.当我尝试使用A#F引用A的javadoc中的字段时,也会出现此警告。当我使用@link标签时,一切都按预期工作。我
我有一个注解处理器,它在构建时由Java编译器自动获取(使用SPI)。在gradle构建期间,此注释处理器生成的java源代码被放入build/classes中,因为Gradle告诉注释处理器这是输出生成的源文件的地方。当运行标准javadoc任务时,它会尝试为构建/类中的所有文件创建javadoc,包括*.java。这会失败,因为javadoc只需要*.class文件,导致整个构建失败。所以我的问题是:这是Gradle错误/功能吗?我该如何修复它/让它发挥作用? 最佳答案 问题似乎是没有提取生成的源文件,导致javadoc失败,因
我在使用EclipseIDE的Java中使用OpenCV3.0,但我想将Javadoc附加到OpenCVjar,以便轻松阅读方法和参数的用法。在我使用OpenCV2.4.10之前,它有很好的源代码文档,并且很容易了解方法和参数。但是现在OpenCV3源代码中没有任何文档工具。如果有人知道这件事,请告诉我如何附加OpenCV3.0的Javadoc。提前致谢! 最佳答案 现在OpenCV3.0的javadoc也可用。http://docs.opencv.org/java/3.0.0/试试这个网址!
我的一些同事缺乏纪律,并不总是写他们类(class)的文档(不总是=从不)。我试图通过为缺少注释javadoc设置项目警告来强制他们编写文档。我们有两个源文件夹'src'和'tests'-显然不是所有的@Test方法都需要文档并且这个警告是多余的。但是现在所有未记录的测试都收到了这些烦人的警告,该项目收到了数百条警告,我担心会错过一些真正危险的警告(因为有数百条无用的警告)。如何只对'src'文件夹设置警告,而忽略'tests'文件夹的警告? 最佳答案 恐怕没有设置可以严格针对测试类/方法禁用缺少的javadoc验证。甚至在Ecli
我正在尝试为我的客户端库创建javadoc。在MyOtherClass中,我将@see放在下面,并收到警告。MyOtherClass和MyClass都在同一个项目的不同包中。@seeMyClass#Constructor(Type1param1,Type2param2)warning-Tag@see:referencenotfound:MyClass#Constructor(Type1param1,Type2param2)然后我试了一下@seeMyClass#MyClass(Type1param1,Type2param2)warning-Tag@see:referencenotfoun
每当我在intelliJ中输入“Printing”并按下CTRLQ时,我只能看到“Summary”而看不到“Bob”。..我做错了什么?packageprinting;/***@authorBob*Summary*/publicclassPrinter{//stuff}***注意:我只是在学习如何使用“javadoc”,所以我希望得到解释。编辑:除非我取出“@author”,否则我什至看不到“摘要” 最佳答案 听起来像是IntelliJ的问题/功能。Eclipse显示整个javadoc,包括@author.其他可能的问题是存在Sum