【问题标题】:Disabling javadoc formatting for > < [duplicate]禁用 > < [重复] 的 javadoc 格式
【发布时间】:2019-01-13 02:02:14
【问题描述】:

好的,this 线程中的所有建议都有效,但在代码文件中可读性不强。有没有办法禁用默认的 javadoc 格式,只写x&gt;1 没有问题?

【问题讨论】:

  • 该链接列出所有可能性。您本质上是在再次问同样的问题,这样做没有任何意义。如果 人类可读性 是您的主要关注点,那么在 javadoc 中引入一个支持 markdown 的框架,然后继续。
  • 我问这个问题是因为列出的建议都不适合我。
  • 我明白了。但是你为什么期望你在这里得到的答案会有所不同。 IT 业务是关于平衡您的偏好与技术所提供的内容。有时你只是让步。你同意你的队友你想要什么格式,然后每个人都遵循它。几周后,每个人都习惯了。如前所述:当人类可读的 javadoc 对您如此重要时,请包含一个降价处理器。
  • 是的,实际上我的团队不同意这些格式中的任何一种,所以你有它。我希望也许会有不同的方式。

标签: java maven formatting javadoc maven-javadoc-plugin


【解决方案1】:

我猜 javadoc 的主要目标是让类、方法、函数和过程的客户不用查看源文件。

所以我建议将&amp;lt; 用于&gt; 用于>,正如您相关帖子的公认答案所告诉的那样。

【讨论】:

    猜你喜欢
    • 2012-08-14
    • 2017-03-17
    • 2014-12-11
    • 2014-05-31
    • 1970-01-01
    • 1970-01-01
    • 2012-04-19
    • 2011-07-07
    • 2017-01-29
    相关资源
    最近更新 更多