Add some docstring to prevent warning messages

- Some coding in tools.R giving more details to function
- New *.Rd files generated from running roxygen2::roxygenise()

/cc @mkcor