learned roxygen notation, added notes