reST comment block

[GoogleCodeExporter]

http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg571970.html

Debian Bug#500662 submitted by Ben Finney
Package: pandoc
Version: 0.46+2
Severity: normal

The reStructuredText specification allows for comment blocks of 
arbitrary indented text 
<URL:http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#comments
>.

The following session shows that pandoc is incorrectly interpreting 
these comment elements as some other kind of element.

=====
Script started on Tue 30 Sep 2008 18:03:08 EST

$ infile=$(mktemp -t)
$ cat > $infile
Title of document
=================

First paragraph

..
    Comment block, should not appear in output
    as defined by reStructuredText

Another paragraph

..
    Another comment block.

    This one spans several
    text elements.

    It doesn't end until
    indentation is restored to the
    preceding level.

A third paragraph

$ pandoc --from rst --to markdown $infile
# Title of document

First paragraph

..
:   Comment block, should not appear in output as defined by
    reStructuredText

Another paragraph

..
> Another comment block.
> 
> This one spans several text elements.
> 
> It doesn't end until indentation is restored to the preceding
> level.

A third paragraph

$ rm $infile
$ exit

Script done on Tue 30 Sep 2008 18:07:49 EST
=====

The above result is incorrect; instead the comment blocks in the input 
should not be visible in the rendered form. For example, this would be 
a correct rendering of the above example input:

=====
# Title of document

First paragraph

Another paragraph

A third paragraph

=====

Original issue reported on code.google.com by fiddloso...@gmail.com on 1 Oct 2008 at 4:26

[GoogleCodeExporter]

Original comment by fiddloso...@gmail.com on 2 Nov 2008 at 5:05

• Added labels: Priority-High
• Removed labels: Priority-Medium

[GoogleCodeExporter]

Fixed in r1484.

Still need to put a message on the Debian bug tracker, after an official 
release.

Original comment by fiddloso...@gmail.com on 6 Nov 2008 at 4:50

• Changed state: Started

[GoogleCodeExporter]

Original comment by fiddloso...@gmail.com on 6 Nov 2008 at 10:10

• Changed state: Fixed