make path name configurable; add some doc comments