【问题标题】:Javadocs specifying issue numberJavadocs 指定问题编号
【发布时间】:2012-09-16 17:12:28
【问题描述】:

我遇到了一个问题,想更改我的 java 代码中的功能,例如 #41241 问题编号。

指定问题编号的正确 Javadoc 注释是什么,要求进行此更改?

只是将来我知道,为什么某个函数或行被更改/创建?

【问题讨论】:

  • 恕我直言,这取决于票务/错误跟踪系统。我通常会像 /** changed xyz for issue #123 *//** as described in issue AB01-345, this needs to be changed to ... */ 这样的 cmets 在 Mylyn 的帮助下,这非常好,因为您可以直接跳转到跟踪系统中的相应问题。
  • 谨防将错误编号放入源代码 cmets。这就是源代码控制系统的用途。在您添加此类评论后的 6 个月左右,它变得完全无用并且使代码变得模糊。

标签: java comments javadoc issue-tracking


【解决方案1】:

我不会将问题编号写入源代码。当由于多个问题而更改方法时,这可能会变得复杂......

我曾经将问题编号添加到 SVN 提交中,例如:ISSUE-1234: added NPE check。 Eclipse 提供了有用的功能Team -> Show Annotations,它显示了 SVN 提交的每一行更改以及提交注释。在我看来,这增加了作为 JavaDoc 中的注释的更多好处。

【讨论】:

    猜你喜欢
    • 2020-03-12
    • 2012-10-14
    • 1970-01-01
    • 1970-01-01
    • 2019-04-13
    • 2020-03-17
    • 1970-01-01
    • 2010-11-28
    • 1970-01-01
    相关资源
    最近更新 更多