ruby--ruby/lib/rdoc/parsers/parse_simple.rb

require 'rdoc'
require 'rdoc/code_objects'
require 'rdoc/markup/preprocess'

##
# Parse a non-source file. We basically take the whole thing as one big
# comment. If the first character in the file is '#', we strip leading pound
# signs.

class RDoc::SimpleParser

  ##
  # Prepare to parse a plain file

  def initialize(top_level, file_name, body, options, stats)
    preprocess = RDoc::Markup::PreProcess.new(file_name, options.rdoc_include)

    preprocess.handle(body) do |directive, param|
      warn "Unrecognized directive '#{directive}' in #{file_name}"
    end

    @body = body
    @options = options
    @top_level = top_level
  end

  ##
  # Extract the file contents and attach them to the toplevel as a comment

  def scan
    @top_level.comment = remove_private_comments(@body)
    @top_level
  end

  def remove_private_comments(comment)
    comment.gsub(/^--[^-].*?^\+\+/m, '').sub(/^--.*/m, '')
  end

end