added roxygen docs to new functions