Re: [Docutils-users] broken rst cheatsheet?

[David G. <go...@py...>]

On Mon, Feb 18, 2013 at 2:34 AM, Guenter Milde <mi...@us...> wrote:
> 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.

No, you're thinking of the Quick reStructuredText document,
http://docutils.sourceforge.net/docs/user/rst/quickref.html

http://docutils.sourceforge.net/docs/user/rst/cheatsheet.txt is
perfectly valid reST.

> It was never intended to be used with rst2latex and therefore not tested.

cheatsheet.txt works fine with rst2html.py. If it doesn't work with
rst2latex.py, there is a real bug in there somewhere.

> A patch that solves the issue and provides a valid rst source
> (with no change to the HTML rendering) is welcome.

+1, but please consider this a bug report.

-- 
David Goodger <http://python.net/~goodger>