adding path-based methods to watcher class and improving documentation