Re: [Rd] Changes to Rd handling in R-devel

From: Duncan Murdoch <murdoch_at_stats.uwo.ca>
Date: Sun, 21 Jun 2009 13:17:49 -0400

On 19/06/2009 7:12 PM, Duncan Murdoch wrote:
> I've just committed some fairly big changes to R-devel.
> - There's a new tag \Sexpr which allows R code to be embedded within
> the Rd file, similar to Sweave, \RdOpts
> corresponds to \SweaveOpts.
> - The parser now mainly issues warnings, rather than errors, in case
> of syntax errors. It throws away a few tokens and tries to restart.
> This should let you see most of your errors in one pass, rather than one
> at a time. (Don't ignore the warnings -- you've lost some of your file
> if you get them!) (Romain: yes, this is done using the special "error"
> token in bison.)
> - There are also a number of bug fixes to the rendering code (e.g.
> Rd2HTML). I'm hoping to switch over soon to the new parser being used
> to produce all man pages.
>
> I need to write up more about \Sexpr,

I've started the writeup, as a new section of the parseRd.pdf file on developer.r-project.org.

Duncan Murdoch

but the basic idea is that the
> format is
>
> \Sexpr{R code}
>
> or
>
> \Sexpr[options]{R code}
>
> Currently the R code is not executed unless you do it manually, but once
> we're using this engine for man pages, you'll be able to choose when to
> execute the code: build time, install time, or render time.
>
> I hope these changes don't introduce any bugs in old Rd files, but if
> they do, please let me know and I'll fix them. (Not today; I'll be
> travelling.)
>
> Duncan Murdoch
>
> ______________________________________________
> R-devel_at_r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel



R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Sun 21 Jun 2009 - 17:21:54 GMT

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Sun 21 Jun 2009 - 17:31:07 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.

list of date sections of archive