On Fri, 21 Oct 2016, Johannes Berg <johannes@xxxxxxxxxxxxxxxx> wrote: >> > https://pythonhosted.org/sphinxcontrib-aafig/ >> > >> > I've not actually played with it at all, but I like the idea that >> > we'd have readable diagrams in the source docs as well... >> >> Well, maybe. I agree having it readable in the source docs as well is >> nice, but for sequence diagrams in particular, I don't think >> >> +-------+ +-----------+ >> | Hello +-------->+ aafigure! | >> +-------+ +-----------+ >> >> really beats >> >> Hello -> aafigure! > > > I found another one: > > https://pypi.python.org/pypi/sphinxcontrib-plantuml > > That one has really nice output and features, but ends up being a > *java* (of all the things) tool that the thing calls out to ... > > > Perhaps we can have a compromise and embed the raw text when the > tooling isn't all installed, so you can still build useful > documentation, but to get all the "prettiness" you might have to > install more dependencies? I had the same conclusion for math:: directives pulling in latex dependency [1]. Hopefully Markus can help here. BR, Jani. [1] http://lkml.kernel.org/r/877f93qdd2.fsf@xxxxxxxxx -- Jani Nikula, Intel Open Source Technology Center
