A.2 Ruby程序的注释

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

１、单行注释
２、多行注释

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

我做了实验，同时有单行注释和多行注释，确实是：单行注释也是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语法，标识符需要大写，楼主没讲到。。。
班门弄斧，小弟就知道这个。

我要一步一步往上爬.......