Block comments syntax

Hello,

It says at http://www.rubygarden.org/ruby?RubyFromC that I can do block
comment in Ruby like so:

=begin
my comment
=end

However, when I try to I get a syntax error. Why is this? How can I do
it?

Many Thanks

···

--
Jonathan Leighton
http://turnipspatch.com/ | http://jonathanleighton.com/ | http://digital-proof.org/

Hello,

It says at http://www.rubygarden.org/ruby?RubyFromC that I can do block
comment in Ruby like so:

=begin
my comment
=end

However, when I try to I get a syntax error. Why is this? How can I do
it?

I don't see an error:

cat t

=begin
my comment
=end
puts 'hello'

ruby t

hello

ruby -v

ruby 1.8.4 (2005-10-29) [i686-linux]

···

On Sun, 25 Dec 2005, Jonathan Leighton wrote:

--
Wybo

Make sure that you don't indent them...

Two notes, since the RubyGarden page doesn't mention it:

* Ensure that there is no space/tab before =begin and
  =end (i.e. the = must be the first character in the line)

* Nesting of =begin/=end blocks is not possible.

···

On Sunday 25 December 2005 12:53, Jonathan Leighton wrote:

Hello,

It says at http://www.rubygarden.org/ruby?RubyFromC that I can do
block comment in Ruby like so:

=begin
my comment
=end

However, when I try to I get a syntax error. Why is this? How can I
do it?

--
Stefan

This was it, thanks all.

Incidentally, the =begin and =end syntax seems pretty cumbersome to me
(compared to /* */ for instance). Is it like this because Ruby is so
versatile and anything else would be difficult to parse?

···

On Sun, 2005-12-25 at 21:45 +0900, Stefan Lang wrote:

* Ensure that there is no space/tab before =begin and
  =end (i.e. the = must be the first character in the line)

--
Jonathan Leighton
http://turnipspatch.com/ | http://jonathanleighton.com/ | http://digital-proof.org/

More that it is a facility for embedded documentation:
http://www.ruby-doc.org/docs/ProgrammingRuby/html/rdtool.html

Jonathan Leighton wrote:

Incidentally, the =begin and =end syntax seems pretty cumbersome to me
(compared to /* */ for instance). Is it like this because Ruby is so
versatile and anything else would be difficult to parse?

Maybe it's like that because it's a facility you're not supposed to use; many people feel block comments are a bad idea. Personally, I only use them in languages which lack line comments.

mathew

···

--
      <URL:http://www.pobox.com/~meta/&gt;
My parents went to the lost kingdom of Hyrule
     and all I got was this lousy triforce.

Well if you want to temporarily get rid of a large number of lines,
block comments are much, much quicker than doing a line comment for each
and every line. I don't tend to leave block comments in the app though
-- just during development I find them useful.

···

On Wed, 2005-12-28 at 13:22 +0900, mathew wrote:

Jonathan Leighton wrote:
> Incidentally, the =begin and =end syntax seems pretty cumbersome to me
> (compared to /* */ for instance). Is it like this because Ruby is so
> versatile and anything else would be difficult to parse?

Maybe it's like that because it's a facility you're not supposed to use;
many people feel block comments are a bad idea. Personally, I only use
them in languages which lack line comments.

--
Jonathan Leighton
http://turnipspatch.com/ | http://jonathanleighton.com/ | http://digital-proof.org/

Jonathan Leighton wrote:

···

On Wed, 2005-12-28 at 13:22 +0900, mathew wrote:

Jonathan Leighton wrote:
> Incidentally, the =begin and =end syntax seems pretty cumbersome to me
> (compared to /* */ for instance). Is it like this because Ruby is so
> versatile and anything else would be difficult to parse?

Maybe it's like that because it's a facility you're not supposed to use;
many people feel block comments are a bad idea. Personally, I only use
them in languages which lack line comments.

Well if you want to temporarily get rid of a large number of lines,
block comments are much, much quicker than doing a line comment for each
and every line. I don't tend to leave block comments in the app though
-- just during development I find them useful.

Perhaps.

  V10n:s/^/#/

Comments out the next ten lines for me. I could alias
it to a macro key but I have not bothered yet :slight_smile:

E

--
Posted via http://www.ruby-forum.com/\.

Hello.

Jonathan Leighton:

Well if you want to temporarily get rid of a large number of lines,
block comments are much, much quicker than doing a line comment for
each and every line.

In vim, I simply use block select (ctrl-v) to select the first column
of the affected lines and replace the spaces with comment marks (r#).
This has the additional benefit of not shifting the commented-out code
to the right.

Cheers,
-- Shot

···

--
  In the UNIX world, people tend to interpret 'non-technical user' as meaning
  someone who's only ever written one device driver. -- Daniel Pead
====================== home.pl: Nr 1 w Polsce. Domeny, Hosting, Serwery WWW, Strony, eSklep, Office 365 === home.pl: Nr 1 w Polsce. Domeny, Hosting, Serwery WWW, Strony, eSklep, Office 365 ===