Create Doxygen Documentation for Source Code

Create doxygen documentation for source code in R packages. Includes a RStudio Addin, that allows to trigger the doxygenize process.


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

❗️ 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 CTRL+SHIFT+-). This makes the user experience comparable to roxygen2 documentation via devtools::document() (usually CTRL+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.

News

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("rdoxygen")

1.0.0 by Clemens Schmid, 2 years ago


https://github.com/nevrome/rdoxygen


Report a bug at https://github.com/nevrome/rdoxygen/issues


Browse source code at https://github.com/cran/rdoxygen


Authors: Clemens Schmid [cre, cph, aut]


Documentation:   PDF Manual  


GPL-2 | file LICENSE license


Imports devtools

Suggests testthat

System requirements: doxygen


See at CRAN