【问题标题】:Question about comment line in java(eclipse)关于java(eclipse)中注释行的问题
【发布时间】:2011-03-30 09:58:33
【问题描述】:

这有什么区别

/**
 * comment goes here (notice the extra '*' in previous line)
 */

还有这个?

/*
 * comment goes here (notice the extra '*' is not present in previous line)
 */

因为我注意到在 Eclipse 中这两种评论风格有不同的颜色。 第一个得到蓝色,第二个得到绿色

这两种评论风格有什么区别吗?

【问题讨论】:

  • 再来一个查询,这个convetion是通用的还是eclipse特有的?

标签: java eclipse comments


【解决方案1】:

第一种样式是Javadoc 注释,可用于生成各种文档格式。 Eclipse 将使用这些为文档项生成工具提示和自动完成文档。

更多详情see the documentation

【讨论】:

    【解决方案2】:

    第一个变体用于编写 Java-doc cmets。第二个是Java中的简单多行注释。

    【讨论】:

      【解决方案3】:

      /**开头的cmets由JavaDoc处理。

      【讨论】:

        【解决方案4】:

        /**注释用于生成Javadoc

        /* 是简单的 cmets

        【讨论】:

          【解决方案5】:

          蓝色部分与 Eclipse 的 Java 文档生成器兼容。

          【讨论】:

            【解决方案6】:

            我认为这是将人类生成的与自动生成的区别开来。

            例如:当你使用重构选项来实现一个接口时,顶部的 cmets 将与第一个 cmets 相比为绿色。这只是一个日食约定

            【讨论】:

            • 不。不是这个。 Eclipse 无法知道注释是手动创建的还是自动创建的。
            • 当然它不知道。但是它生成的 cmets,比如用于文档的 cmets,总是绿色的。这就是我的意思,这就像为自动生成的对象添加额外的 * 一样。
            猜你喜欢
            • 1970-01-01
            • 1970-01-01
            • 2010-11-20
            • 1970-01-01
            • 1970-01-01
            • 1970-01-01
            • 2023-04-04
            • 2015-09-29
            • 1970-01-01
            相关资源
            最近更新 更多