method

extract_comment

v1_9_3_125 - Show latest stable - Class: RDoc::Context::Section

extract_comment(comment)

public

Extracts the comment for this section from the original comment block. If the first line contains :section:, strip it and use the rest. Otherwise remove lines up to the line containing :section:, and look for those lines again at the end and remove them. This lets us write

# :section: The title
# The body

# File lib/rdoc/context.rb, line 178
    def extract_comment comment
      if comment =~ /^#[ \t]*:section:.*\n/ then
        start = $`
        rest = $'

        if start.empty? then
          rest
        else
          rest.sub(/#{start.chomp}\Z/, '')
        end
      else
        comment
      end
    end

extract_comment

Related methods