[R-SIG-Mac] manpage problem

[Prof Brian Ripley]

On Wed, 7 Apr 2010, joerg van den hoff wrote:

> not sure whether this is MAC specific:

Why do you suppose it would be?

> I use \itemize or \enumerate in some manpages. it worked previously, but I'm 
> not sure up till when...
> now (with 2.10.1) I see the following:
>
> -- using the R-GUI manpages are displayed correctly

with HTML help, the default, I guess.

> -- in the Terminal.app (or xterm) only the bullet points (or enumerating 
> numbers) are displayed, but the actual description
>  for the item is missing.

with text help (the default), I guess.

> any ideas?

RTFM time: your help (sic) pages are incorrect.  That is not how \item 
works in those environments, and the braces are incorrect.
For an example of the correct layout, see src/library/base/man/dcf.Rd 
in the R sources.

>
> thanks
>
> joerg
>
> ps: macos 10.5.8 ppc
> pps: in case, the problem is my manpage, the source code of this 
> (rudimentary) manpage is:
>
> \name{metacor}
> \alias{metacor}
> \title{
> Perform metabolite correction
> }
> \description{
> Computes metabolite corrected input function from whole blood data plus
> time dependent metabolite fraction
> }
> \usage{
> metacor(input, metfrac = 0)
> }
> \arguments{
> \item{input}{
> measured input function (class \code{Roidata})
> }
> \item{metfrac}{
> metabolite fraction
> }
> }
> \details{
> The metabolite fraction has to be in one of the following formats.
>
>  \enumerate{
>     \item{a single number}
>     \item{a vector of metabolite fractions corresponding one-to-one to the
>        time points in input}
>     \item{a two column matrix (time vs. metab. fraction) where time units
>        have to be the same as those used in input}
>     \item{a Roidata object including timing information}
>  }
> }
> \value{
> metabolite corrected input function (\code{Roidata} object)
> }
> \author{
> vdh
> }
> \seealso{
> \code{readroi}
> }
> \keyword{ utilities }
>
> _______________________________________________
> R-SIG-Mac mailing list
> R-SIG-Mac at stat.math.ethz.ch
> https://stat.ethz.ch/mailman/listinfo/r-sig-mac

-- 
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