# [Rd] itemize/item crashes R CMD check (PR#1330)

bolker@zoo.ufl.edu bolker@zoo.ufl.edu
Tue, 26 Feb 2002 21:04:11 +0100 (MET)

I can crash R CMD check with the following message:

This shouldn't happen at /usr/local/lib/R/share/perl/R/Rdconv.pm line 1226, <rdfile> line 24.

under the following circumstances --

an \itemize{} environment in the \details{} section with
an item that continues on more than one line, delimited by
curly brackets.  It looks like \items would rather be
delimited by spaces than by curly brackets.

This isn't clear from the R-exts manual (p. 15), which says:

The \itemize and \enumerate commands take a single argument,
within which there may be one or more \item commands. The
text following each \item is formatted as one
or more paragraphs, suitably indented and with the first
paragraph marked with a bullet
point (\itemize) or a number (\enumerate).

I was misled by the analogy with LaTeX, where you would
delimit \item by curly brackets.
The workaround is easy -- just delimit by spaces instead
of curly brackets -- but in any case, it seems that a
"This shouldn't happen ..." message shouldn't be visible to
the user ...

example:
\name{test}
\alias{test}
\title{test}
\description{test}
\usage{
test(x)
}
\arguments{
\item{x}{test}
}
\details{
Criteria:
\itemize{
\item{test: this is an item that is quite long quite long quite long quite long
and continues on another line}
\item{test2}
\item{test3}
}
}
\value{
test
}
\author{Ben Bolker}
\keyword{misc}
--------------------

--please do not edit the information below--

Version:
platform = i686-pc-linux-gnu
arch = i686
os = linux-gnu
system = i686, linux-gnu
status =
major = 1
minor = 4.1
year = 2002
month = 01
day = 30
language = R

Search Path: