roxygenise rex_mode's documentation

Add roxygen2 tags to the details section, and a short description. Being explicit is good (except before 9pm on national television)