Skip to content

Convert inline comments and examples to Rd documentation files

Notifications You must be signed in to change notification settings

tdhock/inlinedocs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

inlinedocs

Installation

As of 3 June 2014, inlinedocs from R-Forge is deprecated (please do not use it). Please instead install from CRAN or this GitHub repository,

install.packages("inlinedocs")

if(!requireNamespace("remotes"))install.packages("remotes")
remotes::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.

About

Convert inline comments and examples to Rd documentation files

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published