[Intel-gfx] [PATCH] drm/i915: Fix a buch of kerneldoc warnings

Tvrtko Ursulin tvrtko.ursulin at linux.intel.com
Fri Jun 3 13:04:10 UTC 2016


On 02/06/16 21:21, Daniel Vetter wrote:
> On Thu, Jun 02, 2016 at 04:19:48PM +0100, Tvrtko Ursulin wrote:
>> From: Tvrtko Ursulin <tvrtko.ursulin at intel.com>
>>
>> Just a bunch of stale kerneldocs generating warnings when
>> building the docs. Mostly function parameters so not very
>> useful but still.
>>
>> Signed-off-by: Tvrtko Ursulin <tvrtko.ursulin at intel.com>
>> Cc: Daniel Vetter <daniel.vetter at ffwll.ch>
>
> Minor nit: Mostly we dont put a blank line between the title - purpose
> line and the start of the @parameter list. There's also a bunch of
> kerneldoc comments that don't even start with the function name. Do they
> work and show up correctly in the generated output?
>
> One more special case below

Okay respun, however I don't see that anything from i915_gem.c is 
showing up in the generated index - 
Documentation/output/html/genindex.html#I.

At least it is not throwing that many warnings during the build.

Tvrtko


More information about the Intel-gfx mailing list