R create reference manual with R CMD check

Question

I am writing an R package and would like to make a pdf reference manual of all functions in the package. I understood from here that R CMD check automatically c

Answer 1

I had the same issue. It seems that when you click Build or Check in Rstudio (when using devtools), by default arguments of '--no-manual' are added to the R CMD options.

I solved this by manually giving the arguments in the R command prompt:

library(devtools)

check(cleanup = FALSE,manual = TRUE,path = getwd())

# without running the examples
check(cleanup = FALSE,args = c('--no-examples'),manual = TRUE,path = getwd())

In this case, a folder called package.Rcheck will contain the manual as package-manual.pdf

Also check for any errors in the output during the check. There might be characters that might crash the documentation.

Answer 2

Another way is to create the reference manual directly using:

R CMD Rd2pdf mypackage

where mypackage is the folder containing your R package code folder structure including the man folder with your .Rd files.

For some reason I never get the reference manual during build or check in RStudio, maybe because I've missed a setting somewhere. But running the command like this works fine as well.

Answer 3

Another workaround is to produce it with:

build_manual(path=getwd())
#or
check(manual = TRUE, args="--output=~/folder/subfolder")

Answer 4

R CMD check creates a directory PACKAGE.RCheck. In this directory you could find the file PACKAGE-manual.pdf.