Possible bug in the Rd parser?
Mathieu Ribatet wrote:
Thanks Duncan for all these answers. Indeed I should have checked that the "cases" environment was provided by Rd.sty. Mea culpa. The good point is that before 2.10.0 alpha "R CMD check" finished without any error but the output was wrong - because of the cases environment as you said. Now it fails and this is a good point as I, maybe others??, usually don't have a look at "mypkg-manual.pdf" but only at the html version of it.
Yes, the new system is much better at detecting errors than the old one. It does require some changes to things that worked before, but mainly it detects things that weren't working before, but were undetected as errors. Duncan Murdoch
Cheers, Mathieu Le samedi 10 octobre 2009 ? 20:40 +0200, Duncan Murdoch a ?crit :
On 10/10/2009 2:25 PM, Duncan Murdoch wrote:
On 10/10/2009 8:07 AM, Mathieu Ribatet wrote:
Dear list,
I got an automatic email complaining than some of my packages didn't
pass 'R CMD check' for R-2.10.0 alpha anymore. Both of them make use of
the "cases" LaTeX environment.
Inspecting the log outputs I got:
LaTeX errors when creating PDF version.
This typically indicates Rd problems.
LaTeX errors found:
! Misplaced alignment tab character &.
I noticed that the Rd parser changed quite recently and that '#', '_'
and '&' must not be escaped according to "Writing R extensions".
However, the problematic .Rd portion seems (to me) OK
\deqn{\theta(h) =
\begin{cases}
u_\beta \left(\mu + \frac{\nu(h)}{\Gamma(1 - \xi)}
\right),&\xi \neq 0\\
\exp\left(\frac{\nu(h)}{\sigma}\right),&\xi = 0
\end{cases}
}{u_beta (mu + nu(h) / Gamma(1 - \xi)), if \xi < 1,
exp(nu(h)/sigma), otherwise}
One more followup: the problem appears to be in the "cases"
environment. If I rewrite that block using "array" instead, things are
fine:
\deqn{\theta(h) =
\left\{\begin{array}{ll}
u_\beta \left(\mu + \frac{\nu(h)}{\Gamma(1 - \xi)}
\right),&\xi \neq 0\\
\exp\left(\frac{\nu(h)}{\sigma}\right),&\xi = 0
\end{array}\right.
}{u_beta (mu + nu(h) / Gamma(1 - \xi)), if \xi < 1,
exp(nu(h)/sigma), otherwise}
This makes me think it's a bug in the LaTeX package that provides
"cases", or a conflict with our Rd.sty file, but I don't know which.
And the final answer: the "cases" environment is in the amsmath package, which is not used by R. You need to use regular LaTeX, not fancy stuff like that. (There's a \cases macro in LaTex, which doesn't know what to do with alignment tabs: that's why you got the error you did.) Duncan Murdoch