Re: [PATCH v2 00/38] Documentation/sphinx

From: Jonathan Corbet
Date: Thu Jun 09 2016 - 15:55:29 EST


On Sat, 4 Jun 2016 14:37:01 +0300
Jani Nikula <jani.nikula@xxxxxxxxx> wrote:

> When this lands in docs-next and we can backmerge to drm, we'll plunge
> ahead and convert gpu.tmpl to rst, and have that ready for v4.8.

That is now done â thanks for running with this! I'm looking forward to
seeing where we can take it from here.

One little thing: there's a bunch of new warnings in the htmldocs build:

.//include/net/mac80211.h:671: warning: duplicate section name 'Description'
.//include/net/mac80211.h:3174: warning: duplicate section name 'Description'

Some quick messing around suggests that it happens when a kerneldoc entry
has free text both above and below the parameter list; there aren't many
such places. I can send in a patch for mac80211.h to silence most of it,
but it might be nice if it worked as before without whining.

Thanks,

jon