Re: make xmldocs failed with error after 4.17 merge period
From: Heikki Krogerus
Date: Fri Apr 06 2018 - 06:52:02 EST
Hi Markus,
On Fri, Apr 06, 2018 at 12:03:55PM +0200, Markus Heiser wrote:
> >> There are ways to do this, look at how the v4l2 and I think the drm
> >> subsystems handle ascii art such that "real" drawings end up being
> >> produced.
> >
> > Thanks. I did not actually find anything else except use of tables and
> > code-blocks in v4l documentation. Is that what you were referring?
>
> If it is about *figures*: we have a directive named 'kernel-figure',
> which is a full replacement of the 'figure' directive from Sphinx-Doc.
> In addition it supports *inline* SVG and DOT markups. Read:
>
> https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html#figures-images
Thanks for the info.
I don't want to use for example dot language in kernel documentation.
I want to be able to clearly see the figure also from the plain text
file. That's why I prefer ascii art.
Isn't there a way we could render ascii art as svg diagram?
Br,
--
heikki