[R-pkg-devel] Fwd: R CMD check and strange ## Not run strings
On 19/12/2017 5:20 PM, Georgi Boshnakov wrote:
Sure, but \dontrun's function is to prevent the R tools from running the enclosed code. How it is rendered is a completely separate matter. The code in \dontrun is not required to be executable (or even valid R code), so surely there should be some sort of visual clue in the rendered page. I don't argue whether it should be the one shown now or should be left entirely to the package author, although the current one seems reasonable to me.
What you say in no way contradicts what Hadley said. He's complaining about your earlier message blaming roxygen for this. He's right, this isn't a roxygen issue, it's a general R help page issue. However: I'm finding it quite amazing that this thread has gone on as long as it has. I think you suggested that package authors should add comments to their code explaining why they asked not to run some lines. That's such a sensible suggestion that it should have ended the thread. Duncan Murdoch
Georgi -----Original Message----- From: Hadley Wickham [mailto:h.wickham at gmail.com] Sent: 19 December 2017 19:22 To: Georgi Boshnakov Cc: Tomas Hudik; r-package-devel at r-project.org Subject: Re: [R-pkg-devel] Fwd: R CMD check and strange ## Not run strings
This actually is not about Rd format. Indeed, you are using 'roxygen' syntax.
This is unrelated to roxygen. \dontrun{} is Rd formatting.
Hadley