Re: [PATCH 5/9] kernel-api.tmpl: convert it to ReST

Mauro Carvalho Chehab
2017-03-31T18:12:28Z

Em Fri, 31 Mar 2017 09:05:37 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Thu, 30 Mar 2017 17:11:32 -0300
> Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
>
> > Brainless conversion of genericirq.tmpl book to ReST, via
> > Documentation/sphinx/tmplcvt
>
> This one kind of showcases why I'm nervous about bulk conversions. It's
> a bit of a dumping-ground document, with a bit of everything, and I think
> we can do better. And, in particular, this one contains a bunch of stuff
> that belongs in the driver-api manual instead. So, at a minimum, I would
> really like to see this template split across those two manuals.

Yeah, I was in doubt if it should be either at driver-api or core-api
manuals.

> If you promise me a followup patch doing that, maybe I can go ahead and
> merge this series now :)

Surely I can do a patch moving things around.

> (That's mildly complicated by the fact that you didn't send me parts 6,
> 8, and 9; I really would rather get the whole series in cases like this.)

Sorry. Just forwarded those missing parts to your e-mail.

They basically fix some kernel-doc headers that are not properly
parsed by Sphinx.

Thanks,
Mauro