Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Em Fri, 14 Jul 2017 09:24:44 +0200
Markus Heiser <markus.heiser@xxxxxxxxxxx> escreveu:

> > Am 13.07.2017 um 22:50 schrieb Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>:
> > 
> > Em Mon,  6 Mar 2017 14:09:27 +0100
> > Markus Heiser <markus.heiser@xxxxxxxxxxx> escreveu:
> >   
> >> This patch brings scalable figure, image handling and a concept to
> >> embed *render* markups:
> >> 
> >> * DOT (http://www.graphviz.org)
> >> * SVG  
> > 
> > Not sure what's happening here, but, after I upgraded to Fedora 26,
> > with comes with python 3.6, instead of 3.5, this patch is now
> > causing build problems (with Sphinx 1.4.9, running on a virtual
> > environment):  
> 
> Are you sure (only) this patch causes the problem? I remember this
> was a more general problem which unfortunately pops up in the context
> of this patch ..

I tested reverting it and everything built in html, but I didn't
did a comprehensive testing, nor even check if the output was ok.

> 
> > $ make SPHINXDIRS=doc-guide htmldocs
> >  SPHINX  htmldocs --> file:///devel/v4l/docs/Documentation/output/doc-guide  
> ...
> >  File "/devel/v4l/docs/sphinx_1.4/lib/python3.6/site-packages/docutils/writers/_html_base.py", line 671, in depart_document
> >    assert not self.context, 'len(context) = %s' % len(self.context)
> > AssertionError: len(context) = 4  
> 
> 
> SHORT: If one of you see a "AssertionError: len(context) = 4",
>        then update your Sphinx Version
> 
> LONG: we had already a long ML thread in March about this. 

Ah, I remember those discussions with regards to docutils version.
Thanks for pointing it to me.

> Ok, to summarize. The problem here is a chain of problems ..
> 
> First: there has been a not backward compatible change in the
> (undocumented?) API in one of Sphinx-doc's dependencies (in
> docutils 0.13.1). 

Yeah, that's it. Doing a
	pip install 'docutils==0.12'

at the virtual env solved the issue. I guess we should document it
somewhere.


Thanks,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux