lkml.org 
[lkml]   [2016]   [May]   [30]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH 00/10] Documentation/Sphinx
Em Mon, 30 May 2016 23:05:34 +0300
Jani Nikula <jani.nikula@intel.com> 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:
https://git.linuxtv.org/media_tree.git/

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.

Markus,

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

Thanks,
Mauro

\
 
 \ /
  Last update: 2016-05-30 23:41    [W:0.161 / U:0.168 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site