【问题标题】:Eclipse how to refactor Javadoc source comment?Eclipse如何重构Javadoc源码注释?
【发布时间】:2011-11-16 20:30:50
【问题描述】:

在对方法进行一些更改后,我发现必须在方法调用之前立即手动重构 Javadoc 源注释非常烦人。有没有办法让 Eclipse 自动为您执行此操作?

【问题讨论】:

  • 我想知道你是如何重构非代码的东西的。更严肃的一点是:您希望自动执行的“某些更改”具体是什么意思?
  • 假设我删除或添加参数..或更改返回类型..不难想象您可以对认为 javadoc“过时”并需要的方法进行哪些更改被“重构”..
  • ...虽然很难想象 eclipse 可以自动编写有意义的注释的变化。当然,eclipse 可以为新参数添加一个占位符,但程序员仍然需要自己编写描述。
  • 您也可能有其他想法而不是签名更改,最好要求澄清而不是做出假设。 (作为推论,最好一开始就清楚,而不是期望人们在想你在想什么。)

标签: java android eclipse refactoring javadoc


【解决方案1】:

我认为让 eclipse 根据您在方法签名中所做的更改自动更新您的 Java Doc 的唯一方法是从 eclipse 自己的菜单功能中进行更改:

Refactor ---> Change Method Signature 

如果您从此处更改方法签名,您将自动更新 JAvadoc 注释,否则您必须删除整个 javadoc 注释并重新创建它:

/** + <HIT ENTER>  

【讨论】:

    【解决方案2】:

    此外,再次按 Alt-Shift-J 将重新生成 javadocs。这就是我通常的做法。

    【讨论】:

      【解决方案3】:

      适用于 Eclipse 的 Google CodePro Analytix 插件将为您提供do that

      【讨论】:

        猜你喜欢
        • 2015-07-15
        • 2014-12-11
        • 2010-12-19
        • 2011-02-15
        • 1970-01-01
        • 2014-02-11
        • 2015-11-02
        • 2012-05-30
        • 2012-09-16
        相关资源
        最近更新 更多