[R-pkg-devel] License of pre-built vignettes

Thierry Onkelinx th|erry@onke||nx @end|ng |rom |nbo@be
Fri Oct 25 09:56:57 CEST 2019


Dear Helmut,

Maybe you can move your vignettes (source and rendered version) to the inst
folder. I think that this makes the files available to the user without
being recompiled. Downside it that they are no longer recognised as
vignettes. Therefore I would also add a short overview vignette describing
and linking to the precompiled vignettes. Something like
browseURL(system.file("precompiled.html", package = "yourpackage"))

Best regards,

ir. Thierry Onkelinx
Statisticus / Statistician

Vlaamse Overheid / Government of Flanders
INSTITUUT VOOR NATUUR- EN BOSONDERZOEK / RESEARCH INSTITUTE FOR NATURE AND
FOREST
Team Biometrie & Kwaliteitszorg / Team Biometrics & Quality Assurance
thierry.onkelinx using inbo.be
Havenlaan 88 bus 73, 1000 Brussel
www.inbo.be

///////////////////////////////////////////////////////////////////////////////////////////
To call in the statistician after the experiment is done may be no more
than asking him to perform a post-mortem examination: he may be able to say
what the experiment died of. ~ Sir Ronald Aylmer Fisher
The plural of anecdote is not data. ~ Roger Brinner
The combination of some data and an aching desire for an answer does not
ensure that a reasonable answer can be extracted from a given body of data.
~ John Tukey
///////////////////////////////////////////////////////////////////////////////////////////

<https://www.inbo.be>


Op vr 25 okt. 2019 om 01:17 schreef Helmut Schütz <helmut.schuetz using bebac.at>:

> Dear Duncan,
>
> Duncan Murdoch wrote on 2019-10-24 21:51:
> > So it seems clear what to do:  remove the BuildVignettes: false
> > statement, and explain why CRAN should avoid building them in your
> > submission message.  This will likely make it take longer for the
> > package to be handled; if that's a problem for you, you probably need
> > to simplify the examples (or remove them).
>
> THX, I got the idea. However, if we remove BuildVignettes: false, in the
> tarball the HTML5 vignettes in inst/doc are overwritten with pandoc's
> XHTML1.0 (with a warning, of course). That's the opposite of what we want.
>
> The vignettes contain code for simulations which causes the long
> runtime. In examples of the man-pages we have -- much simpler ones -- in
> \donttest{}. I think that one of the purposes of vignettes is to give
> the user a more exhaustive description what can be done with certain
> functions. The only way out would to have instead of the R-code plain
> text. Runtimes close to zero but all -- rather useful -- formats lost.
>
> We will try to keep them and start a discussion with the team.
>
> Helmut
>
> --
> Ing. Helmut Schütz
> BEBAC – Consultancy Services for
> Bioequivalence and Bioavailability Studies
> Neubaugasse 36/11
> 1070 Vienna, Austria
> W https://bebac.at/
> F https://forum.bebac.at/
>
> ______________________________________________
> R-package-devel using r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel
>

	[[alternative HTML version deleted]]



More information about the R-package-devel mailing list