A TopLevel context is a representation of the contents of a single file

Methods
#
A
B
C
D
E
F
H
L
M
N
O
P
S
T
Constants
MARSHAL_VERSION = 0
 
Attributes
[RW] absolute_name

Absolute name of this file
[R] classes_or_modules

All the classes or modules that were declared in this file. These are assigned to either #classes_hash or #modules_hash once we know what they really are.
[RW] file_stat

This TopLevel's File::Stat struct
[RW] parser

The parser that processed this file
[RW] relative_name

Relative name of this file
Class Public methods
new(absolute_name, relative_name = absolute_name)

Creates a new TopLevel for the file at absolute_name. If documentation is being generated outside the source dir relative_name is relative to the source directory.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 42
def initialize absolute_name, relative_name = absolute_name
  super()
  @name = nil
  @absolute_name = absolute_name
  @relative_name = relative_name
  @file_stat     = File.stat(absolute_name) rescue nil # HACK for testing
  @diagram       = nil
  @parser        = nil

  @classes_or_modules = []
end
Instance Public methods
==(other)

An RDoc::TopLevel is equal to another with the same #relative_name

Also aliased as: eql?

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 57
def == other
  self.class === other and @relative_name == other.relative_name
end
add_alias(an_alias)

Adds an_alias to Object instead of self.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 66
def add_alias(an_alias)
  object_class.record_location self
  return an_alias unless @document_self
  object_class.add_alias an_alias
end
add_constant(constant)

Adds constant to Object instead of self.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 75
def add_constant constant
  object_class.record_location self
  return constant unless @document_self
  object_class.add_constant constant
end
add_include(include)

Adds include to Object instead of self.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 84
def add_include(include)
  object_class.record_location self
  return include unless @document_self
  object_class.add_include include
end
add_method(method)

Adds method to Object instead of self.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 93
def add_method(method)
  object_class.record_location self
  return method unless @document_self
  object_class.add_method method
end
add_to_classes_or_modules(mod)

Adds class or module mod. Used in the building phase by the ruby parser.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 103
def add_to_classes_or_modules mod
  @classes_or_modules << mod
end
base_name()

Base name of this file

Also aliased as: name

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 110
def base_name
  File.basename @relative_name
end
cvs_url()

Returns a URL for this source file on some web repository. Use the -W command line option to set.

Source: show | on GitHub 

# File lib/rdoc/generator/markup.rb, line 158
def cvs_url
  url = @store.rdoc.options.webcvs

  if /%s/ =~ url then
    url % @relative_name
  else
    url + @relative_name
  end
end
display?()

Only a TopLevel that contains text file) will be displayed. See also RDoc::CodeObject#display?

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 120
def display?
  text? and super
end
eql?(other)
Alias for: ==
find_class_or_module(name)

See RDoc::TopLevel::find_class_or_module

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 130
def find_class_or_module name
  @store.find_class_or_module name
end
find_local_symbol(symbol)

Finds a class or module named symbol

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 137
def find_local_symbol(symbol)
  find_class_or_module(symbol) || super
end
find_module_named(name)

Finds a module or class with name

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 144
def find_module_named(name)
  find_class_or_module(name)
end
full_name()

Returns the relative name of this file

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 151
def full_name
  @relative_name
end
hash()

An RDoc::TopLevel has the same hash as another with the same #relative_name

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 159
def hash
  @relative_name.hash
end
http_url(prefix)

URL for this with a prefix

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 166
def http_url(prefix)
  path = [prefix, @relative_name.tr('.', '_')]

  File.join(*path.compact) + '.html'
end
last_modified()

Time this file was last modified, if known

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 184
def last_modified
  @file_stat ? file_stat.mtime : nil
end
marshal_dump()

Dumps this TopLevel for use by ri. See also marshal_load

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 191
def marshal_dump
  [
    MARSHAL_VERSION,
    @relative_name,
    @parser,
    parse(@comment),
  ]
end
name()
Alias for: base_name
object_class()

Returns the NormalClass “Object”, creating it if not found.

Records self as a location in “Object”.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 217
def object_class
  @object_class ||= begin
    oc = @store.find_class_named('Object') || add_class(RDoc::NormalClass, 'Object')
    oc.record_location self
    oc
  end
end
page_name()

Base name of this file without the extension

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 228
def page_name
  basename = File.basename @relative_name
  basename =~ /\.(rb|rdoc|txt|md)$/i

  $` || basename
end
path()

Path to this file for use with HTML generator output.

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 238
def path
  http_url @store.rdoc.generator.file_dir
end
search_record()

Search record used by RDoc::Generator::JsonIndex

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 256
def search_record
  return unless @parser < RDoc::Parser::Text

  [
    page_name,
    '',
    page_name,
    '',
    path,
    '',
    snippet(@comment),
  ]
end
text?()

Is this TopLevel from a text file instead of a source code file?

Source: show | on GitHub 

# File lib/rdoc/top_level.rb, line 273
def text?
  @parser and @parser.ancestors.include? RDoc::Parser::Text
end