黑马程序员技术交流社区

标题: 一个关于注释的问题，请各位帮忙看看，谢谢！ [打印本页]

作者: 海纳百川1123 时间: 2015-7-5 21:59
标题: 一个关于注释的问题，请各位帮忙看看，谢谢！
本帖最后由海纳百川1123 于 2015-7-23 09:40 编辑

在类以上的应该是文档注释/** */，怎么老师视频中用的多行注释/* */呢?

捕获.PNG (168.32 KB, 下载次数: 37)

作者: 刘贤俊 时间: 2015-7-5 22:19
文档注释介绍你自己所写的程序的功能、所写函数或方法的作用是什么等而老师的多行注释则是教你如何写一个程序。

作者: xuhao3622603 时间: 2015-7-5 22:21
还是百度一下吧

作者: 海纳百川1123 时间: 2015-7-6 09:26

刘贤俊发表于 2015-7-5 22:19
文档注释介绍你自己所写的程序的功能、所写函数或方法的作用是什么等而老师的多行注释则是教你如何写一个 ...

意思是多行注释的位置在那都可以么，而文档注释必须写在最前面？

作者: 海纳百川1123 时间: 2015-7-7 09:39
还有人知道这个怎么回事么，帮我解释解释

作者: 帅帅loyal 时间: 2015-7-7 09:56
多行注释不会被虚拟机识别，就和单行注释一样，你写在哪里都可以的

作者: 海纳百川1123 时间: 2015-7-7 10:16

帅帅loyal 发表于 2015-7-7 09:56
多行注释不会被虚拟机识别，就和单行注释一样，你写在哪里都可以的

谢谢帅前辈

作者: 为了理想而奋斗 时间: 2015-7-7 12:26
同六楼回答

作者: firwood 时间: 2015-7-7 12:50
文档注释可以编译出程序配套的说明文档，实现文档与代码结合在同一个文件中，便于同步修改。
多行注释不会被编译出说明文档，和单行注释作用差不多，只不过不必须每行都做标记。

作者: 海纳百川1123 时间: 2015-7-7 13:52

firwood 发表于 2015-7-7 12:50
文档注释可以编译出程序配套的说明文档，实现文档与代码结合在同一个文件中，便于同步修改。
多行注释不会 ...

了解了，谢谢！

作者: 小丑 时间: 2015-7-7 14:55
老师写的没有问题，多行注释和单行注释一样。只不过注释多的文字比较方便。

作者: wh121 时间: 2015-7-7 15:11
我觉得你的出发点是没错的，但是我们更应该重视文档注释和多行注释的具体功能。在文档注释内容例：@version 标明该类模块的版本、@author 标明开发该类模块的作者等主要用来解说模块是谁开发的、什么时候开发的等等。多行注释主要是解说你开发的具体代码的。老师做的是对的可能只是不规范而已

作者: CLTDEZHUCE 时间: 2015-7-7 21:33
功能有不同，文档注释生成api

作者: 海纳百川1123 时间: 2015-7-8 09:50

wh121 发表于 2015-7-7 15:11
我觉得你的出发点是没错的，但是我们更应该重视文档注释和多行注释的具体功能。在文档注释内容例：@version ...

了解了，谢谢！

作者: 慕容旺财 时间: 2015-7-8 10:02
/** */是用于帮助文档的制作的普通自己看看的话就用/* */就好

作者: 海纳百川1123 时间: 2015-7-8 10:05

慕容旺财发表于 2015-7-8 10:02
/** */是用于帮助文档的制作的普通自己看看的话就用/* */就好

这个解释更通俗易懂，谢谢

作者: 430422 时间: 2015-7-8 10:08
观察真仔细！顶一个！

作者: 海纳百川1123 时间: 2015-7-11 16:51

430422 发表于 2015-7-8 10:08
观察真仔细！顶一个！

谢谢！主要是老师讲的好

作者: zhwfa1991 时间: 2015-7-11 17:50
看见老师这样写，但是一直没当个问题想，楼主真认真，赞一个

作者: 海纳百川1123 时间: 2015-7-14 10:06

zhwfa1991 发表于 2015-7-11 17:50
看见老师这样写，但是一直没当个问题想，楼主真认真，赞一个

谢谢！这不都是为了成为大牛么，:D

作者: masai158 时间: 2015-7-14 18:02
注释分3种，// 单行 /* */多行。 /** */ 文档。。。
单行和多行没啥区别，行数问题。。。
/** */在编写成Java doc的时候会自动生存帮助文档。

作者: 小灬清新丶 时间: 2015-7-14 18:49
学习了~~~

作者: 城南年少 时间: 2015-7-14 19:33

文档注释可以编译出程序配套的说明文档，实现文档与代码结合在同一个文件中，便于同步修改。
多行注释不会被编译出说明文档，和单行注释作用差不多，只不过不必须每行都做标记

欢迎光临黑马程序员技术交流社区 (http://bbs.itheima.com/)

黑马程序员IT技术论坛 X3.2