A.2 Ruby程序的注释

A.2 Ruby程序的注释

php?name=Ruby" onclick="tagshow(event)" class="t_tag">Ruby程序的注释有两种形式:

1、单行注释
2、多行注释

单行注释也是Ruby代码的文档注释,因为你可以用rdoc命令行工具生成Ruby类的rdoc文档。

[Copy to clipboard] [ - ]
我做了实验,同时有单行注释和多行注释,确实是:单行注释也是Ruby代码的文档注释,可以在网页上看到。
但多行注释也确实被Ruby忽略了,就是在网页上没有和单行注释一起显示出来。
我以前没有注意到这些细节。

今天弄到这些细节,干脆都弄明白吧。直接问讲师吧。

问题一:有时需要将多行注释的内容像单行注释一样输出的话,怎么做呢(除了用单行连续注释以外)?

问题二:单行注释被显示在.html网页中,如果需要输出到某个指定的文件,可以吗?能给个例子吗?
可以考虑:Here Document语法,比如:

puts <<OK
  1、第一行
 2、第二行
OK

#Here Document语法:
#<<标识符
#标识符

#Here Document的使用很讲究技巧,比如: """ ok """ 等的使用。
#不知这可以解决你的问题吗?

这样吧,你告诉我在哪本相关的书中有介绍,我去查来看看。
可以吗?

为啥提出这些问题?我在考虑如何提高写详细设计文档的效率。
面向对象的详细设计有时可以和编程同时进行的,如果注释能帮助工程师高效完成一些设计的内容,就好了。
比如,Java的注释和Doc功能,如果会利用,就可以帮助工程师高效完成大部分设计的内容。文档是软件工程很重要的部分呀。
看看这个能否满足伱的要求吗?

《The Ruby Way》

到后面的叙述,我会提到这个问题!

[ 本帖最后由 quzhongwei 于 2008-6-11 00:32 编辑 ]
OK,我抽时间去看看。谢谢!
Here Document语法,标识符需要大写,楼主没讲到。。。
班门弄斧,小弟就知道这个。
引用:
原帖由 枫灯 于 2008-6-11 19:15 发表
Here Document语法,标识符需要大写,楼主没讲到。。。
班门弄斧,小弟就知道这个。
引用:
原帖由 枫灯 于 2008-6-11 19:15 发表
Here Document语法,标识符需要大写,楼主没讲到。。。
班门弄斧,小弟就知道这个。
我要一步一步往上爬.......