开发者

How can I generate Javadoc comments in Eclipse? [duplicate]

开发者 https://www.devze.com 2022-12-12 07:41 出处:网络
This question already has 开发者_开发技巧answers here: Javadoc template generator [closed] (6 answers)
This question already has 开发者_开发技巧answers here: Javadoc template generator [closed] (6 answers) Closed 2 years ago.

Is there a way to generate Javadoc comments in Eclipse? If so, what is it?


For me the /**<NEWLINE> or Shift-Alt-J (or --J on a Mac) approach works best.

I dislike seeing Javadoc comments in source code that have been auto-generated and have not been updated with real content. As far as I am concerned, such javadocs are nothing more than a waste of screen space.

IMO, it is much much better to generate the Javadoc comment skeletons one by one as you are about to fill in the details.


Shift-Alt-J is a useful keyboard shortcut in Eclipse for creating Javadoc comment templates.

Invoking the shortcut on a class, method or field declaration will create a Javadoc template:

public int doAction(int i) {
    return i;
}

Pressing Shift-Alt-J on the method declaration gives:

/**
 * @param i
 * @return
 */
public int doAction(int i) {
    return i;
}


JAutoDoc:

an Eclipse Plugin for automatically adding Javadoc and file headers to your source code. It optionally generates initial comments from element name by using Velocity templates for Javadoc and file headers...


You mean menu Project -> Generate Javadoc ?


At a place where you want javadoc, type in /**<NEWLINE> and it will create the template.

0

精彩评论

暂无评论...
验证码 换一张
取 消

关注公众号