是否可以在右侧而不是顶部创建文档注释?

Question

文档有时会降低代码的可读性。不是

/**
 * The X axis.
 */
int x;
/**
 * The Y axis.
 */
int y;
/**
 * The Z axis.
 */
int z;

我宁愿有

int x; /** The X axis */
int y; /** The Y axis */
int z; /** The Z axis */

是否有一种方法在Java有评论的权利，例如一个变量声明?我在C中使用"<"字符看到过它的工作，但还没有在Java中看到过。Java已经是版本8了，我想知道为什么它仍然不可能。是吗?

Answer 1

文档注释只能工作一次。它们可以出现在代码中的任何地方，而且可以出现很多次，但只有第一个是由Javadoc工具提取的。