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

From: hadley wickham <h.wickham_at_gmail.com>
Date: Fri, 19 Jun 2009 20:15:40 -0500

On Fri, Jun 19, 2009 at 6:12 PM, Duncan Murdoch<murdoch_at_stats.uwo.ca> 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, 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.

Can the R code emit top-level rdoc tags? i.e. could the complete rd file just be \Sexpr{} ?

Hadley

-- 
http://had.co.nz/

______________________________________________
R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
Received on Sat 20 Jun 2009 - 01:22:04 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 Sat 20 Jun 2009 - 12:30:58 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