allow custom selector, added documentation