document :blocking and :overlap
be Ruby 1.8 friendly