[R] Rd problems

[Prof Brian Ripley]

On Fri, 17 Oct 2003 kjetil at entelnet.bo wrote:

> On 12 Oct 2003 at 21:45, Uwe Ligges wrote:
> 
> > kjetil at entelnet.bo wrote:
> > > 
> > > I am running
> > > Rcmd check          (Windows XP, rw1080 from cran)
> > > on a new package.
> > > 
> > > This reports "undocumented code objects" for 14 functions,
> > > which all have their .Rd files!
> > > 
> > > What might be happening?
> > 
> > 1) You forgot to set an \alias{} (most probable)
> > 2) There is another error in the Rd files 
> > 3) There is a bug in R (less probable)
> > 
> 
> It is 3). It was caused by one unmatched brace, but the Rcmd check 
> did not comply about unmatched braces. The first few lines of the 
> file had the structure
> \name{aname}
> \alias{anothername}
> }   % this is the unmatced brace

That's 2) not 3).

Not catching _your_ errors is not a bug (and given that .Rd does not have
a parser, is inevitable).

-- 
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