From: Aristarkh A Zagorodnikov <xm@...3d.ru>
Date: 2001-07-04T16:01:44+09:00
Subject: [ruby-talk:17221] Re: /* */ comments

> -----Original Message-----
> From: Yukihiro Matsumoto [mailto:matz@ruby-lang.org]
> Sent: Wednesday, July 04, 2001 9:43 AM
> To: ruby-talk ML
> Subject: [ruby-talk:17218] Re: /* */ comments
> 
> 
> Hi,
> 
> In message "[ruby-talk:17217] Re: /* */ comments"
>     on 01/07/04, Daniel <daniel@longbeach.goldinc.com> writes:
> 
> |I never used =begin =end yet,  but someone pointed out that they have to
> |be at the beginning of the line  *shrugs*    
> 
> =begin and =end are rather for documentation.  I don't recommend to
> use them as multi line comments (e.g. to escape out chunk of code).
> If you really need that kind of multi line comment, I'm really open
> for discussion, or RCR.
I vote for it (rather /*...*/ or /#...#/ - first is better imho)
I rarely write large comments but whenever there is a need to, prefixing each line
with a # symbol isn't that good ... And =begin/=end as previous poster stated
just make code look uglier (especially if there is a lot of indenting going on).
OTOH this may break existing syntax hilighting scheme - and I can't live without
it anymore ;)).

Aristarkh A Zagorodnikov, Lead Programmer, W3D Group
http://www.w3d.ru /// xm@w3d.ru /// ICQ UIN 36987938