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

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

2016-05-17 Thread Martin Maechler
;Richard Cotton" <richiero...@gmail.com> To: >>> "bioc-devel" <bioc-devel@r-project.org> Sent: Sunday, >>> May 15, 2016 4:45:09 AM Subject: [Bioc-devel] \donttest >>> and the "80% of man pages documenting exported objects

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

2016-05-16 Thread Hervé Pagès
On 05/15/2016 11:35 PM, Richard Cotton wrote: 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

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

2016-05-16 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

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

2016-05-16 Thread Hervé Pagès
Hi Richard, On 05/15/2016 04:45 AM, Richard Cotton wrote: 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

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

2016-05-15 Thread Martin Morgan
On 05/15/2016 02:20 PM, Dan Tenenbaum wrote: - Original Message - From: "Richard Cotton" <richiero...@gmail.com> To: "bioc-devel" <bioc-devel@r-project.org> Sent: Sunday, May 15, 2016 4:45:09 AM Subject: [Bioc-devel] \donttest and the "80% of m

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

2016-05-15 Thread Dan Tenenbaum
- Original Message - > From: "Richard Cotton" <richiero...@gmail.com> > To: "bioc-devel" <bioc-devel@r-project.org> > Sent: Sunday, May 15, 2016 4:45:09 AM > Subject: [Bioc-devel] \donttest and the "80% of man pages documenting > exp

[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