re-roxygenised (ated?) docs with upgrade to roxygen