adds several new methods for filtering and resolving paths, updates read...

...me with docs