[Rd] Writing my first CRAN vignette

Michael Dewey info at aghmed.fsnet.co.uk
Mon May 19 10:09:39 CEST 2014

At 14:57 18/05/2014, Prof Brian Ripley wrote:
>On 18/05/2014 13:33, Michael Dewey wrote:
>>In fact my first vignette full stop.
>>I am intending to use Sweave. I have read the Sweave documentation and
>>section 1.4 of the extensions manual and apart from (a) do not use split
>>= TRUE (b) and include all the source components, there does not seem to
>>be anything CRAN specific.
>>1 - Am I missing some other documentation?
>There is no such thing as a 'CRAN vignette'.  These days all 
>(non-internal-to-CRAN) CRAN-specific documentation is in the CRAN policies.
>>2 - If I use a package from CTAN would that be considered within the
>>spirit if not the letter of open source? I am not asking for trained
>>legal advice here, it is the spirit of the rules.
>Provided it is available to people to reproduce things if the 
>package uses a FOSS licence.
>>3 - I assume including the .bbl file would be fine rather than making a
>>separate .bib file?
>No.  We have seen .bbl files which no longer worked after a TeXLive 
>update, and with a FOSS licence you need to supply the sources (and 
>normally the .bib file is the source).

Thanks, that (and the other answers) will be very helpful.

>>I am not envisaging doing anything complex: text, formulae, some tables
>>and one figure plus a few references.
>>Michael Dewey
>>info at aghmed.fsnet.co.uk
>Brian D. Ripley,                  ripley at stats.ox.ac.uk
>Professor of Applied Statistics,  http://www.stats.ox.ac.uk/~ripley/
>University of Oxford,             Tel:  +44 1865 272861 (self)
>1 South Parks Road,                     +44 1865 272866 (PA)
>Oxford OX1 3TG, UK                Fax:  +44 1865 272595

Michael Dewey
info at aghmed.fsnet.co.uk

More information about the R-devel mailing list