Re: python setup.py check --restructuredtext --strict --metadata fails for valid document with syntax highlighting

David Goodger <[email protected]>
Newsgroups gmane.text.docutils.user
Message-ID <CABiJP=K2YA4UVcgtNR4T=kiYAHkneALkBfR2_LyJtQPSVBTwhw@mail.gmail.com>
On Mon, Dec 15, 2014 at 2:46 PM, Marc Abramowitz <[email protected]> wrote:
> python setup.py check --restructuredtext --strict --metadata fails with:
>
> warning: check: Could not finish the parsing.
>
> if the RST document uses code or code-block directives.
>
> This is annoying because the document is valid, but it appears to be invalid
> and confuses people.
>
> I filed a ticket for this (with a patch included):
>
> https://sourceforge.net/p/docutils/bugs/270/

"code-block" is not a standard Docutils reST directive, so I don't see
how the document could be valid. "code-block" should always break.
Maybe it's a Sphinx extension, and your environment has that
installed. Did you try with just the "code" directive?

-1 on the patch. It makes assumptions that may not always be true. If
the bug is in Python's distutils, that's where the fix should be. But
first, make sure your document is truly valid.

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

------------------------------------------------------------------------------
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.