Re: [Rd] R-exts.texi in SVN version 36380

From: Prof Brian Ripley <ripley_at_stats.ox.ac.uk>
Date: Fri 18 Nov 2005 - 07:46:14 GMT

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

______________________________________________
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
Received on Fri Nov 18 18:52:57 2005

This archive was generated by hypermail 2.1.8 : Fri 18 Nov 2005 - 11:21:24 GMT