fixed broken tests / updated Rakefile to generate rdocs / added gemfile / added :selection_scope option to items to control how selection is calculated.