From ripley at stats.ox.ac.uk  Mon Dec  1 11:22:04 2008
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Mon, 1 Dec 2008 10:22:04 +0000 (GMT)
Subject: [Rd] normal-bracket50bracket-normal?
In-Reply-To: <4933074E.9020708@pdf.com>
References: <4933074E.9020708@pdf.com>
Message-ID: <alpine.LFD.2.00.0812011014160.29048@gannet.stats.ox.ac.uk>

These usually indicate incorrect files. Have you looked at the 
experimental Rd parser in R-devel to see if it pinpoints an error?

For example, in both Fperm.Rd and compareDerivatives.Rd there is an 
\itemize{} construct inside \value, which is incorrect as \value is itself 
an implicit \itemize.  Please do check the description in 'Writing R 
Extensions' (and \value is definitely quirky).

On Sun, 30 Nov 2008, Spencer Graves wrote:

> Hello:
>
>
>     I've found structures like "normal-bracket50bracket-normal" in
> help files for R packages including the following:
>
>          * "mergeprepare" and "mergematrices" in a document dated
> March 3, 2004 by Richard Mott;  the second contains
> "normal-bracket30bracket-normal".

Which is insufficient for the rest of us to get access to it.

>          * "Fperm.fd" and "tperm.fd" in the "fda" package;  these help pages 
> were written primarily by Giles Hooker.
>
>          * "compareDerivatives" in the "maxLik" package;  this help page was 
> written by Ott Toomet and me.
>
>
>     What can we do to eliminate this nonsense comment?
>
>     Constructs like this seem to be generated in perl code used in "R
> CMD" processing
> (https://svn.r-project.org/R/trunk/share/perl/R/Rdconv.pm).
>
>     Thanks,
>     Spencer Graves
>
> ______________________________________________
> R-devel at r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel
>

-- 
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 272866 (PA)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595



[Rd] normal-bracket50bracket-normal?
Prof Brian Ripley