Re: [PATCH 00/10] Documentation/Sphinx

From: Mauro Carvalho Chehab
Date: Mon May 30 2016 - 17:23:34 EST

Em Mon, 30 May 2016 23:05:34 +0300
Jani Nikula <jani.nikula@xxxxxxxxx> escreveu:

> > I worry a little bit in that reST will be only one more toolchain
> > beside DocBook .. in the long term, kernel's documentation
> > should get rid of all the DocBook artifacts and for this a more
> > comprehensive solution is needed.
> We agree on the end goal, eradicate DocBook. I must say that in my
> experiments, apart from the media docs, almost everything converts
> surprisingly nicely or IMO "good enough" with just the tmplcvt script in
> this series.

With regards to media, my plan is to merge create a topic branch based
on Kernel 4.7-rc1 at:

As none of the Jani's patches seem to affect the media API docs, it
seems I don't need to merge back from Jon's -next branch.

There, I intend to add Markus patches with the conversion from the
DocBook to rst, plus the flat-table extension logic.

Then, I'll work to manually fix what's needed and I'll add the
automation scripting logic that we have at the DocBook Makefile
to work with the new media rst files.

Lastly, once the job's done, I'll drop Documentation/DocBook/media.


With that regards, could you please send the patches to me?