=begin rdoc...=end block style problem when there's code before them about rdoc HOT 3 CLOSED

It seems part of the problem is processing of newlines. When I put an empty line between rdoc and the module definition (from the first example), it works:

require 'something'
=begin rdoc
findmeindoc
=end

module Foo
    class Bar
    end
end

gives

$ rdoc -v test2.rb
Parsing sources...
100% [ 1/ 1]  test2.rb
  class Foo::Bar (undocumented)
  module Foo

from rdoc.

When I modify the lexer to not consume the =end with the newline, it works:

$ diff -u ruby_lex.rb.orig ruby_lex.rb
--- ruby_lex.rb.orig    2011-05-31 02:46:43.000000000 +0200
+++ ruby_lex.rb 2011-05-31 02:46:50.000000000 +0200
@@ -409,6 +409,7 @@
       end

       gets # consume =end
+      ungetc

       @ltype = nil
       Token(TkCOMMENT, res)

Doesn't look like a clean fix though ...

from rdoc.

Thanks for the patch, it pointed me in th eright direction. Instead I changed the ruby parser to not assume that a TkCOMMENT is followed by a TkNL (newline).

Note that =begin and =end for documentation purposes is rarely used, commenting with # is preferred.

from rdoc.