Re: [Bioc-devel] \donttest and the "80% of man pages documenting exported objects must have runnable examples" rule

2016-05-17 Thread Richard Cotton
On 17 May 2016 at 13:43, Martin Maechler wrote: > I also wonder *why* you use \donttest{} so extensively. > It's clearly better than \dontrun{} (which really distresses > me, if used more than occasionally). I totally agree with you that \dontrun is overused and annoying for users. My main us

Re: [Bioc-devel] \donttest and the "80% of man pages documenting exported objects must have runnable examples" rule

2016-05-15 Thread Richard Cotton
On 16 May 2016 at 09:26, Hervé Pagès wrote: > I notice that you're using \donttest and not \dontrun though. Are you > saying that the time it would take to run all the examples is < 5 min > but even that is still a burden for you as a developer when you test > your package with 'R CMD check'? Exa

[Bioc-devel] \donttest and the "80% of man pages documenting exported objects must have runnable examples" rule

2016-05-15 Thread Richard Cotton
I have a package with a lot of examples in exported functions marked as \donttest. BiocCheck doesn't count these functions towards the target of having 80% of exported objects with runnable examples. I do have more than 80% runnable examples; it's just that BiocCheck can't see them. (For backgro