# RDoc produces documentation for Ruby source files by parsing the source and
# extracting the definition for classes, modules, methods, includes and
# requires. It associates these with optional documentation contained in an
# immediately preceding comment block then renders the result using an output
# For a simple introduction to writing or generating documentation using RDoc
# If you think you found a bug in RDoc see CONTRIBUTING@Bugs
# If you want to use RDoc to create documentation for your Ruby source files,
# see RDoc::Markup and refer to <tt>rdoc --help</tt> for command line usage.
# If you want to set the default markup format see
# RDoc::Markup@Supported+Formats
# If you want to store rdoc configuration in your gem (such as the default
# markup format) see RDoc::Options@Saved+Options
# If you want to write documentation for Ruby files see RDoc::Parser::Ruby
# If you want to write documentation for extensions written in C see
# If you want to generate documentation using <tt>rake</tt> see RDoc::Task.
# If you want to drive RDoc programmatically, see RDoc::RDoc.
# If you want to use the library to format text blocks into HTML or other
# formats, look at RDoc::Markup.
# If you want to make an RDoc plugin such as a generator or directive handler
# If you want to write your own output generator see RDoc::Generator.
# If you want an overview of how RDoc works see CONTRIBUTING
# RDoc is currently being maintained by Eric Hodel <drbrain@segment7.net>.
# Dave Thomas <dave@pragmaticprogrammer.com> is the original author of RDoc.
# * The Ruby parser in rdoc/parse.rb is based heavily on the outstanding
# work of Keiju ISHITSUKA of Nippon Rational Inc, who produced the Ruby
# parser for irb and the rtags package.
# Exception thrown by any rdoc error.
class Error < RuntimeError; end
# RDoc version you are using
VISIBILITIES = [:public, :protected, :private]
# Name of the dotfile that contains the description of files to be processed
# in the current directory
DOT_DOC_FILENAME = ".document"
GENERAL_MODIFIERS = %w[nodoc].freeze
# RDoc modifiers for classes
CLASS_MODIFIERS = GENERAL_MODIFIERS
# RDoc modifiers for attributes
ATTR_MODIFIERS = GENERAL_MODIFIERS
# RDoc modifiers for constants
CONSTANT_MODIFIERS = GENERAL_MODIFIERS
# RDoc modifiers for methods
METHOD_MODIFIERS = GENERAL_MODIFIERS +
%w[arg args yield yields notnew not-new not_new doc]
# Loads the best available YAML library.
autoload :RDoc, 'rdoc/rdoc'
autoload :TestCase, 'rdoc/test_case'
autoload :CrossReference, 'rdoc/cross_reference'
autoload :ERBIO, 'rdoc/erbio'
autoload :ERBPartial, 'rdoc/erb_partial'
autoload :Encoding, 'rdoc/encoding'
autoload :Generator, 'rdoc/generator'
autoload :Options, 'rdoc/options'
autoload :Parser, 'rdoc/parser'
autoload :Servlet, 'rdoc/servlet'
autoload :Stats, 'rdoc/stats'
autoload :Store, 'rdoc/store'
autoload :Task, 'rdoc/task'
autoload :Text, 'rdoc/text'
autoload :Markdown, 'rdoc/markdown'
autoload :Markup, 'rdoc/markup'
autoload :TomDoc, 'rdoc/tom_doc'
autoload :KNOWN_CLASSES, 'rdoc/known_classes'
autoload :RubyLex, 'rdoc/ruby_lex'
autoload :RubyToken, 'rdoc/ruby_token'
autoload :TokenStream, 'rdoc/token_stream'
autoload :Comment, 'rdoc/comment'
autoload :I18n, 'rdoc/i18n'
# We represent the various high-level code constructs that appear in Ruby
# programs: classes, modules, methods, and so on.
autoload :CodeObject, 'rdoc/code_object'
autoload :Context, 'rdoc/context'
autoload :TopLevel, 'rdoc/top_level'
autoload :AnonClass, 'rdoc/anon_class'
autoload :ClassModule, 'rdoc/class_module'
autoload :NormalClass, 'rdoc/normal_class'
autoload :NormalModule, 'rdoc/normal_module'
autoload :SingleClass, 'rdoc/single_class'
autoload :Alias, 'rdoc/alias'
autoload :AnyMethod, 'rdoc/any_method'
autoload :MethodAttr, 'rdoc/method_attr'
autoload :GhostMethod, 'rdoc/ghost_method'
autoload :MetaMethod, 'rdoc/meta_method'
autoload :Attr, 'rdoc/attr'
autoload :Constant, 'rdoc/constant'
autoload :Mixin, 'rdoc/mixin'
autoload :Include, 'rdoc/include'
autoload :Extend, 'rdoc/extend'
autoload :Require, 'rdoc/require'