Create Doxygen Documentation for Source Code.
rdoxygen
R package for the automatic creation of doxygen documentation for source code in R packages.
It's based on cmbarbus answer to this stackoverflow question.
Installation
:exclamation: To use rdoxygen you need a working installation of the system program doxygen.
You can install the development version of rdoxygen with devtools via
if(!require('devtools')) install.packages('devtools')
library(devtools)
install_github('nevrome/rdoxygen')
Usage
To setup and afterwards update your doxygen documentation, you can simply run
doxy()
in your package root directory. doxy()
calls doxy_init()
if there's no Doxyfile (doxygen configuration file) yet. Otherwise it just updates the documentation.
The package provides a RStudio Addin named rdoxygenize that binds to the function doxy()
. doxy()
can therefore be called with a keyboard shortcut (I personally use CTR/kbd+SHIFT+-). This makes the user experience comparable to roxygen2 documentation via devtools::document()
(usually CTR/kbd+SHIFT+D).
doxy_edit()
allows to change settings in the Doxyfile. For example to also include private elements, you can call
doxy_edit(options = c("EXTRACT_PRIVATE" = "YES"))
Licence
rdoxygen is released under the GNU General Public Licence, version 2. Comments and feedback are welcome, as are code contributions.