Need to document arguments in functions which are not exported in R package?

2.6k views Asked by At

I am using the devtools package to check if a package I am developing is ready for submission to CRAN.

Using Roxygen2 through devtools, I documented a small number of functions with #'@export, in order for them to be available when the package I am developing is loaded.

However, when I run devtools::check(), it seems I need to document the functions that are NOT exported, i.e. those that may be called by a function which is exported, but which are not available nor needed by whoever uses the package. Here is an example from the output of devtools::check():

checking Rd \usage sections ... WARNING
Undocumented arguments in documentation object 'calculate_agreement'
  ‘a_assign_star’ ‘a_assign’

Do I need to document those arguments although the function is not exported?

1

There are 1 answers

3
Ben Bolker On BEST ANSWER

I believe the problem here (based on past experience) is that you are probably using Roxygen comment delimiters #' in the preamble to the function. This (I'm pretty sure) triggers the creation of a .Rd file (and the need to document parameters), whether or not you have an @export directive or not. My solution in this case was to use regular # commenting rather than #'.

Based on this answer it's possible that an explicit @keywords internal directive would also work (but I haven't tried it).

@mattb points out that specifying @noRd should also work.