Message-ID: <Pine.LNX.4.31.0106261620260.1213-100000@gannet.stats>
Date: 2001-06-26T15:26:47Z
From: Brian Ripley
Subject: Sd2Rd Hangup
In-Reply-To: <7975A3F85F08D5119C610002A5134856AA4A4B@Msgbos686nts.fmr.com>
On Tue, 26 Jun 2001, Bartz, Kevin wrote:
> 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.
> Correct me if I'm wrong, but Sd2Rd neither strips each example line's
> opening greater-than (">") nor prunes the output. And then check barks at me
Right. There are no conventions for example sections in S's .d or .sgml
files.
> when R can't execute either of the ">"-padded example code or the actual
> output, which I didn't even intend for it to try to interpret in the first
> place. In the meantime, I've been using a Perl script that sifts through a
> set of .Rd's and makes the proper connections, stripping all ">"s and
> sticking "\dontrun"s around the output, but I was wondering if there's a
> better or built-in way. Any advice?
If that works for you, that's the best I know of. Most authors of S help
files do not include the > nor the output, so I see few problems in the
literally hundreds of such files I have ported. When I do, I have to hand
edit, and for example the VR conversion scripts contain a set of patch
files to convert my co-author's conventions to R's.
But I am glad to know that someone is benefiting from the work I put in
writing the .sgml->.Rd converter.
--
Brian D. Ripley, ripley at 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 272860 (secr)
Oxford OX1 3TG, UK Fax: +44 1865 272595
-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
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
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._