summaryrefslogtreecommitdiff
path: root/jni/ruby/lib/rdoc/generator.rb
diff options
context:
space:
mode:
authorJari Vetoniemi <jari.vetoniemi@indooratlas.com>2020-03-16 18:49:26 +0900
committerJari Vetoniemi <jari.vetoniemi@indooratlas.com>2020-03-30 00:39:06 +0900
commitfcbf63e62c627deae76c1b8cb8c0876c536ed811 (patch)
tree64cb17de3f41a2b6fef2368028fbd00349946994 /jni/ruby/lib/rdoc/generator.rb
Fresh start
Diffstat (limited to 'jni/ruby/lib/rdoc/generator.rb')
-rw-r--r--jni/ruby/lib/rdoc/generator.rb51
1 files changed, 51 insertions, 0 deletions
diff --git a/jni/ruby/lib/rdoc/generator.rb b/jni/ruby/lib/rdoc/generator.rb
new file mode 100644
index 0000000..7d3989d
--- /dev/null
+++ b/jni/ruby/lib/rdoc/generator.rb
@@ -0,0 +1,51 @@
+##
+# RDoc uses generators to turn parsed source code in the form of an
+# RDoc::CodeObject tree into some form of output. RDoc comes with the HTML
+# generator RDoc::Generator::Darkfish and an ri data generator
+# RDoc::Generator::RI.
+#
+# == Registering a Generator
+#
+# Generators are registered by calling RDoc::RDoc.add_generator with the class
+# of the generator:
+#
+# class My::Awesome::Generator
+# RDoc::RDoc.add_generator self
+# end
+#
+# == Adding Options to +rdoc+
+#
+# Before option processing in +rdoc+, RDoc::Options will call ::setup_options
+# on the generator class with an RDoc::Options instance. The generator can
+# use RDoc::Options#option_parser to add command-line options to the +rdoc+
+# tool. See RDoc::Options@Custom+Options for an example and see OptionParser
+# for details on how to add options.
+#
+# You can extend the RDoc::Options instance with additional accessors for your
+# generator.
+#
+# == Generator Instantiation
+#
+# After parsing, RDoc::RDoc will instantiate a generator by calling
+# #initialize with an RDoc::Store instance and an RDoc::Options instance.
+#
+# The RDoc::Store instance holds documentation for parsed source code. In
+# RDoc 3 and earlier the RDoc::TopLevel class held this data. When upgrading
+# a generator from RDoc 3 and earlier you should only need to replace
+# RDoc::TopLevel with the store instance.
+#
+# RDoc will then call #generate on the generator instance. You can use the
+# various methods on RDoc::Store and in the RDoc::CodeObject tree to create
+# your desired output format.
+
+module RDoc::Generator
+
+ autoload :Markup, 'rdoc/generator/markup'
+
+ autoload :Darkfish, 'rdoc/generator/darkfish'
+ autoload :JsonIndex, 'rdoc/generator/json_index'
+ autoload :RI, 'rdoc/generator/ri'
+ autoload :POT, 'rdoc/generator/pot'
+
+end
+