[Rd] Top level \Sexpr and R CMD check

[Gábor Csárdi]

I would like to create \examples{} in the manual dynamically, and
while it is possible to do this with a \Sexpr at the top level, R CMD
check issues a warning for it. (See below.)

Is it intentional that \Sexpr is not allowed at the top level?  The Rd
grammar allows this, but R CMD check does not.

Is there any other way to generate/modify the \examples{} section dynamically?

Thanks, Gabor

In the Rd  file:

\Sexpr[stage=install,strip.white=FALSE,results=rd]{pkg:::decorate_examples('
CODE
')}

and pkg::decorate_examples outputs

\examples{
MODIFIED CODE
}

But then:

* checking Rd files ... WARNING
prepare_Rd: ps_cmdline.Rd:36-42: Section \Sexpr is unrecognized and
will be dropped