We are the model of the code, but we know that at some point we will be worked on by viewers. By implementing the Viewable protocol, viewers can associated themselves with these objects.

Public Class Methods

new ()

Source

# File lib/rdoc/code_object.rb, line 107
def initialize
  @metadata         = {}
  @comment          = ''
  @parent           = nil
  @parent_name      = nil # for loading
  @parent_class     = nil # for loading
  @section          = nil
  @section_title    = nil # for loading
  @file             = nil
  @full_name        = nil
  @store            = nil
  @track_visibility = true
  @mixin_from       = nil

  initialize_visibility
end

Creates a new CodeObject that will document itself and its children

Public Instance Methods

comment= (comment)

Source

# File lib/rdoc/code_object.rb, line 141
def comment=(comment)
  @comment = case comment
             when NilClass               then ''
             when RDoc::Markup::Document then comment
             when RDoc::Comment          then comment.normalize
             else
               if comment and not comment.empty? then
                 normalize_comment comment
               else
                 # HACK correct fix is to have #initialize create @comment
                 #      with the correct encoding
                 if String === @comment and @comment.empty? then
                   @comment = RDoc::Encoding.change_encoding @comment, comment.encoding
                 end
                 @comment
               end
             end
end

Replaces our comment with comment, unless it is empty.

display? ()

Source

# File lib/rdoc/code_object.rb, line 169
def display?
  @document_self and not @ignored and
    (documented? or not @suppressed)
end

Should this CodeObject be displayed in output?

A code object should be displayed if:

The item didn’t have a nodoc or wasn’t in a container that had nodoc
The item wasn’t ignored
The item has documentation and was not suppressed

document_children= (document_children)

Source

# File lib/rdoc/code_object.rb, line 178
def document_children=(document_children)
  return unless @track_visibility

  @document_children = document_children unless @done_documenting
end

Enables or disables documentation of this CodeObject’s children unless it has been turned off by :enddoc:

document_self= (document_self)

Source

# File lib/rdoc/code_object.rb, line 189
def document_self=(document_self)
  return unless @track_visibility
  return if @done_documenting

  @document_self = document_self
  @received_nodoc = true if document_self.nil?
end

Enables or disables documentation of this CodeObject unless it has been turned off by :enddoc:. If the argument is nil it means the documentation is turned off by :nodoc:.

documented? ()

Source

# File lib/rdoc/code_object.rb, line 200
def documented?
  @received_nodoc or !@comment.empty?
end

Does this object have a comment with content or is received_nodoc true?

done_documenting= (value)

Source

# File lib/rdoc/code_object.rb, line 213
def done_documenting=(value)
  return unless @track_visibility
  @done_documenting  = value
  @document_self     = !value
  @document_children = @document_self
end

Turns documentation on/off, and turns on/off document_self and document_children.

Once documentation has been turned off (by :enddoc:), the object will refuse to turn document_self or document_children on, so :doc: and :start_doc: directives will have no effect in the current file.

each_parent () { |code_object| ... }

Source

# File lib/rdoc/code_object.rb, line 224
def each_parent
  code_object = self

  while code_object = code_object.parent do
    yield code_object
  end

  self
end

Yields each parent of this CodeObject. See also RDoc::ClassModule#each_ancestor

file_name ()

Source

# File lib/rdoc/code_object.rb, line 239
def file_name
  return unless @file

  @file.absolute_name
end

File name where this CodeObject was found.

See also ignore

options ()

Source

# File lib/rdoc/code_object.rb, line 303
def options
  if @store and @store.rdoc then
    @store.rdoc.options
  else
    RDoc::Options.new
  end
end

The options instance from the store this CodeObject is attached to, or a default options instance if the CodeObject is not attached.

This is used by Text#snippet

parent ()

Source

# File lib/rdoc/code_object.rb, line 315
def parent
  return @parent if @parent
  return nil unless @parent_name

  if @parent_class == RDoc::TopLevel then
    @parent = @store.add_file @parent_name
  else
    @parent = @store.find_class_or_module @parent_name

    return @parent if @parent

    begin
      @parent = @store.load_class @parent_name
    rescue RDoc::Store::MissingFileError
      nil
    end
  end
end

Our parent CodeObject. The parent may be missing for classes loaded from legacy RI data stores.

parent_file_name ()

Source

# File lib/rdoc/code_object.rb, line 337
def parent_file_name
  @parent ? @parent.base_name : '(unknown)'
end

File name of our parent

parent_name ()

Source

# File lib/rdoc/code_object.rb, line 344
def parent_name
  @parent ? @parent.full_name : '(unknown)'
end

Name of our parent

record_location (top_level)

Source

# File lib/rdoc/code_object.rb, line 351
def record_location top_level
  @ignored    = false
  @suppressed = false
  @file       = top_level
end

Records the RDoc::TopLevel (file) where this code object was defined

section ()

Source

# File lib/rdoc/code_object.rb, line 361
def section
  return @section if @section

  @section = parent.add_section @section_title if parent
end

The section this CodeObject is in. Sections allow grouping of constants, attributes and methods inside a class or module.

start_doc ()

Source

# File lib/rdoc/code_object.rb, line 371
def start_doc
  return if @done_documenting

  @document_self = true
  @document_children = true
  @ignored    = false
  @suppressed = false
end

Enable capture of documentation unless documentation has been turned off by :enddoc:

stop_doc ()

Source

# File lib/rdoc/code_object.rb, line 383
def stop_doc
  return unless @track_visibility

  @document_self = false
  @document_children = false
end

Disable capture of documentation

store= (store)

Source

# File lib/rdoc/code_object.rb, line 393
def store= store
  @store = store

  return unless @track_visibility

  if :nodoc == options.visibility then
    initialize_visibility
    @track_visibility = false
  end
end

Sets the store that contains this CodeObject

suppress ()

Source

# File lib/rdoc/code_object.rb, line 410
def suppress
  return unless @track_visibility

  @suppressed = true

  stop_doc
end

Use this to suppress a CodeObject and all its children until the next file it is seen in or documentation is discovered. A suppressed item with documentation will be displayed while an ignored item with documentation may not be displayed.

suppressed? ()

Source

# File lib/rdoc/code_object.rb, line 423
def suppressed?
  @suppressed
end

Has this class been suppressed?