Sd2Rd Hangup

I've been converting a number of .sgml S-documentation filed to .Rd format
and a few persistent complications--all involving the documentation's
examples--have arisen every time I issue the standard R CMD check to prepare
my project for building. The impression I get is that the check script
simply tries to execute every R command in the included documentation's
example{ } sections. But since Sd2Rd essentially dumps an S-documentation
file's example contents into the new .Rd file, formatting problems crop up.

Indeed. And not just formatting problems.

S has never enforced a policy on whether examples should be executable
source or session transcripts (though the former seems much more common),
or on whether executable source actually has to run, so the format doesn't
let you specify, and it would be hard for a program to guess.

R does enforce a policy, as you have found. However, in converting other
people's S help files I have found editing the content of the examples to
be more work than editing the format -- S examples don't have to work, but
R examples do.


	-thomas

Thomas Lumley			Asst. Professor, Biostatistics
tlumley at u.washington.edu	University of Washington, Seattle

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
r-help mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html
Send "info", "help", or "[un]subscribe"
(in the "body", not the subject !)  To: r-help-request at stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._