From murdoch at stats.uwo.ca  Wed Jul 15 22:07:13 2009
From: murdoch at stats.uwo.ca (Duncan Murdoch)
Date: Wed, 15 Jul 2009 16:07:13 -0400
Subject: [Rd] Dynamic help pages
In-Reply-To: <4A5DDDE4.5000207@stats.uwo.ca>
References: <4A5DDDE4.5000207@stats.uwo.ca>
Message-ID: <4A5E36F1.1020206@stats.uwo.ca>

On 7/15/2009 9:47 AM, Duncan Murdoch wrote:
> I've just committed code that allows R to be built with support for 
> dynamic help pages using \Sexpr in Rd files.  Define USE_NEW_HELP and 
> the R function tools:::.convertRdfiles will be used instead of the Perl 
> RdConv script, supporting \Sexpr and using the new R converters.
> 
> Currently only text help has the macros evaluated when the user asks for 
> help; the others are rendered at install time.  Hopefully HTML rendering 
> will also be in place before the 2.10.x release.  I can't see how CHM 
> and Latex help pages would ever be dynamic. Build time evaluation of 
> \Sexpr macros is not yet supported.
> 
> The only man page currently containing \Sexpr is ?tools::Rd2HTML.


This message may be a little premature:  the USE_NEW_HELP setting only 
affects base packages so far.  I'll see if I can get R CMD INSTALL 
working too, but it might take a while....

Duncan Murdoch



[Rd] Dynamic help pages
Duncan Murdoch