drm/sched: Fix kernel-doc warning for drm_sched_job_done()

Yujie-Liu · opsiff · commit 0d8d654a9abb · 2026-03-31T15:45:47.000+08:00
[ Upstream commit 61ded10 ] There is a kernel-doc warning for the scheduler: Warning: drivers/gpu/drm/scheduler/sched_main.c:367 function parameter 'result' not described in 'drm_sched_job_done' Fix the warning by describing the undocumented error code. Fixes: 539f9ee ("drm/scheduler: properly forward fence errors") Signed-off-by: Yujie Liu <yujie.liu@intel.com> [phasta: Flesh out commit message] Signed-off-by: Philipp Stanner <phasta@kernel.org> Link: https://patch.msgid.link/20260227082452.1802922-1-yujie.liu@intel.com Signed-off-by: Sasha Levin <sashal@kernel.org> (cherry picked from commit 5d53fe502ef484821b41eed231bae87ce7c9fc78) Signed-off-by: Wentao Guan <guanwentao@uniontech.com>
diff --git a/drivers/gpu/drm/scheduler/sched_main.c b/drivers/gpu/drm/scheduler/sched_main.c
@@ -259,6 +259,7 @@ drm_sched_rq_select_entity_fifo(struct drm_sched_rq *rq)
 /**
  * drm_sched_job_done - complete a job
  * @s_job: pointer to the job which is done
+ * @result: 0 on success, -ERRNO on error
  *
  * Finish the job's fence and wake up the worker thread.
  */

Original file line number	Diff line number	Diff line change
`@@ -259,6 +259,7 @@ drm_sched_rq_select_entity_fifo(struct drm_sched_rq *rq)`
`259`	`259`	`/**`
`260`	`260`	`* drm_sched_job_done - complete a job`
`261`	`261`	`* @s_job: pointer to the job which is done`
	`262`	`+ * @result: 0 on success, -ERRNO on error`
`262`	`263`	`*`
`263`	`264`	`* Finish the job's fence and wake up the worker thread.`
`264`	`265`	`*/`