[Intel-gfx] [PATCH] drm/i915/gem: placate scripts/kernel-doc

Matthew Auld matthew.auld at intel.com
Tue Nov 23 09:29:44 UTC 2021


On 23/11/2021 05:09, Randy Dunlap wrote:
> Correct kernel-doc warnings in i915_drm_object.c:
> 
> i915_gem_object.c:103: warning: expecting prototype for i915_gem_object_fini(). Prototype was for __i915_gem_object_fini() instead
> i915_gem_object.c:110: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>   * Mark up the object's coherency levels for a given cache_level
> i915_gem_object.c:110: warning: missing initial short description on line:
>   * Mark up the object's coherency levels for a given cache_level
> i915_gem_object.c:457: warning: No description found for return value of 'i915_gem_object_read_from_page'
> 
> Signed-off-by: Randy Dunlap <rdunlap at infradead.org>
> Reported-by: kernel test robot <lkp at intel.com>
> Cc: Thomas Hellström <thomas.hellstrom at linux.intel.com>
> Cc: Matthew Auld <matthew.auld at intel.com>
> Cc: Jani Nikula <jani.nikula at linux.intel.com>
> Cc: Joonas Lahtinen <joonas.lahtinen at linux.intel.com>
> Cc: Rodrigo Vivi <rodrigo.vivi at intel.com>
> Cc: Tvrtko Ursulin <tvrtko.ursulin at linux.intel.com>
> Cc: intel-gfx at lists.freedesktop.org
Reviewed-by: Matthew Auld <matthew.auld at intel.com>



More information about the Intel-gfx mailing list