README.md in block_chain-0.1.0 vs README.md in block_chain-0.2.0
- old
+ new
@@ -1,8 +1,8 @@
# BlockChain
-[](http://travis-ci.org/amarshall/block_chain)
+[](http://travis-ci.org/amarshall/block_chain)
Makes it easy to chain nested blocks together without creating a ton of nesting.
## Installation
@@ -37,10 +37,19 @@
require 'block_chain'
methods = [:foo, :bar, :baz, :qux].map { |name| method name }
BlockChain.new(*methods).call { yield }
```
-This can make deeply-nested block wrappings a bit more digestable.
+or even this:
+
+```ruby
+require 'block_chain'
+BlockChain.new(:foo, :bar, :baz, :qux).call(self) { yield }
+```
+
+With the last form, the argument given to `call` is the receiver of the methods (since the receiver cannot be implicit, it must be explicitly specified). Also note that this form does not work in JRuby or Rubinius due to a bug. A gap in RubySpec was found as a result of this feature, see [RubySpec #174](https://github.com/rubyspec/rubyspec/pull/174).
+
+This can make deeply-nested block wrappings a bit more digestable. For more details, read the specs, they’re short and descriptive.
## Contributing
Contributions are welcome. Please be sure that your pull requests are atomic so they can be considered and accepted separately.