单行上的 Javadoc 多个变量

Question

我有一个像下面这样的类......

class A{

/**
 * Blah blah
 */
 Type1 var;

/**
 * What do I do here?
 */
 Type2 var11, var12;

}

如果 var11 和 var12 在同一行，我如何编写 javadoc？

我很想知道这是否可行，我知道我可以将它们放在单独的行中并从那里放置 javadoc。

Answer 1

我很好奇就试了一下

/**
 * data stuff
 */
 int x , y ;

生成的 javadoc 对 x 和 y 重复相同的文档注释。 我想如果两个字段本质上相同，只有细微差别，这种行为会很有用。

class Circle
{
    ....
    /**
     * center coordinates
     * The x/y coordinate of the center of this circle.
     */
     int x , y ;