From: matz@... (Yukihiro Matsumoto)
Date: 2001-07-06T12:53:45+09:00
Subject: [ruby-talk:17375] Re: /* */ comments

HI,

In message "[ruby-talk:17322] Re: /* */ comments"
    on 01/07/05, Simon Cozens <simon@netthink.co.uk> writes:

|    http://dev.perl.org/rfc/5.html
|    http://dev.perl.org/rfc/102.html
|    http://dev.perl.org/rfc/325.html

Thank you for the information.  It's good to have a forerunner.
These RFCs inpires me a lot.

In summary, we have several problems to solve:

  (a) multi-line comment for documentation
  (b) multi-line comment for debugging tool
  (c) inline comment

For (a), we already have =begin/=end; for (b), I think we can use
=begin/=end too.  RDtool does not handle embedded documentation with
tag other than "RD", so that you can do

=begin debug
  ... code to escape out ...
=end

without showing code in the RD processed documentation.

So, I think, we have to discuss about (c) inline comments only.
What do you think?

							matz.