Re: [Docutils-users] broken rst cheatsheet?

[Guenter M. <mi...@us...>]

On 2013-02-18, Angel Yanguas-Gil wrote:
> Hi,

> I just grabbed the online version of the rst cheatsheet available at
> http://docutils.sourceforge.net/docs/user/rst/cheatsheet.txt, and
> miserably failed at creating a pdf out of it. I generated the latex
> output with rst2latex (docutils 0.9 under Python 2.7, rev Id 5905 of
> rst2latex.py), but both latex and pdflatex raised errors, beginning
> with:

> {Literal block, preceded by ``::'':
> ! Paragraph ended before \@xmultirow was complete.
><to be read again>
>                    \par
> l.161

> Ignoring the errors eventually lead to a fatal error and no PDF output.

> A gmane search led me to a 2008 thread that raised a similar problem.

> My question is: is it a particular problem of my TEX or is it a known
> issue?  It is not a matter of life or death for me, but I am just
> curious.

The cheatsheet is actually the only part of Docutils documentation where the
source is/was HTML and "cheatsheet.txt" is generated from it.

It was never intended to be used with rst2latex and therefore not tested.
A patch that solves the issue and provides a valid rst source
(with no change to the HTML rendering) is welcome.

Günter