Java文档中的"unascribed author"是什么意思?

10

一些Java类,如Object在Java文档中定义@author未署名

 * @author  unascribed
 * @see     java.lang.Class
 * @since   JDK1.0
 */
public class Object {

我发现当 作者不知道时可以使用它。

如果作者未知,请将“unascribed”用作 @author 的参数。

并且发现一个 JDK 非问题,在没有定义作者时使用该术语

许多反射类未标注作者

许多新的API没有 @author 标记。

那么 unascribed 基本上相当于 Java 中的“John Doe” /“Jane Doe”?


1
“未指定”可能看起来更好。 - Arnaud
是的,尽管在某些法律背景下,“Jane/John Doe”这些术语可能具有略微不同的含义,但其基本意图基本相同 - 表示作者未知,就像您所理解的那样。 - jpw
@jpw 看起来我们更希望是匿名的,而不是不知道谁写了这段代码。 - user7294900
@user7294900 可能是这样,但真的很难确定意图 - 可能是为了隐藏作者,但也可能是原始作者确实不知道。无论如何,这有关紧要吗? - jpw
3
最终,针对所有Javadoc标签而言,"author"标签是最不实用的。 - GhostCat
1个回答

7
当然,最基本的不指定某个类的作者的方法就是不指定作者,即不写@author标记。
定义一个"无作者"的东西来表示未记录作者已经多余了,而且(对我来说)有点奇怪。

1
也许是为了保持给所有类添加作者的惯例而添加的? - user7294900
3
可能没有人愿意承认自己写了这门课程,或者更有可能是一个团队的努力,不能将其归因于少数几位作者。 - Peter Lawrey

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接