class RDoc::CodeObject

def comment=(comment)
  @comment = case comment
             when NilClass               then ''
             when RDoc::Markup::Document then comment
             else
               if comment and not comment.empty? then
                 normalize_comment comment
               else
                 @comment
               end
             end
end

def document_children=(document_children)
  @document_children = document_children
  remove_classes_and_modules unless document_children
end

def document_self=(document_self)
  @document_self = document_self
  remove_methods_etc unless document_self
end

def documented?
  !(@document_self and @comment.empty?)
end

def initialize
  @metadata = {}
  @comment = ''
  @document_children   = true
  @document_self       = true
  @done_documenting    = false
  @force_documentation = false
  @parent = nil
end

def parent_file_name
  @parent ? @parent.base_name : '(unknown)'
end

def parent_name
  @parent ? @parent.full_name : '(unknown)'
end

def remove_classes_and_modules
end

def remove_methods_etc
end

def start_doc
  @document_self = true
  @document_children = true
end

def stop_doc
  @document_self = false
  @document_children = false
end