My package provides infrastructure support for callback functions
defined in special environments in user code. They are conceptually
similar (in fact, almost identical) to the `.onLoad` etc. ?hooks for
namespace events? in base R [1]. Now I?m adding documentation for
these functions, via the following Rd code (or the equivalent roxygen2
code annotating a `NULL` value):
```
\name{topicname}
\alias{topicname}
\alias{onload}
\title{Hooks for environment events}
\usage{
onload(env)
}
\arguments{
\item{env}{the environment}
}
\description{
Short description
}
```
Unfortunately, this causes an `R CMD check` warning:
Functions or methods with usage in documentation object 'topicname' but not in code:
?onload?
Right: this function does not exist in my package, and it *should not*
exist in the package. Yet I do need to document it for users. What is
the recommended way for doing so? In fact, from my reading of the R
source, the base R documentation of ?ns-hooks? doesn?t seem to do
anything special, and would presumably also cause this warning.
I?m open to doing this differently, but I?d strongly prefer if these
functions had their own help topic, with their own ?usage? section. I
don?t just want to add them as a custom section to the package
documentation topic if this is at all avoidable.