Class RDoc::Context::Section
In: code_objects.rb
Parent: Object

Contents

Methods

new   set_comment  

Attributes

comment  [R] 
sequence  [R] 
title  [R] 

Public Class methods

new(title, comment)

[Source]

     # File code_objects.rb, line 125
125:       def initialize(title, comment)
126:         @title = title
127:         @@sequence.succ!
128:         @sequence = @@sequence.dup
129:         set_comment(comment)
130:       end

The title

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
  # ---------------------

Public Instance methods

set_comment(comment)

[Source]

     # File code_objects.rb, line 144
144:       def set_comment(comment)
145:         return unless comment
146: 
147:         if comment =~ /^.*?:section:.*$/
148:           start = $`
149:           rest = $'
150:           if start.empty?
151:             @comment = rest
152:           else
153:             @comment = rest.sub(/#{start.chomp}\Z/, '')
154:           end
155:         else
156:           @comment = comment
157:         end
158:         @comment = nil if @comment.empty?
159:       end