resolve path to something other than CWD
Additional documentation and bug fixes