added notes to read me
collision test may now return a set of keys, rather than a set of objects, when a boolean is supplied as an argument