This was fixed yesterday as part of PR#1257, and I've just answered one Q
on R-help about it. What I get on my system in html makes as little
sense as the foo.Rd, but no less.
Please try out the current R-devel.
On Thu, 4 Apr 2002 rolf@math.unb.ca wrote:
>
> Just now I again had occasion to want nested describe lists in a
> documentation file. I found that the bug which I reported on 18
> October, 2001 still persists. I checked on the bug report at the R
> web page, and found that the notes say ``Not a problem in R 1.4.0
> (2001-12-08)''.
>
> Well, it's still a problem for me --- using R 1.4.1.
>
> (Details:
>
> platform sparc-sun-solaris2.7
> arch sparc
> os solaris2.7
> system sparc, solaris2.7
> status
> major 1
> minor 4.1
> year 2002
> month 01
> day 30
> language R ).
>
> I executed
>
> R CMD Rdconv -t=htlm foo.Rd > foo.html
>
> where foo.Rd is the example documentation file that I submitted to
> illustrate the bug. On my system, the bug remains. I.e. the nested
> describes screw up. The item in the outer describe list, just
> before the inner describe list, (in the example ``fred'') gets
> omitted, along with the first couple of items of the inner describe
> list. The third item of the inner describe list seems to get treated
> as if it were an element of the outer list, and gets jumbled with a
> bit of the ``fred'' item.
>
> I enclose below the file foo.html that I got on my system.
>
> Could you please check to see if the same thing happens when you run
> the Rdconv command on your system? I guess it's possible that
> there's a local glitch here (e.g. something wrong with perl?) that
> causes the screw-up.
>
> cheers,
>
> Rolf Turner
> rolf@math.unb.ca
>
>
===+===+===+===+===+===+===+===+===+===+===+===+===+===+===+===+===+===+==>
> File foo.html:
> =============>
> <html><head><title>R: Do nothing.</title>
> <link rel="stylesheet" type="text/css"
href="../../R.css">
> </head><body>
>
>
> <h2>Do nothing.</h2>
>
>
> <h3>Description</h3>
>
> <p>
> Do nothing, but do it <b>very</b> well!
> </p>
>
>
> <h3>Usage</h3>
>
> <pre>
> foo(gorp,par)
> </pre>
>
>
> <h3>Arguments</h3>
>
> <table summary="R argblock">
> <tr
valign="top"><td><code>gorp</code></td>
> <td>
> I don't know either.</td></tr>
> <tr
valign="top"><td><code>par</code></td>
> <td>
> Never you mind!</td></tr>
> </table>
>
> <h3>Details</h3>
>
> <p>
> The parameter list <code>par</code> should be
> as follows, for each possible value of <code>gorp</code>:
> <dl>
> <dt>melvin:</dt><dd>(Melvin Mingdinkler.) A vector with
components
> <i>(beta,gamma,r)</i> which are respectively
> a load of dingos' kidneys, an elephant, and a duck.
> Note that <i>gamma</i> must be totally ridiculuous.
> </dd>
>
>
> <dt>clyde:</dt><dd>(Clyde, clyde, the cow's outside.)
A vector with
> entries <i>(beta,gamma,r_0,r)</i> where
> <i>beta</i>, <i>gamma</i>, and <i>r</i>
are as for
> <code>melvin</code>, <i>r_0</i> is a hippopotamus.
Of course
> <i>r_0</i> must eat less than <i>r</i>.
> </dd>
>
>
> <dt>irving:</dt><dd>(The 142nd fastest gun in the West.)
A vector
> with components <i>(beta,sigma,kappa)</i>.
> Again <i>beta</i> is a load of dingos' kidneys.
> The difference between a duck is
> </p><p
align="center"><i>(sigma/kappa)^2</i></p><p>
> Note that it is necessary that <i>kappa > 42</i>.
> </dd>
>
>
> <dt>r:</dt><dd>A <b>symmetric</b> matrix of
ducks with
> <i>r_ij</i> pertaining to the kidneys of dingo
> <i>i</i> and dingo
<i>j</i>.</dd><dd>(Fred Nurk.) Here
<code>par</code> is
> given as a list with components
> </p>
>
> <dl>
> <dt>beta:</dt><dd>A vector of loads of dingos'
kidneys.</dd>
> <dt>gamma:</dt><dd>A <b>symmetric</b> matrix
of elephants,
> with <i>gamma_ij</i> pertaining to the kidneys of
> dingo <i>i</i> and dingo <i>j</i>.</dd>
>
>
> <dt>r:</dt><dd>A <b>symmetric</b> matrix of
ducks with
> <i>r_ij</i> pertaining to the kidneys of dingo
> <i>i</i> and dingo <i>j</i>.</dd>
> </dl></dd>
> </dl>
>
> <h3>Warnings</h3>
>
> <p>
> Even paranoids have real enemies.
> </p>
>
>
> <h3>Author(s)</h3>
>
> <p>
> Rolf Turner
> <a
href="mailto:rolf@math.unb.ca">rolf@math.unb.ca</a>
> <a
href="http://www.math.unb.ca/~rolf">http://www.math.unb.ca/~rolf</a>
> </p>
>
>
> <h3>References</h3>
>
> <p>
> Gates, V. ``42 Wonderful Things to do in Come-by-Chance, Nfld.'',
> Memorial University Press, St. John's Nfld., 2001.
> </p>
> <p>
> Ye-of-little-faith, O. ``An annotated bibliography of green
> peas and their ilk'', Journal of the Hopeless, vol. 42, 1950,
> pp. 101 – 64.
> </p>
>
>
> <h3>See Also</h3>
>
> <p>
> <code><a
href="../../../doc/html/search/SearchObject.html?bar">bar</a></code>,
> <code><a
href="../../../doc/html/search/SearchObject.html?snafu">snafu</a></code>,
> </p>
>
>
> <h3>Examples</h3>
>
> <pre>
> #Oh come on! You can think up your own examples!
> </pre>
>
>
>
> <hr><div align="center"><a
href="00Index.html">[Package Contents]</a></div>
>
> </body></html>
>
>
-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
> r-devel 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-devel-request@stat.math.ethz.ch
>
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._
>
--
Brian D. Ripley, ripley@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-devel 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-devel-request@stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._