[intel-lts:6.12/linux 4/4] drivers/gpu/drm/i915/gt/gen8_engine_cs.c:484: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot <lkp@intel.com>]

tree:   https://github.com/intel/linux-intel-lts.git 6.12/linux
head:   a9d3931257c927df409a753fabaad47d34915467
commit: a9d3931257c927df409a753fabaad47d34915467 [4/4] drm/i915: SR-IOV Save-Restore Feature support
config: i386-buildonly-randconfig-003-20250509 (https://download.01.org/0day-ci/archive/20250509/202505091030.Vqa0IZPJ-lkp@intel.com/config)
compiler: clang version 20.1.2 (https://github.com/llvm/llvm-project 58df0ef89dd64126512e4ee27b4ac3fd8ddf6247)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250509/202505091030.Vqa0IZPJ-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202505091030.Vqa0IZPJ-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/i915/gt/gen8_engine_cs.c:484: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Retrieve the ring position initial breadcrumb for given request.
   drivers/gpu/drm/i915/gt/gen8_engine_cs.c:700: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Fill an area of a ring with NOOP instructions.
   drivers/gpu/drm/i915/gt/gen8_engine_cs.c:725: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Refreshes commands on the ring associated to init_breadcrumb command packet.
   drivers/gpu/drm/i915/gt/gen8_engine_cs.c:769: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Refreshes commands on the ring associated to bb_start command packet.
--
>> drivers/gpu/drm/i915/gt/intel_ggtt.c:830: warning: Function parameter or struct member 'ggtt' not described in 'i915_ggtt_address_lock_init'
>> drivers/gpu/drm/i915/gt/intel_ggtt.c:830: warning: Excess function parameter 'i915' description in 'i915_ggtt_address_lock_init'
>> drivers/gpu/drm/i915/gt/intel_ggtt.c:840: warning: Function parameter or struct member 'ggtt' not described in 'i915_ggtt_address_lock_fini'
>> drivers/gpu/drm/i915/gt/intel_ggtt.c:840: warning: Excess function parameter 'i915' description in 'i915_ggtt_address_lock_fini'


vim +484 drivers/gpu/drm/i915/gt/gen8_engine_cs.c

   482	
   483	/**
 > 484	 * Retrieve the ring position initial breadcrumb for given request.
   485	 * @rq: the request instance
   486	 *
   487	 * Return: Ring position of commands emited by emit_init_breadcrumb().
   488	 */
   489	u32 get_init_breadcrumb_pos(struct i915_request *rq)
   490	{
   491		if (!rq->engine->emit_init_breadcrumb)
   492			return rq->infix;
   493	
   494		GEM_BUG_ON(rq->engine->emit_init_breadcrumb != gen8_emit_init_breadcrumb);
   495	
   496		if (!intel_timeline_has_initial_breadcrumb(rcu_access_pointer(rq->timeline)))
   497			return rq->infix;
   498	
   499		if (__intel_ring_count(rq->head, rq->infix, rq->ring->size) >
   500				GEN8_EMIT_INIT_BREADCRUMB_NUM_DWORDS * sizeof(u32))
   501			return intel_ring_wrap(rq->ring, rq->infix -
   502					       GEN8_EMIT_INIT_BREADCRUMB_NUM_DWORDS * sizeof(u32));
   503	
   504		return rq->head;
   505	}
   506	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki