Merged my changes from HEAD

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_8@10499 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

lib/rdoc/parsers/parse_c.rb

@@ -212,6 +212,11 @@ module RDoc
       $stderr.flush
     end
 
+    def remove_private_comments(comment)
+       comment.gsub!(/\/?\*--(.*?)\/?\*\+\+/m, '')
+       comment.sub!(/\/?\*--.*/m, '')
+    end
+
     # remove lines that are commented out that might otherwise get
     # picked up when scanning for classes and methods
 
@@ -552,6 +557,8 @@ module RDoc
         comment, params = $1, $2
         body_text = $&
 
+        remove_private_comments(comment) if comment
+
         # see if we can find the whole body
         
         re = Regexp.escape(body_text) + '[^(]*^\{.*?^\}'