documented API in readme and tweaked path selectors to allow normal regexes