Installation
As of 3 June 2014, inlinedocs from R-Forge is deprecated (please do not use it). To install the up-to-date inlinedocs from this GitHub repository,
if(!requireNamespace("devtools"))install.packages("devtools")
devtools::install_github("tdhock/inlinedocs")Write documentation in comments
See the R-Forge page for a summary of the kinds of comments that are recognized as documentation by the default inlinedocs Parser Functions.
Convert comments to documentation
Read comments in pkg/R/*.R files, then generate pkg/man/*.Rd files:
inlinedocs::package.skeleton.dx("path/to/your/pkg")Write your own Parser Function to extend inlinedocs
Don’t like the default syntax? Want to add a new feature? You can write your own Parser Functions that take your code/comments from *.R files as input, and return documentation as output. Please read the JSS paper for an overview of how this works, and see inst/testfiles/alternate.R for an example.