simplified roxygen docs for a fxn, updated readme, fixes #17