#!/usr/bin/env ruby

=begin
Between =begin and =end, any number
of lines may be written. All of these
lines are ignored by the Ruby interpreter.
=end

puts "Hello world!"

=begin
My 
multiline
comment
here
=end

下面是一个示例：

=begin 
print "Give me a number:"
number = gets.chomp.to_f

total = number * 10
puts  "The total value is : #{total}"

=end

放置在=begin和=end之间的所有内容都将被视为注释，而不管其间包含多少行代码。

注意：确保=和begin之间没有空格：

正确：=开始错误：=开始

使用以下任一项：

=begin
This
is
a
comment
block
=end

or

# This
# is
# a
# comment
# block

是rdoc目前唯一支持的两个，我认为这是一个很好的理由只使用这些。

=begin
(some code here)
=end

and

# This code
# on multiple lines
# is commented out

都是正确的。第一种注释类型的优点是可编辑性，因为删除的字符更少，所以取消注释更容易。第二类注释的优点是逐行读取代码的可读性，更容易判断某一行已被注释掉。你的电话，但想想谁会来找你，他们阅读和维护起来有多容易。

尽管存在=begin和=end，但正常且更正确的注释方式是在每行上使用#。如果您阅读任何ruby库的源代码，您会发现几乎在所有情况下都是这样进行多行注释的。