Hi,

Here's a patch that lets you use '--' and '++' within C extension comments to 
stop and restart rdoc processing.  It seems to work fine in my experiments, 
though I've done no formal testing.

--- parse_c.orig        Wed Jul  5 14:37:10 2006
+++ parse_c.rb  Wed Jul  5 16:12:19 2006
@@ -218,6 +218,11 @@
      def remove_commented_out_lines
        @body.gsub!(%r{//.*rb_define_}, '//')
      end
+
+    def remove_private_comments(comment)
+       comment.gsub!(/\/?\*--(.*?)\/?\*\+\+/m, '')
+       comment.sub!(/\/?\*--.*/m, '')
+    end

      def handle_class_module(var_name, class_mod, class_name, parent, in_module)
        progress(class_mod[0, 1])
@@ -552,6 +557,8 @@
          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) + '[^(]*^\{.*?^\}'


This communication is the property of Qwest and may contain confidential or
privileged information. Unauthorized use of this communication is strictly 
prohibited and may be unlawful.  If you have received this communication 
in error, please immediately notify the sender by reply e-mail and destroy 
all copies of the communication and any attachments.