From ripley at stats.ox.ac.uk  Fri Oct 29 13:04:17 2004
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Fri Oct 29 13:04:25 2004
Subject: [Rd] (PR#7323)R-exts.texi: suggestion for small change to Vignette
	section
In-Reply-To: <20041029104746.3E41711345@slim.kubism.ku.dk>
Message-ID: <Pine.LNX.4.44.0410291158370.22986-100000@gannet.stats>

Is this not a bug in `vExplorer' (unexplained, but I believe in a BioC 
package -- by no means all R users have any experience of BioC)?

Why change the docs to a limitation of some application not part of 
core R?  

I do wonder why you sent this to R-bugs and not to the maintainer of
vExplorer.  Or was this a very minor comment on English grammar padded by 
something not relevant?

On Fri, 29 Oct 2004 S.J.Eglen@damtp.cam.ac.uk wrote:

> I recently wrote a vignette, with the following at the top of the .Rnw
> file:
> 
> %%\VignetteIndexEntry{How to use look up tables for h() functions}
> %%\VignetteDepends{sjedmin, spatstat}
> 
> Using vExplorer() on this function, I got an error from this part of
> getVigInfo():
> 
>     lines <- grep("^%[[:space:]]*\\\\Vignette", file)
>     if (length(lines) == 0) 
>         stop("File ", vig, " does not appear to be a vignette file, ", 
>             "no vignette metadata available.")
> 
> The error occurs here because the grep expects only one % at the start
> of the line, whereas I had %%.  (I often use two at the start of a
> line as I'm used to the ESS/Emacs coding habits of putting ## at the
> start of a line.)  Changing %% to % solved the problem okay.  
> 
> So, my minor suggestion to R-exts.texi, at line 1011:
> 
> @code{\VignetteIndexEntry} statement is best placed in La@TeX{} comment,
> 
> is that maybe it should say either:
> 
> "in a La@TeX{} comment"
> 
> or 
> 
> "in a La@TeX{} comment with a single %"
> 
> although admittedly that sounds a bit clunky!
> 
> Thanks, Stephen
> 
> ______________________________________________
> R-devel@stat.math.ethz.ch mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel
> 
> 

-- 
Brian D. Ripley,                  ripley@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


[Rd] (PR#7323)R-exts.texi: suggestion for small change to Vignette section
Prof Brian Ripley