builder 2.0.0 → 2.1.1

data/CHANGES

@@ -1,5 +1,25 @@
 = Change Log
 
+== Version 2.1.1
+
+* Fixed typo in XmlMarkup class docs (ident => indent). (from Martin
+  Fowler).
+* Removed extra directory indirection from legacy CVS to SVN move.
+* Removed some extraneous tabs from source.
+* Fixed test on private methods in blankslate to differentiate between
+  targetted and untargetted private methods.
+* Removed legacy capture of @self in XmlBase (@self was used back when
+  we used instance eval).
+* Added additional tests for global functions (both direct and included).
+
+== Version 2.1.0
+
+* Fixed bug in BlankSlate where including a module into Object could
+  cause methods to leak into BlankSlate.
+* Made BlankSlate available as its own gem.  Currently the builder gem
+  still directly includes the BlankSlate code.
+* Added reveal capability to BlankSlate.
+
 == Version 2.0.0
 
 * Added doc directory

data/README

@@ -19,7 +19,7 @@ Builder::XmlEvents:: Generate XML events (i.e. SAX-like)
 == Usage
 
   require 'rubygems'	
-  require_gem 'builder', '~> 1.2'
+  require_gem 'builder', '~> 2.0'
 
   builder = Builder::XmlMarkup.new
   xml = builder.person { |b| b.name("Jim"); b.phone("555-1234") }

data/Rakefile

@@ -19,7 +19,9 @@ end
 
 # Determine the current version of the software
 
-CURRENT_VERSION = '2.0.0'
+CLOBBER.include('pkg')
+
+CURRENT_VERSION = '2.1.1'
 PKG_VERSION = ENV['REL'] ? ENV['REL'] : CURRENT_VERSION
 
 SRC_RB = FileList['lib/**/*.rb']
@@ -64,6 +66,11 @@ PKG_FILES = FileList[
 PKG_FILES.exclude('test/testcssbuilder.rb')
 PKG_FILES.exclude('lib/builder/css.rb')
 
+BLANKSLATE_FILES = FileList[
+  'lib/blankslate.rb',
+  'test/testblankslate.rb'
+]
+
 if ! defined?(Gem)
   puts "Package Target requires RubyGEMs"
 else
@@ -74,35 +81,76 @@ else
     s.name = 'builder'
     s.version = PKG_VERSION
     s.summary = "Builders for MarkUp."
-    s.description = <<EOS
+    s.description = %{\
 Builder provides a number of builder objects that make creating structured data
 simple to do.  Currently the following builder objects are supported:
 
 * XML Markup
 * XML Events
-EOS
+}
 
     s.files = PKG_FILES.to_a
     s.require_path = 'lib'
     s.autorequire = 'builder'
-
+    
     s.test_files = PKG_FILES.select { |fn| fn =~ /^test\/test/ }
-
+    
     s.has_rdoc = true
     s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
     s.rdoc_options <<
       '--title' <<  'Builder -- Easy XML Building' <<
       '--main' << 'README' <<
       '--line-numbers'
-
+    
     s.author = "Jim Weirich"
     s.email = "jim@weirichhouse.org"
     s.homepage = "http://onestepback.org"
   end
-
+  
+  blankslate_spec = Gem::Specification.new do |s|
+    
+    #### Basic information.
+    
+    s.name = 'blankslate'
+    s.version = PKG_VERSION
+    s.summary = "Blank Slate base class."
+    s.description = %{\
+BlankSlate provides a base class where almost all of the methods from Object and
+Kernel have been removed.  This is useful when providing proxy object and other
+classes that make heavy use of method_missing.  
+}
+    
+    s.files = BLANKSLATE_FILES.to_a
+    s.require_path = 'lib'
+    s.autorequire = 'builder'
+    
+    s.test_files = PKG_FILES.select { |fn| fn =~ /^test\/test/ }
+    
+    s.has_rdoc = true
+    s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
+    s.rdoc_options <<
+      '--title' <<  'BlankSlate -- Base Class for building proxies.' <<
+      '--main' << 'README' <<
+      '--line-numbers'
+    
+    s.author = "Jim Weirich"
+    s.email = "jim@weirichhouse.org"
+    s.homepage = "http://onestepback.org"
+  end
+  
+  namespace 'builder' do
     Rake::GemPackageTask.new(spec) do |t|
       t.need_tar = true
     end
+  end
+  
+  namespace 'blankslate' do
+    Rake::GemPackageTask.new(blankslate_spec) do |t|
+      t.need_tar = true
+    end
+  end
+
+  task :package => ['builder:package', 'blankslate:package']
 end
 
 desc "Look for Debugging print lines"

data/doc/releases/builder-2.1.1.rdoc

@@ -0,0 +1,58 @@
+= Builder 2.1.1 Released.
+
+Release 2.1.1 of Builder is mainly a bug fix release.
+
+== Changes in 2.1.1
+
+* Added <tt>reveal</tt> capability to BlankSlate.
+
+* Fixed a bug in BlankSlate where including a module into Object could
+  cause methods to leak into BlankSlate.
+
+* Fixed typo in XmlMarkup class docs (from Martin Fowler).
+
+* Fixed test on private methods to differentiate between targetted and
+  untargetted private methods.
+
+* Removed legacy capture of @self in XmlBase (@self was used back when
+  we used instance eval).
+
+* Added additional tests for global functions (both direct and
+  included).
+
+* Several misc internal cleanups, including rearranging the source
+  code tree.
+
+<b>NOTE:</b> The escaping attribute values by default is different
+than in previous releases of Builder.  This makes version 2.0.x
+somewhat incompatible with the 1.x series of Builder.  If you use "&",
+"<", or ">" in attributes values, you may have to change your
+code. (Essentially you remove the manual escaping.  The new way is
+easier, believe me).
+
+== What is Builder?
+
+Builder::XmlMarkup is a library that allows easy programmatic creation
+of XML markup.  For example:
+
+  builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
+  builder.person { |b| b.name("Jim"); b.phone("555-1234") }
+
+will generate:
+
+  <person>
+    <name>Jim</name>
+    <phone>555-1234</phone>
+  </person>
+
+== Availability
+
+The easiest way to get and install builder is via RubyGems ...
+
+  gem install builder    (you may need root/admin privileges)
+
+== Thanks
+
+* Martin Fowler for spotting some typos in the documentation.
+
+-- Jim Weirich

data/lib/blankslate.rb

@@ -0,0 +1,111 @@
+#!/usr/bin/env ruby
+#--
+# Copyright 2004, 2006 by Jim Weirich (jim@weirichhouse.org).
+# All rights reserved.
+
+# Permission is granted for use, copying, modification, distribution,
+# and distribution of modified versions of this work as long as the
+# above copyright notice is included.
+#++
+
+######################################################################
+# BlankSlate provides an abstract base class with no predefined
+# methods (except for <tt>\_\_send__</tt> and <tt>\_\_id__</tt>).
+# BlankSlate is useful as a base class when writing classes that
+# depend upon <tt>method_missing</tt> (e.g. dynamic proxies).
+#
+class BlankSlate
+  class << self
+    
+    # Hide the method named +name+ in the BlankSlate class.  Don't
+    # hide +instance_eval+ or any method beginning with "__".
+    def hide(name)
+      if instance_methods.include?(name.to_s) and
+        name !~ /^(__|instance_eval)/
+        @hidden_methods ||= {}
+        @hidden_methods[name.to_sym] = instance_method(name)
+        undef_method name
+      end
+    end
+
+    def find_hidden_method(name)
+      @hidden_methods ||= {}
+      @hidden_methods[name] || superclass.find_hidden_method(name)
+    end
+
+    def reveal(name)
+      bound_method = nil
+      unbound_method = find_hidden_method(name)
+      fail "Don't know how to reveal method '#{name}'" unless unbound_method
+      define_method(name) do |*args|
+        bound_method ||= unbound_method.bind(self)
+        bound_method.call(*args)
+      end
+    end
+  end
+  
+  instance_methods.each { |m| hide(m) }
+end
+
+######################################################################
+# Since Ruby is very dynamic, methods added to the ancestors of
+# BlankSlate <em>after BlankSlate is defined</em> will show up in the
+# list of available BlankSlate methods.  We handle this by defining a
+# hook in the Object and Kernel classes that will hide any method
+# defined after BlankSlate has been loaded.
+#
+module Kernel
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+
+    # Detect method additions to Kernel and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Kernel
+      BlankSlate.hide(name)
+      result
+    end
+  end
+end
+
+######################################################################
+# Same as above, except in Object.
+#
+class Object
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+
+    # Detect method additions to Object and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Object
+      BlankSlate.hide(name)
+      result
+    end
+
+    def find_hidden_method(name)
+      nil
+    end
+  end
+end
+
+######################################################################
+# Also, modules included into Object need to be scanned and have their
+# instance methods removed from blank slate.  In theory, modules
+# included into Kernel would have to be removed as well, but a
+# "feature" of Ruby prevents late includes into modules from being
+# exposed in the first place.
+#
+class Module
+  alias blankslate_original_append_features append_features
+  def append_features(mod)
+    result = blankslate_original_append_features(mod)
+    return result if mod != Object
+    instance_methods.each do |name|
+      BlankSlate.hide(name)
+    end
+    result
+  end
+end

data/lib/builder/blankslate.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 #--
-# Copyright 2004 by Jim Weirich (jim@weirichhouse.org).
+# Copyright 2004, 2006 by Jim Weirich (jim@weirichhouse.org).
 # All rights reserved.
 
 # Permission is granted for use, copying, modification, distribution,
@@ -8,56 +8,13 @@
 # above copyright notice is included.
 #++
 
-module Builder
-
-  # BlankSlate provides an abstract base class with no predefined
-  # methods (except for <tt>\_\_send__</tt> and <tt>\_\_id__</tt>).
-  # BlankSlate is useful as a base class when writing classes that
-  # depend upon <tt>method_missing</tt> (e.g. dynamic proxies).
-  class BlankSlate
-    class << self
-
-      # Hide the method named +name+ in the BlankSlate class.  Don't
-      # hide +instance_eval+ or any method beginning with "__".
-      def hide(name)
-	undef_method name if
-	  instance_methods.include?(name.to_s) and
-	  name !~ /^(__|instance_eval)/
-      end
-    end
-
-    instance_methods.each { |m| hide(m) }
-  end
-end
+require 'blankslate'
 
-# Since Ruby is very dynamic, methods added to the ancestors of
-# BlankSlate <em>after BlankSlate is defined</em> will show up in the
-# list of available BlankSlate methods.  We handle this by defining a
-# hook in the Object and Kernel classes that will hide any defined
-module Kernel
-  class << self
-    alias_method :blank_slate_method_added, :method_added
-
-    # Detect method additions to Kernel and remove them in the
-    # BlankSlate class.
-    def method_added(name)
-      blank_slate_method_added(name)
-      return if self != Kernel
-      Builder::BlankSlate.hide(name)
-    end
-  end
-end
-
-class Object
-  class << self
-    alias_method :blank_slate_method_added, :method_added
-
-    # Detect method additions to Object and remove them in the
-    # BlankSlate class.
-    def method_added(name)
-      blank_slate_method_added(name)
-      return if self != Object
-      Builder::BlankSlate.hide(name)
-    end
-  end
+######################################################################
+# BlankSlate has been promoted to a top level name and is now
+# available as a standalone gem.  We make the name available in the
+# Builder namespace for compatibility.
+#
+module Builder
+  BlankSlate = ::BlankSlate
 end

data/lib/builder/xchar.rb

@@ -73,7 +73,7 @@ module Builder
 
     # See http://www.w3.org/TR/REC-xml/#charsets for details.
     VALID = [
-      [0x9, 0xA, 0xD],
+      0x9, 0xA, 0xD,
       (0x20..0xD7FF), 
       (0xE000..0xFFFD),
       (0x10000..0x10FFFF)
@@ -92,8 +92,11 @@ class Fixnum
   # XML escaped version of chr
   def xchr
     n = XChar::CP1252[self] || self
-    n = 42 unless XChar::VALID.find {|range| range.include? n}
-    XChar::PREDEFINED[n] or (n<128 ? n.chr : "&##{n};")
+    case n when *XChar::VALID
+      XChar::PREDEFINED[n] or (n<128 ? n.chr : "&##{n};")
+    else
+      '*'
+    end
   end
 end
 

data/lib/builder/xmlbase.rb

@@ -39,37 +39,36 @@ module Builder
       attrs = nil
       sym = "#{sym}:#{args.shift}" if args.first.kind_of?(Symbol)
       args.each do |arg|
-	case arg
-	when Hash
-	  attrs ||= {}
-	  attrs.merge!(arg)
-	else
-	  text ||= ''
-	  text << arg.to_s
-	end
+        case arg
+        when Hash
+          attrs ||= {}
+          attrs.merge!(arg)
+        else
+          text ||= ''
+          text << arg.to_s
+        end
       end
       if block
-	unless text.nil?
-	  raise ArgumentError, "XmlMarkup cannot mix a text argument with a block"
-	end
-	_capture_outer_self(block) if @self.nil?
-	_indent
-	_start_tag(sym, attrs)
-	_newline
-	_nested_structures(block)
-	_indent
-	_end_tag(sym)
-	_newline
+        unless text.nil?
+          raise ArgumentError, "XmlMarkup cannot mix a text argument with a block"
+        end
+        _indent
+        _start_tag(sym, attrs)
+        _newline
+        _nested_structures(block)
+        _indent
+        _end_tag(sym)
+        _newline
       elsif text.nil?
-	_indent
-	_start_tag(sym, attrs, true)
-	_newline
+        _indent
+        _start_tag(sym, attrs, true)
+        _newline
       else
-	_indent
-	_start_tag(sym, attrs)
-	text! text
-	_end_tag(sym)
-	_newline
+        _indent
+        _start_tag(sym, attrs)
+        text! text
+        _end_tag(sym)
+        _newline
       end
       @target
     end
@@ -120,10 +119,6 @@ module Builder
       _escape(text).gsub(%r{"}, '&quot;')  # " WART
     end
 
-    def _capture_outer_self(block)
-      @self = eval("self", block)
-    end
-    
     def _newline
       return if @indent == 0
       text! "\n"

data/lib/builder/xmlmarkup.rb

@@ -117,7 +117,7 @@ module Builder
   #
   #   Example:
   #
-  #     xm = Builder.new(:ident=>2)
+  #     xm = Builder.new(:indent=>2)
   #     # xm will produce nicely formatted and indented XML.
   #  
   #     xm = Builder.new(:indent=>2, :margin=>4)
@@ -209,18 +209,18 @@ module Builder
       _indent
       @target << "<!#{inst}"
       args.each do |arg|
-	case arg
-	when String
-	  @target << %{ "#{arg}"}
-	when Symbol
-	  @target << " #{arg}"
-	end
+        case arg
+        when String
+          @target << %{ "#{arg}"} # " WART
+        when Symbol
+          @target << " #{arg}"
+        end
       end
       if block_given?
-	@target << " ["
-	_newline
-	_nested_structures(block)
-	@target << "]"
+        @target << " ["
+        _newline
+        _nested_structures(block)
+        @target << "]"
       end
       @target << ">"
       _newline
@@ -238,15 +238,15 @@ module Builder
     def instruct!(directive_tag=:xml, attrs={})
       _ensure_no_block block_given?
       if directive_tag == :xml
-	a = { :version=>"1.0", :encoding=>"UTF-8" }
-	attrs = a.merge attrs
+        a = { :version=>"1.0", :encoding=>"UTF-8" }
+        attrs = a.merge attrs
       end
       _special(
-	"<?#{directive_tag}",
-	"?>",
-	nil,
-	attrs,
-	[:version, :encoding, :standalone])
+      "<?#{directive_tag}",
+      "?>",
+      nil,
+      attrs,
+      [:version, :encoding, :standalone])
     end
 
     # Insert a CDATA section into the XML markup.
@@ -299,27 +299,27 @@ module Builder
     def _insert_attributes(attrs, order=[])
       return if attrs.nil?
       order.each do |k|
-	v = attrs[k]
-	@target << %{ #{k}="#{_attr_value(v)}"} if v
+        v = attrs[k]
+        @target << %{ #{k}="#{_attr_value(v)}"} if v # " WART
       end
       attrs.each do |k, v|
-	@target << %{ #{k}="#{_attr_value(v)}"} unless order.member?(k)
+        @target << %{ #{k}="#{_attr_value(v)}"} unless order.member?(k) # " WART
       end
     end
 
     def _attr_value(value)
       case value
       when Symbol
-	value.to_s
+        value.to_s
       else
-	_escape_quote(value.to_s)
+        _escape_quote(value.to_s)
       end
     end
 
     def _ensure_no_block(got_block)
       if got_block
-	fail IllegalBlockError,
-	  "Blocks are not allowed on XML instructions"
+        fail IllegalBlockError,
+        "Blocks are not allowed on XML instructions"
       end
     end
 

data/test/preload.rb

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
 # We are defining method_added in Kernel and Object so that when
-# BlankSlate overrides them loater, we can verify that it correctly
+# BlankSlate overrides them later, we can verify that it correctly
 # calls the older hooks.
 
 module Kernel

data/test/testblankslate.rb

@@ -4,7 +4,33 @@ require 'test/unit'
 require 'test/preload'
 require 'builder/blankslate'
 
+# Methods to be introduced into the Object class late.
+module LateObject
+  def late_object
+    33
+  end
+  def LateObject.included(mod)
+    # Modules defining an included method should not prevent blank
+    # slate erasure!
+  end
+end
+
+# Methods to be introduced into the Kernel module late.
+module LateKernel
+  def late_kernel
+    44
+  end
+  def LateKernel.included(mod)
+    # Modules defining an included method should not prevent blank
+    # slate erasure!
+  end
+end
+
+# Introduce some late methods (both module and direct) into the Kernel
+# module.
 module Kernel
+  include LateKernel
+
   def late_addition
     1234
   end
@@ -19,39 +45,138 @@ module Kernel
 end
 
 
-
-class Object
+# Introduce some late methods (both module and direct) into the Object
+# class.
+class Object 
+  include LateObject
   def another_late_addition
     4321
   end
 end
 
+# Introduce some late methods by inclusion.
+module GlobalModule
+ def global_inclusion
+   42
+ end
+end
+include GlobalModule
+
+def direct_global
+  43
+end
+
+######################################################################
+# Test case for blank slate.
+#
 class TestBlankSlate < Test::Unit::TestCase
   def setup
-    @bs = Builder::BlankSlate.new
-  end
-  
-  def test_create
-    assert nil != @bs
+    @bs = BlankSlate.new
   end
 
-  def test_undefined
+  def test_undefined_methods_remain_undefined
     assert_raise(NoMethodError) { @bs.no_such_method }
     assert_raise(NoMethodError) { @bs.nil? }
   end
 
-  def test_no_later_additions
+
+  # NOTE: NameError is acceptable because the lack of a '.' means that
+  # Ruby can't tell if it is a method or a local variable.
+  def test_undefined_methods_remain_undefined_during_instance_eval
+    assert_raise(NoMethodError, NameError)  do
+      @bs.instance_eval do nil? end
+    end
+    assert_raise(NoMethodError, NameError)  do
+      @bs.instance_eval do no_such_method end
+    end
+  end
+
+  def test_private_methods_are_undefined
+    assert_raise(NoMethodError) do
+      @bs.puts "HI"
+    end
+  end
+  
+  def test_targetted_private_methods_are_undefined_during_instance_eval
+    assert_raise(NoMethodError, NameError) do
+      @bs.instance_eval do self.puts "HI" end
+    end
+  end
+  
+  def test_untargetted_private_methods_are_defined_during_instance_eval
+    oldstdout = $stdout
+    $stdout = StringIO.new
+    @bs.instance_eval do 
+      puts "HI"
+    end
+  ensure
+    $stdout = oldstdout
+  end
+  
+  def test_methods_added_late_to_kernel_remain_undefined
+    assert_equal 1234, nil.late_addition
     assert_raise(NoMethodError) { @bs.late_addition }
+  end
+
+  def test_methods_added_late_to_object_remain_undefined
+    assert_equal 4321, nil.another_late_addition
     assert_raise(NoMethodError) { @bs.another_late_addition }
   end
+  
+  def test_methods_added_late_to_global_remain_undefined
+    assert_equal 42, global_inclusion
+    assert_raise(NoMethodError) { @bs.global_inclusion }
+  end
 
   def test_preload_method_added
     assert Kernel.k_added_names.include?(:late_addition)
     assert Object.o_added_names.include?(:another_late_addition)
   end
 
-  def test_double_defined_method
-    assert_raise(NoMethodError) { @bs.double.late_addition }
+  def test_method_defined_late_multiple_times_remain_undefined
+    assert_equal 22, nil.double_late_addition
+    assert_raise(NoMethodError) { @bs.double_late_addition }
+  end
+
+  def test_late_included_module_in_object_is_ok
+    assert_equal 33, 1.late_object
+    assert_raise(NoMethodError) { @bs.late_object }
+  end
+
+  def test_late_included_module_in_kernel_is_ok
+    assert_raise(NoMethodError) { @bs.late_kernel }
+  end
+
+  def test_revealing_previously_hidden_methods_is_ok
+    with_to_s = Class.new(BlankSlate) do
+      reveal :to_s
+    end
+    assert_match /^#<.*>$/, with_to_s.new.to_s
+  end
+
+  def test_revealing_a_hidden_method_twice_is_ok
+    with_to_s = Class.new(BlankSlate) do
+      reveal :to_s
+      reveal :to_s
+    end
+    assert_match /^#<.*>$/, with_to_s.new.to_s
+  end
+
+  def test_revealing_unknown_hidden_method_is_an_error
+    assert_raises(RuntimeError) do
+      Class.new(BlankSlate) do
+        reveal :xyz
+      end
+    end
+  end
+
+  def test_global_includes_still_work
+    assert_nothing_raised do
+      assert_equal 42, global_inclusion
+      assert_equal 42, Object.new.global_inclusion
+      assert_equal 42, "magic number".global_inclusion
+      assert_equal 43, direct_global
+    end
   end
 end
 

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.11.6
+rubygems_version: 0.9.2
 specification_version: 1
 name: builder
 version: !ruby/object:Gem::Version 
-  version: 2.0.0
-date: 2006-02-05 00:00:00 -05:00
+  version: 2.1.1
+date: 2007-03-01 00:00:00 -05:00
 summary: Builders for MarkUp.
 require_paths: 
 - lib
@@ -25,32 +25,35 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
 platform: ruby
 signing_key: 
 cert_chain: 
+post_install_message: 
 authors: 
 - Jim Weirich
 files: 
+- lib/blankslate.rb
 - lib/builder.rb
-- lib/builder/xmlmarkup.rb
-- lib/builder/xmlbase.rb
 - lib/builder/blankslate.rb
-- lib/builder/xmlevents.rb
 - lib/builder/xchar.rb
-- test/testmarkupbuilder.rb
-- test/testblankslate.rb
+- lib/builder/xmlbase.rb
+- lib/builder/xmlevents.rb
+- lib/builder/xmlmarkup.rb
+- test/performance.rb
 - test/preload.rb
 - test/test_xchar.rb
+- test/testblankslate.rb
 - test/testeventbuilder.rb
-- test/performance.rb
+- test/testmarkupbuilder.rb
 - scripts/publish.rb
-- README
-- Rakefile
 - CHANGES
+- Rakefile
+- README
 - doc/releases/builder-1.2.4.rdoc
 - doc/releases/builder-2.0.0.rdoc
+- doc/releases/builder-2.1.1.rdoc
 test_files: 
-- test/testmarkupbuilder.rb
-- test/testblankslate.rb
 - test/test_xchar.rb
+- test/testblankslate.rb
 - test/testeventbuilder.rb
+- test/testmarkupbuilder.rb
 rdoc_options: 
 - --title
 - Builder -- Easy XML Building
@@ -58,11 +61,12 @@ rdoc_options:
 - README
 - --line-numbers
 extra_rdoc_files: 
-- README
-- Rakefile
 - CHANGES
+- Rakefile
+- README
 - doc/releases/builder-1.2.4.rdoc
 - doc/releases/builder-2.0.0.rdoc
+- doc/releases/builder-2.1.1.rdoc
 executables: []
 
 extensions: []