谁负责JavaDoc工具的文档和实现?

时间:2018-12-27 19:35:48

标签: java javadoc maven-javadoc-plugin

此问题与为Maven提出的问题有关,该问题似乎并未转义转发到Windows上JavaDoc-tool支持的参数文件的路径。问题在于,从JavaDoc本身的文档尚不清楚,应该如何在这些文件中提供Windows下的路径。

以下内容适用于Java 7:

  

如果文件名包含嵌入的空格,请将整个文件名放在双引号中,然后将每个反斜杠(“ My Files \ Stuff.java”)加倍。

https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#argumentfiles

Java 8中的以下内容:

  

如果文件名包含嵌入式空格,则将整个文件名放在双引号中。

https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html

在Java 11文档中,该部分完全丢失了,不再提及引号,空格或反斜杠:

https://docs.oracle.com/en/java/javase/11/javadoc/javadoc-command.html#GUID-EFE927BC-DB00-4876-808C-ED23E1AAEF7D

如果您查看URI,则在Java的早期版本中,它们是Windows特定的,而最后一个则不是。因此,我想事情已经重构了,参数文件的一些细节已经丢失了。

因此,我需要一个地方,可以与人们讨论文档中的差异以及最终在Windows上应该如何工作。如果反斜杠仅是路径和所有其他内容中的转义字符。我只是想从可能知道为什么文档现在缺少某些细节甚至可能再次提供这些细节的人那里获得一些了解。

那我应该写给谁/哪里?我不知道这是Oracle还是OpenJDK项目,还是完全不同的人。谢谢!

2 个答案:

答案 0 :(得分:0)

我认为最好的两个地方是javadoc-dev mailinglistbugs database。从某个时间点开始(我猜应该是9),已经统一了跨工具对@files的解析。上次我在Mercurial存储库中找不到代码。

答案 1 :(得分:0)

我认为,但请不要过于专断,那就是javadoc工具只是一种可选的工具(任何人都可以表现出任何JDK都包含Javadoc工具实现的正式义务吗?)原始所有者Sun从那里制定的标准Oracle。

但是事实上只是事实。从形式上和严格意义上讲,没有JDK实现者有义务使其Javadoc工具的行为与其他工具一样。

相关问题