From ripley at stats.ox.ac.uk  Fri Nov 18 08:46:14 2005
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Fri, 18 Nov 2005 07:46:14 +0000 (GMT)
Subject: [Rd] R-exts.texi in SVN version 36380
In-Reply-To: <17277.19077.463979.101648@bossiaea.maths.uwa.edu.au>
References: <17277.19077.463979.101648@bossiaea.maths.uwa.edu.au>
Message-ID: <Pine.LNX.4.61.0511180731490.9545@gannet.stats>

On Fri, 18 Nov 2005, Berwin A Turlach wrote:

> G'day all,
>
> after issuing `svn up' on my machine this morning, I noticed that
> `make info' choked on R-exts.texi.

Actually 'make' chokes.

> Below is a patch that seems to
> solve the problem.  BTW, while `make info' runs now, I still get the
> following warning:
>
> /usr/bin/makeinfo --enable-encoding -D UseExternalXrefs -I/opt/src/R-devel-src/doc/manual /opt/src/R-devel-src/doc/manual/R-exts.texi
> /opt/src/R-devel-src/doc/manual/R-exts.texi:1219: warning: @strong{Note...} produces a spurious cross-reference in Info; reword to avoid that.

Thank you for the report.  The last warning is long-standing and has been 
not thought worth fixing as very few (if any) Windows users use info.
The fix is simple though

@quotation Note to Windows users
@code{R CMD check} and @code{R CMD build} work well under Windows
....


> No idea how to fix that, my texinfo knowledge is not good enough. :)
>
> Actually, I am not clear on the following two questions:
> 1) Should such patches be sent to r-devel, r-bugs or both?
> 2) Should such patches be sent at all, or should users just wait till
>   R-core fixes it itself?

If they are this obvious you can just do nothing if you prefer.  We do 
expect people to run 'make all check' before committing and deal with any 
new warnings/errors, and when (as here) people omit to do so it gets 
spotted and fixed within hours.

There were other markup problems, e.g. we use @R{} for R.

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



[Rd] R-exts.texi in SVN version 36380
Prof Brian Ripley