jeffreyhunter77-R2Doc 0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.1 First working version.

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jeffrey Hunter and Mission Critical Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest

@@ -0,0 +1,50 @@
+bin/r2doc
+CHANGELOG
+lib/r2doc/context_extensions.rb
+lib/r2doc/erb_template_engine.rb
+lib/r2doc/generator.rb
+lib/r2doc/rdoc_v2_generator.rb
+lib/r2doc/template/r2doc/_aliases.html.erb
+lib/r2doc/template/r2doc/_attributes.html.erb
+lib/r2doc/template/r2doc/_classes_and_modules.html.erb
+lib/r2doc/template/r2doc/_constants.html.erb
+lib/r2doc/template/r2doc/_method_detail.html.erb
+lib/r2doc/template/r2doc/_method_details.html.erb
+lib/r2doc/template/r2doc/_method_listing.html.erb
+lib/r2doc/template/r2doc/_method_listing_row.html.erb
+lib/r2doc/template/r2doc/_nav.html.erb
+lib/r2doc/template/r2doc/_nav_item.html.erb
+lib/r2doc/template/r2doc/class.html.erb
+lib/r2doc/template/r2doc/file.html.erb
+lib/r2doc/template/r2doc/images/blue-arrow-right.png
+lib/r2doc/template/r2doc/images/blue-arrow-up.png
+lib/r2doc/template/r2doc/images/blue-box.png
+lib/r2doc/template/r2doc/images/blue-plus.png
+lib/r2doc/template/r2doc/images/close-button.png
+lib/r2doc/template/r2doc/images/green-arrow-right.png
+lib/r2doc/template/r2doc/images/green-arrow-up.png
+lib/r2doc/template/r2doc/images/nav-back.png
+lib/r2doc/template/r2doc/images/nav-bottom.png
+lib/r2doc/template/r2doc/images/nav-top.png
+lib/r2doc/template/r2doc/images/orange-hash.png
+lib/r2doc/template/r2doc/images/red-dash.png
+lib/r2doc/template/r2doc/images/search-back.png
+lib/r2doc/template/r2doc/images/top-back.png
+lib/r2doc/template/r2doc/images/top-left.png
+lib/r2doc/template/r2doc/images/top-right.png
+lib/r2doc/template/r2doc/index.html.erb
+lib/r2doc/template/r2doc/jquery.js
+lib/r2doc/template/r2doc/prototype.js
+lib/r2doc/template/r2doc/r2doc.css
+lib/r2doc/template/r2doc/rdoc-utils.js
+lib/r2doc/template/r2doc/rdoc.js.erb
+lib/r2doc/template.rb
+lib/r2doc/template_util.rb
+lib/r2doc.rb
+lib/rdoc/discover.rb
+lib/rdoc/generators/r2doc_generator.rb
+LICENSE
+Manifest
+Rakefile
+README
+README.rdoc

data/R2Doc.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{R2Doc}
+  s.version = "0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeffrey Hunter and Mission Critical Labs, Inc."]
+  s.date = %q{2009-07-17}
+  s.default_executable = %q{r2doc}
+  s.description = %q{R2Doc is an improved generator for RDoc. It provides an improved output template for documentation (including search and frameless navigation), but also aims to be more extensible so that template authoring is an easier task with a wider set of options.}
+  s.email = %q{r2doc@missioncriticallabs.com}
+  s.executables = ["r2doc"]
+  s.extra_rdoc_files = ["bin/r2doc", "CHANGELOG", "lib/r2doc/context_extensions.rb", "lib/r2doc/erb_template_engine.rb", "lib/r2doc/generator.rb", "lib/r2doc/rdoc_v2_generator.rb", "lib/r2doc/template/r2doc/_aliases.html.erb", "lib/r2doc/template/r2doc/_attributes.html.erb", "lib/r2doc/template/r2doc/_classes_and_modules.html.erb", "lib/r2doc/template/r2doc/_constants.html.erb", "lib/r2doc/template/r2doc/_method_detail.html.erb", "lib/r2doc/template/r2doc/_method_details.html.erb", "lib/r2doc/template/r2doc/_method_listing.html.erb", "lib/r2doc/template/r2doc/_method_listing_row.html.erb", "lib/r2doc/template/r2doc/_nav.html.erb", "lib/r2doc/template/r2doc/_nav_item.html.erb", "lib/r2doc/template/r2doc/class.html.erb", "lib/r2doc/template/r2doc/file.html.erb", "lib/r2doc/template/r2doc/images/blue-arrow-right.png", "lib/r2doc/template/r2doc/images/blue-arrow-up.png", "lib/r2doc/template/r2doc/images/blue-box.png", "lib/r2doc/template/r2doc/images/blue-plus.png", "lib/r2doc/template/r2doc/images/close-button.png", "lib/r2doc/template/r2doc/images/green-arrow-right.png", "lib/r2doc/template/r2doc/images/green-arrow-up.png", "lib/r2doc/template/r2doc/images/nav-back.png", "lib/r2doc/template/r2doc/images/nav-bottom.png", "lib/r2doc/template/r2doc/images/nav-top.png", "lib/r2doc/template/r2doc/images/orange-hash.png", "lib/r2doc/template/r2doc/images/red-dash.png", "lib/r2doc/template/r2doc/images/search-back.png", "lib/r2doc/template/r2doc/images/top-back.png", "lib/r2doc/template/r2doc/images/top-left.png", "lib/r2doc/template/r2doc/images/top-right.png", "lib/r2doc/template/r2doc/index.html.erb", "lib/r2doc/template/r2doc/jquery.js", "lib/r2doc/template/r2doc/prototype.js", "lib/r2doc/template/r2doc/r2doc.css", "lib/r2doc/template/r2doc/rdoc-utils.js", "lib/r2doc/template/r2doc/rdoc.js.erb", "lib/r2doc/template.rb", "lib/r2doc/template_util.rb", "lib/r2doc.rb", "lib/rdoc/discover.rb", "lib/rdoc/generators/r2doc_generator.rb", "LICENSE", "README", "README.rdoc"]
+  s.files = ["bin/r2doc", "CHANGELOG", "lib/r2doc/context_extensions.rb", "lib/r2doc/erb_template_engine.rb", "lib/r2doc/generator.rb", "lib/r2doc/rdoc_v2_generator.rb", "lib/r2doc/template/r2doc/_aliases.html.erb", "lib/r2doc/template/r2doc/_attributes.html.erb", "lib/r2doc/template/r2doc/_classes_and_modules.html.erb", "lib/r2doc/template/r2doc/_constants.html.erb", "lib/r2doc/template/r2doc/_method_detail.html.erb", "lib/r2doc/template/r2doc/_method_details.html.erb", "lib/r2doc/template/r2doc/_method_listing.html.erb", "lib/r2doc/template/r2doc/_method_listing_row.html.erb", "lib/r2doc/template/r2doc/_nav.html.erb", "lib/r2doc/template/r2doc/_nav_item.html.erb", "lib/r2doc/template/r2doc/class.html.erb", "lib/r2doc/template/r2doc/file.html.erb", "lib/r2doc/template/r2doc/images/blue-arrow-right.png", "lib/r2doc/template/r2doc/images/blue-arrow-up.png", "lib/r2doc/template/r2doc/images/blue-box.png", "lib/r2doc/template/r2doc/images/blue-plus.png", "lib/r2doc/template/r2doc/images/close-button.png", "lib/r2doc/template/r2doc/images/green-arrow-right.png", "lib/r2doc/template/r2doc/images/green-arrow-up.png", "lib/r2doc/template/r2doc/images/nav-back.png", "lib/r2doc/template/r2doc/images/nav-bottom.png", "lib/r2doc/template/r2doc/images/nav-top.png", "lib/r2doc/template/r2doc/images/orange-hash.png", "lib/r2doc/template/r2doc/images/red-dash.png", "lib/r2doc/template/r2doc/images/search-back.png", "lib/r2doc/template/r2doc/images/top-back.png", "lib/r2doc/template/r2doc/images/top-left.png", "lib/r2doc/template/r2doc/images/top-right.png", "lib/r2doc/template/r2doc/index.html.erb", "lib/r2doc/template/r2doc/jquery.js", "lib/r2doc/template/r2doc/prototype.js", "lib/r2doc/template/r2doc/r2doc.css", "lib/r2doc/template/r2doc/rdoc-utils.js", "lib/r2doc/template/r2doc/rdoc.js.erb", "lib/r2doc/template.rb", "lib/r2doc/template_util.rb", "lib/r2doc.rb", "lib/rdoc/discover.rb", "lib/rdoc/generators/r2doc_generator.rb", "LICENSE", "Manifest", "Rakefile", "README", "README.rdoc", "R2Doc.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://r2doc.org}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "R2Doc", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{r2doc}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{An extensible RDoc generator using ERB}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/README

@@ -0,0 +1,103 @@
+= R2Doc
+
+R2Doc began as a desire to to create a format for Ruby and Rails
+documentation that would be more useful than anything currently available
+(or at least more useful to me).  Specifically, I had a small set of goals:
+
+* To get rid of the really awful frames
+* To allow easy searching by class or method name
+* To make it easier to scan the lists of methods and attributes
+* To limit line length for easier viewing on wide browsers
+
+As RDoc version 1.0.1 was already packaged as part of the Ruby core and
+version 2 did not yet appear to be stable when I started, I began by
+building a template for version 1.  As soon as I scratched the surface of
+RDoc, I became immediately dismayed by what I found.  The template format
+was arcane, and much of the presentation logic I hoped to change was
+embedded in the generator code.  R2Doc quickly evolved into more than just
+another template.  While still in its very early stages of development,
+R2Doc is a generator that is more easily extended and is very much a second
+set of thoughts on what a framework for documentation generators could and
+_should_ be.  It is my hope that, more than anything, R2Doc will be a
+contribution to the dialog about the future directions of RDoc.
+
+== Features
+
+[RDoc version independent]
+  The R2Doc generator is not limited to a particular version of RDoc.  It
+  has been tested to work with version 1.0.1 and 2.3.0.  Additional
+  versions will be tested as development progresses.
+[Support for multiple templates]
+  While others will hopefully find the default template useful, some people
+  will almost certainly have different preferences for the format.  The
+  beauty of R2Doc is not in its template, but rather in the facilities it
+  provides for creating templates more easily.
+[Pushes presentation logic into the template]
+  My biggest gripe with the current version of RDoc is that more attention
+  should be paid to what makes Rails so successful as a web development
+  framework.  Part of what really works for Rails is that it makes it easy
+  to build an application using a straight-forward MVC pattern and
+  encourages a clean separation between each of the three components of that
+  architecture.  RDoc is made up of parts which correspond to each of those
+  components as well.  A generator is a controller; the context objects
+  representing the classes, modules, files, and methods found in the code are
+  models; and a template is a view.  R2Doc extends the model classes with
+  methods that provide information about the code being documented without
+  directly generating HTML.  This pushes presentation logic into the view,
+  making for cleaner code and more powerful templates.
+[More powerful capabilities within the templates]
+  Another key to the success of Rails is the large collection of utility
+  methods which are specifically made available for use within views.  They
+  make common coding tasks easier to accomplish.	R2Doc adds a small
+  collection of utility methods specifically design to facilitate template
+  authoring.
+[Extensible set of template formats]
+  R2Doc provides an ERB engine for templates by default, but it is not
+  limited to only ERB templates.	Much like Rails, the file extension of a
+  template dictates which engine it is written for.  Template engines can be
+  added to R2Doc and registered to work with additional extensions.  So,
+  engines can easily be added to allow template creation in HAML, XML
+  builder, or nearly anything else you care for.
+
+== Usage
+
+R2Doc is a standard generator, and, as such, can be specified using the
+<tt>-f</tt> or <tt>--fmt</tt> options with the <tt>rdoc</tt> command.  Its
+gem will be automatically discovered by version 2 of RDoc, but version 1 is
+slightly trickier as it relies on the <tt>$:</tt> variable.  To facilitate
+use, R2Doc provides the <tt>r2doc</tt> command.  It's usage is:
+
+  r2doc [options] [names...]     # normal usage
+  r2doc [options] --gems gems... # generate docs for installed gems
+
+The first usage sets options for using R2Doc as the generator and passes
+everything else on to <tt>rdoc</tt>.  The second usage is a specialized
+form for generating docs for an installed gem using the R2Doc generator. 
+By default <tt>r2doc</tt> uses whatever version of RDoc is your default,
+but it includes one additional option, <tt>--rdoc-version</tt>, which allows
+you to specify the RDoc version when multiple gems are installed.
+
+== Creating Templates
+
+R2Doc searches a registered list of directories for templates.	Additional
+directories may be added by calling TemplateManager.add_template_directory
+Templates are folders within registered directories.  So, the default
+directory registered by the gem is lib/r2doc/template (relative to the
+directory where the gem is installed) and the default r2doc template is in the
+folder named lib/r2doc/template/r2doc.
+
+The generator requires template files for index.html, class.html,
+file.html, and rdoc.js.  All non-template files within the template folder
+are copied to the output directory unchanged (this is useful for supporting
+files such as images and stylesheets).	The best reference for writing
+templates are the included template files themselves.  Utility methods
+specific to templates can be found in the R2Doc::TemplateUtil module.  It
+may also be useful to look over the additions to the context objects, which
+are found in the R2Doc::ContextExtensions, R2Doc::ClassExtensions, and
+R2Doc::MethodExtensions modules.
+
+== Creating New Template Engines
+
+Requirements for template engines are explained in the
+R2Doc::TemplateManager class.  Additional engines can be added by calling
+TemplateManager.register_engine.

data/README.rdoc

@@ -0,0 +1,103 @@
+= R2Doc
+
+R2Doc began as a desire to to create a format for Ruby and Rails
+documentation that would be more useful than anything currently available
+(or at least more useful to me).  Specifically, I had a small set of goals:
+
+* To get rid of the really awful frames
+* To allow easy searching by class or method name
+* To make it easier to scan the lists of methods and attributes
+* To limit line length for easier viewing on wide browsers
+
+As RDoc version 1.0.1 was already packaged as part of the Ruby core and
+version 2 did not yet appear to be stable when I started, I began by
+building a template for version 1.  As soon as I scratched the surface of
+RDoc, I became immediately dismayed by what I found.  The template format
+was arcane, and much of the presentation logic I hoped to change was
+embedded in the generator code.  R2Doc quickly evolved into more than just
+another template.  While still in its very early stages of development,
+R2Doc is a generator that is more easily extended and is very much a second
+set of thoughts on what a framework for documentation generators could and
+_should_ be.  It is my hope that, more than anything, R2Doc will be a
+contribution to the dialog about the future directions of RDoc.
+
+== Features
+
+[RDoc version independent]
+  The R2Doc generator is not limited to a particular version of RDoc.  It
+  has been tested to work with version 1.0.1 and 2.3.0.  Additional
+  versions will be tested as development progresses.
+[Support for multiple templates]
+  While others will hopefully find the default template useful, some people
+  will almost certainly have different preferences for the format.  The
+  beauty of R2Doc is not in its template, but rather in the facilities it
+  provides for creating templates more easily.
+[Pushes presentation logic into the template]
+  My biggest gripe with the current version of RDoc is that more attention
+  should be paid to what makes Rails so successful as a web development
+  framework.  Part of what really works for Rails is that it makes it easy
+  to build an application using a straight-forward MVC pattern and
+  encourages a clean separation between each of the three components of that
+  architecture.  RDoc is made up of parts which correspond to each of those
+  components as well.  A generator is a controller; the context objects
+  representing the classes, modules, files, and methods found in the code are
+  models; and a template is a view.  R2Doc extends the model classes with
+  methods that provide information about the code being documented without
+  directly generating HTML.  This pushes presentation logic into the view,
+  making for cleaner code and more powerful templates.
+[More powerful capabilities within the templates]
+  Another key to the success of Rails is the large collection of utility
+  methods which are specifically made available for use within views.  They
+  make common coding tasks easier to accomplish.	R2Doc adds a small
+  collection of utility methods specifically design to facilitate template
+  authoring.
+[Extensible set of template formats]
+  R2Doc provides an ERB engine for templates by default, but it is not
+  limited to only ERB templates.	Much like Rails, the file extension of a
+  template dictates which engine it is written for.  Template engines can be
+  added to R2Doc and registered to work with additional extensions.  So,
+  engines can easily be added to allow template creation in HAML, XML
+  builder, or nearly anything else you care for.
+
+== Usage
+
+R2Doc is a standard generator, and, as such, can be specified using the
+<tt>-f</tt> or <tt>--fmt</tt> options with the <tt>rdoc</tt> command.  Its
+gem will be automatically discovered by version 2 of RDoc, but version 1 is
+slightly trickier as it relies on the <tt>$:</tt> variable.  To facilitate
+use, R2Doc provides the <tt>r2doc</tt> command.  It's usage is:
+
+  r2doc [options] [names...]     # normal usage
+  r2doc [options] --gems gems... # generate docs for installed gems
+
+The first usage sets options for using R2Doc as the generator and passes
+everything else on to <tt>rdoc</tt>.  The second usage is a specialized
+form for generating docs for an installed gem using the R2Doc generator. 
+By default <tt>r2doc</tt> uses whatever version of RDoc is your default,
+but it includes one additional option, <tt>--rdoc-version</tt>, which allows
+you to specify the RDoc version when multiple gems are installed.
+
+== Creating Templates
+
+R2Doc searches a registered list of directories for templates.	Additional
+directories may be added by calling TemplateManager.add_template_directory
+Templates are folders within registered directories.  So, the default
+directory registered by the gem is lib/r2doc/template (relative to the
+directory where the gem is installed) and the default r2doc template is in the
+folder named lib/r2doc/template/r2doc.
+
+The generator requires template files for index.html, class.html,
+file.html, and rdoc.js.  All non-template files within the template folder
+are copied to the output directory unchanged (this is useful for supporting
+files such as images and stylesheets).	The best reference for writing
+templates are the included template files themselves.  Utility methods
+specific to templates can be found in the R2Doc::TemplateUtil module.  It
+may also be useful to look over the additions to the context objects, which
+are found in the R2Doc::ContextExtensions, R2Doc::ClassExtensions, and
+R2Doc::MethodExtensions modules.
+
+== Creating New Template Engines
+
+Requirements for template engines are explained in the
+R2Doc::TemplateManager class.  Additional engines can be added by calling
+TemplateManager.register_engine.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'echoe'
+
+Echoe.new('R2Doc') do |p|
+  p.author = 'Jeffrey Hunter and Mission Critical Labs, Inc.'
+  p.summary = 'An extensible RDoc generator using ERB'
+  p.description = 'R2Doc is an improved generator for RDoc. It provides an improved output template for documentation (including search and frameless navigation), but also aims to be more extensible so that template authoring is an easier task with a wider set of options.'
+  p.url = 'http://r2doc.org'
+  p.email = 'r2doc@missioncriticallabs.com'
+end

data/bin/r2doc

@@ -0,0 +1,157 @@
+#!/usr/bin/env ruby
+#
+# r2doc is a wrapper script for using the r2doc generator with rdoc.
+#
+# Usage:
+#
+#  r2doc [options] [names...]
+#  r2doc [options] --gems gems...
+#
+# The second format generates documentation for the named gems.  All
+# other options are passed to rdoc.  See the RDoc documenation for more
+# information.
+#
+
+require 'rubygems'
+require 'r2doc'
+
+# Output a help message and continue
+def help_message
+  $stderr.puts <<-EOM
+  Usage:
+
+    r2doc [options] [names...]
+    r2doc [options] --gems gems...
+
+  The first format calls rdoc normally with r2doc set as
+  the generator.  The second format sets rdoc as the
+  generator and generates documentation for the named
+  gems.  One additional option (see below) is specific to
+  r2doc.  All other options are passed through to rdoc.
+  Help for rdoc follows.
+  
+  r2doc-specifc options:
+  
+    --rdoc-version version
+                    Specifices the rdoc version to require.
+                    The version string is passed to gem.
+
+EOM
+end
+
+# Pre-processes arguments before padding to rdoc.
+#
+# This method attempts to be forward-compatible by following very generic
+# rules for processing options.  Theoretically it could handle the short
+# format option (f) incorrectly, because without knowledge of the
+# supported short options, if the f option follows a series of short
+# options which do not accept arguments, it becomes ambiguous.  For
+# example, in the following contrived scenario you can only distinguish
+# between the two uses correctly if you know that the o option accepts
+# and argument and the a flag does not:
+#
+#   r2doc -afchm  # equivalent of -a -f chm
+#   r2doc -aofchm # equivalent of -a -o fchm
+#
+# The risk here seems pretty minimal, however, since something's probably
+# amiss anyway if you're passing the format option to r2doc.
+def process_r2doc_args(args, overrides)
+  processed = []
+  local_options = {}
+  
+  # add the overrides first
+  overrides.each do |o|
+    processed.push "--#{o[0]}"
+    processed.push o[2]
+  end
+  
+  while args.length > 0 do
+    thisOpt = args.shift
+    thisParam = nil
+    if thisOpt =~ /^-/
+      # -- signals the end of options
+      if thisOpt == '--'
+        processed.push thisOpt
+        processed.concat(args) if args.length > 0
+        return processed, local_options
+      end
+      
+      # this is an option, see if we have an argument
+      if longMatch = /^--([^=]+)=(.*)/.match(thisOpt)
+        if longMatch[1] == 'rdoc-version'
+          local_options['rdoc-version'] = longMatch[2]
+        else
+          # don't pass overrides through
+          processed.push thisOpt unless overrides.find{|o| o[0] == longMatch[1]}
+        end
+      elsif longMatch = /^--(.*)/.match(thisOpt)
+        # special case for help, gems, and rdoc-version options
+        if longMatch[1] == 'help'
+          help_message
+          processed.push thisOpt
+        elsif longMatch[1] == 'gems'
+          local_options['gems'] = args
+          return processed, local_options
+        elsif longMatch[1] == 'rdoc-version'
+          local_options['rdoc-version'] = args.shift
+        else
+          # an argument could follow as the next item
+          thisParam = args.shift unless args.first =~ /^-/
+          unless overrides.find{|o| o[0] == longMatch[1]}
+            processed.push thisOpt
+            processed.push thisParam unless thisParam.nil?
+          end
+        end
+      else
+        # short option
+        flag = thisOpt.slice(1, thisOpt.length - 1)
+        if flag == 'h' || flag == '?'
+          help_message
+          processed.push thisOpt
+        else
+          thisParam = args.shift unless args.first =~ /^-/
+          unless overrides.find{|o| o[1] == flag}
+            processed.push thisOpt
+            processed.push thisParam unless thisParam.nil?
+          end
+        end
+      end
+    else
+      # not an option, so processing stops
+      processed.push thisOpt
+      processed.concat(args) if args.length > 0
+      return processed, local_options
+    end
+  end
+  
+  return processed, local_options
+end
+
+begin
+  arguments, local_options = process_r2doc_args(ARGV, [['fmt', 'f', 'r2doc']])
+
+  gem 'rdoc', local_options['rdoc-version'] if local_options.has_key?('rdoc-version')
+  require 'rdoc/rdoc'
+
+  # for gems
+  if local_options.has_key?('gems') && local_options['gems'].length > 0
+    require 'rubygems/doc_manager'
+    Gem::DocManager.configured_args = arguments
+    specs = local_options['gems'].inject([]) do |s,name|
+      found = Gem::SourceIndex.from_installed_gems.find_name(name)
+      spec = found.sort_by {|g| g.version }.last
+      s << spec if spec
+      s
+    end
+    specs.each{|s| Gem::DocManager.new(s).generate_rdoc}
+    
+  # default
+  else
+    r = RDoc::RDoc.new
+    r.document(arguments)
+  end
+
+rescue StandardError => e
+  $stderr.puts e.message
+  exit(1)
+end