Re: [Rd] Precompiled vignette on CRAN

From: Martin Morgan <mtmorgan_at_fhcrc.org>
Date: Wed, 14 Jul 2010 14:12:38 -0700

On 07/14/2010 01:04 PM, Prof Brian Ripley wrote:
> On Wed, 14 Jul 2010, Felix Schönbrodt wrote:
>

>> Hello,
>>
>> my package passes R CMD check without any warnings on my local machine
>> (Mac OS), as well as on Uwe Ligges' Winbuilder. On RForge, however, we
>> sometimes run into problems building the Sweave vignettes.

>
> Just 'problems' is not helpful.
>
>> Now here's my question: is it necessary for a CRAN submission that the
>> Sweave vignettes can be compiled on CRAN, or is it possible to provide
>> the (locally compiled) pdf vignette to be included in the package?

>
> This really is a question to ask the CRAN gatekeepers, but people are on
> vacation right now, so I've give some indication of my understanding.
>
> What does 'compiled' mean here? (Run through LaTeX? Run the R code?)
> There are examples on CRAN of packages which cannot re-make their
> vignettes without external files (e.g. LaTeX style files), or take hours
> (literally) to run the code. The source package should contain the PDF
> versions of the vignettes as made by the author.
>
> There is relevant advice in 'Writing R Extensions'.

While on this topic, how are non-Sweave files to be made accessible to browseVignettes() and help(package=...)?

At one point 00Index.dcf files could be used to influence index creation, and Writing R Extensions indicates that an inst/doc/index.html file can also be used. The 00Index.dcf approach seems better (no need for the user to track the appropriate html structure of R's help pages), but regardless it seems 00Index.dcf is ignored (stronger than 'no longer necessary' in Writing R Extensions) and index.html does not influence what is displayed by help(package='...') or browseVignettes().

I'm basing this on the 'limma' package (which seems to have tried to be a good citizen, with 00Index.dcf and index.html files) and running R in a console with

> getOption('help_type')

NULL
> sessionInfo()

R version 2.12.0 Under development (unstable) (2010-07-14 r52526) Platform: x86_64-unknown-linux-gnu (64-bit)

locale:

 [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C
 [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8
 [5] LC_MONETARY=C              LC_MESSAGES=en_US.UTF-8
 [7] LC_PAPER=en_US.UTF-8       LC_NAME=C
 [9] LC_ADDRESS=C               LC_TELEPHONE=C
[11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C

attached base packages:
[1] stats graphics grDevices utils datasets methods base

other attached packages:
[1] limma_3.5.12

Martin

>
> What the people who do the CRAN package checks do get unhappy about are
> packages which fail running the R code in their vignettes, since this
> often indicates a problem in the package which is not exercised by the
> examples nor tests. This gives a warning, as you will see in quite a
> few CRAN package checks.
>
>
>
> ______________________________________________
> R-devel_at_r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel

-- 
Martin Morgan
Computational Biology / Fred Hutchinson Cancer Research Center
1100 Fairview Ave. N.
PO Box 19024 Seattle, WA 98109

Location: Arnold Building M1 B861
Phone: (206) 667-2793

______________________________________________
R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
Received on Wed 14 Jul 2010 - 21:16:36 GMT

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Mon 26 Jul 2010 - 11:40:19 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.

list of date sections of archive