blockenspiel 0.3.2 → 0.3.3

data/Blockenspiel.rdoc

@@ -304,7 +304,7 @@ multiple threads trying to mix methods into the same object concurrently.
 === Requirements
 
 * Ruby 1.8.6 or later (1.8.7 recommended), Ruby 1.9.1 or later, or JRuby 1.2
-  or later (1.4 recommended).
+  or later (1.5 recommended).
 
 === Installation
 
@@ -314,8 +314,8 @@ multiple threads trying to mix methods into the same object concurrently.
 
 * Implementing wildcard DSL methods using <tt>method_missing</tt> doesn't
   work. I haven't yet figured out the right semantics for this case.
-* Including Blockenspiel::DSL in a module is not yet supported, but this
-  is planned in a future release.
+* Including Blockenspiel::DSL in a module (rather than a class) is not yet
+  supported, but this is planned in a future release.
 
 === Development and support
 
@@ -347,7 +347,7 @@ Luis Lavena.
 
 === License
 
-Copyright 2008-2009 Daniel Azuma.
+Copyright 2008-2010 Daniel Azuma.
 
 All rights reserved.
 

data/History.rdoc

@@ -1,3 +1,8 @@
+=== 0.3.3 / 2010-05-24
+
+* Some Rakefile fixes to match RDoc and Ruby 1.9 changes.
+* Minor documentation updates.
+
 === 0.3.2 / 2009-11-17
 
 * Modules included in a DSL-ized class now have their methods included in

data/ImplementingDSLblocks.rdoc

@@ -879,7 +879,7 @@ This requires dynamic generation of the proxy class. We could implement it using
     def add_route(path, options = {})
       # ...
 
-You can install blockenspiel as a gem. It is compatible with MRI 1.8.7 or later, MRI 1.9.1 or later, and JRuby 1.2 or later.
+You can install blockenspiel as a gem. It is compatible with MRI 1.8.7 or later, MRI 1.9.1 or later, and JRuby 1.5 or later.
 
   gem install blockenspiel
 
@@ -937,4 +937,4 @@ The Blockenspiel library provides a concrete and robust implementation of DSL bl
 
 === About the author
 
-Daniel Azuma is Chief Software Architect at GeoPage. He has been working with Ruby for about three years, and finds the language generally pleasant to work with, though he thinks the scoping rules could use some improvement. His home page is at http://www.daniel-azuma.com/
+Daniel Azuma is Chief Software Architect at GeoPage. He has been working with Ruby since 2005, and finds the language generally pleasant to work with, though he thinks the scoping rules could use some improvement. His home page is at http://www.daniel-azuma.com/

data/README.rdoc

@@ -56,7 +56,7 @@ For an extended analysis of different ways to implement DSL blocks, see
 === Requirements
 
 * Ruby 1.8.6 or later (1.8.7 recommended), Ruby 1.9.1 or later, or JRuby 1.2
-  or later (1.4 recommended).
+  or later (1.5 recommended).
 
 === Installation
 
@@ -66,8 +66,8 @@ For an extended analysis of different ways to implement DSL blocks, see
 
 * Implementing wildcard DSL methods using <tt>method_missing</tt> doesn't
   work. I haven't yet figured out the right semantics for this case.
-* Including Blockenspiel::DSL in a module is not yet supported, but this
-  is planned in a future release.
+* Including Blockenspiel::DSL in a module (rather than a class) is not yet
+  supported, but this is planned in a future release.
 
 === Development and support
 
@@ -96,7 +96,7 @@ Blockenspiel for now, to reduce dependencies.
 
 === License
 
-Copyright 2008-2009 Daniel Azuma.
+Copyright 2008-2010 Daniel Azuma.
 
 All rights reserved.
 

data/Rakefile

@@ -37,6 +37,8 @@ require 'rake/clean'
 require 'rake/gempackagetask'
 require 'rake/testtask'
 require 'rake/rdoctask'
+require 'rdoc'
+require 'rdoc/rdoc'
 require 'rdoc/generator/darkfish'
 
 require ::File.expand_path("#{::File.dirname(__FILE__)}/lib/blockenspiel/version")
@@ -75,7 +77,7 @@ end
 gemspec_ = ::Gem::Specification.new do |s_|
   s_.name = 'blockenspiel'
   s_.summary = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks.'
-  s_.version = ::Blockenspiel::VERSION_STRING
+  s_.version = ::Blockenspiel::VERSION_STRING.dup
   s_.author = 'Daniel Azuma'
   s_.email = 'dazuma@gmail.com'
   s_.description = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks. It is designed to be comprehensive and robust, supporting most common usage patterns, and working correctly in the presence of nested blocks and multithreading.'
@@ -190,9 +192,17 @@ task :release_gem_to_gemcutter => [:package] do |t_|
   if v_ != ::Blockenspiel::VERSION_STRING
     abort "Versions don't match: #{v_} vs #{::Blockenspiel::VERSION_STRING}"
   end
+  mri_gem_ = "blockenspiel-#{v_}.gem"
+  jruby_gem_ = "blockenspiel-#{v_}-java.gem"
+  if !::File.file?("pkg/#{mri_gem_}") || !::File.readable?("pkg/#{mri_gem_}")
+    abort "You haven't built #{mri_gem_} yet. Try rake package"
+  end
+  if !::File.file?("pkg/#{jruby_gem_}") || !::File.readable?("pkg/#{jruby_gem_}")
+    abort "You haven't built #{jruby_gem_} yet. Try jrake package"
+  end
   puts "Releasing blockenspiel #{v_} to GemCutter"
-  `cd pkg && gem push blockenspiel-#{v_}.gem`
-  `cd pkg && gem push blockenspiel-#{v_}-java.gem`
+  `cd pkg && gem push #{mri_gem_}`
+  `cd pkg && gem push #{jruby_gem_}`
 end
 
 

data/lib/blockenspiel/impl.rb

@@ -505,8 +505,9 @@ module Blockenspiel
     # 
     # If you want your method to take a block, you have several options
     # depending on your Ruby version. If you are running the standard Matz
-    # Ruby interpreter (MRI) version 1.8.7 or later (including 1.9.x), you
-    # can use the standard "&" block argument notation to receive the block.
+    # Ruby interpreter (MRI) version 1.8.7 or later (including 1.9.x), or a
+    # compatible interpreter such as JRuby 1.5 or later, you can use the
+    # standard "&" block argument notation to receive the block.
     # Note that you must call the passed block using the +call+ method since
     # Ruby doesn't support invoking such a block with +yield+.
     # For example, to create a method named "foo" that takes one parameter
@@ -521,15 +522,11 @@ module Blockenspiel
     # 
     #  foo("hello"){ "a value" }
     # 
-    # If you are using MRI 1.8.6, however, the parser does not support
-    # passing a block argument to a block. Oddly, the current version of
-    # JRuby (version 1.4.0 as of this writing) also does not support this
-    # syntax, though it claims MRI 1.8.7 compatibility. (See bug JRUBY-4180
-    # to track this issue.) If your Ruby interpreter doesn't support the
-    # standard way to create a method that takes a block, Blockenspiel
-    # provides an alternative in the form of the <tt>:block</tt> option.
-    # This option causes blocks provided by the caller to be included in
-    # the normal parameter list to your method, instead of as a block
+    # If you are using MRI 1.8.6, or another Ruby interpreter that doesn't
+    # fully support this syntax (such as JRuby versions older than 1.5),
+    # Blockenspiel provides an alternative in the form of the <tt>:block</tt>
+    # option. This option causes blocks provided by the caller to be included
+    # in the normal parameter list to your method, instead of as a block
     # parameter. It can be set to <tt>:first</tt> or <tt>:last</tt> to
     # prepend or append, respectively, the block (as a +Proc+ object) to
     # the parameter list. If the caller does not include a block when

data/lib/blockenspiel/version.rb

@@ -37,7 +37,7 @@
 module Blockenspiel
   
   # Current gem version, as a frozen string.
-  VERSION_STRING = '0.3.2'.freeze
+  VERSION_STRING = '0.3.3'.freeze
   
   autoload(:VERSION, ::File.dirname(__FILE__)+'/versionomy.rb')
   

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: blockenspiel
 version: !ruby/object:Gem::Version 
-  version: 0.3.2
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 3
+  version: 0.3.3
 platform: ruby
 authors: 
 - Daniel Azuma
@@ -9,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-17 00:00:00 -08:00
+date: 2010-05-24 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -55,21 +61,29 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 59
+      segments: 
+      - 1
+      - 8
+      - 6
       version: 1.8.6
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: virtuoso
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Blockenspiel is a helper library designed to make it easy to implement DSL blocks.