drm/panthor: Fix kernel-doc warning in panthor_sched.c
Subsystems (3)
PATCH 1/1 drm/panthor: Fix kernel-doc warning in panthor_sched.c
Fix the following W=1 kerneldoc warnings by adding the missing parameter descriptions for @ptdev and @events in panthor_sched_report_fw_events() and @ptdev in panthor_sched_report_mmu_fault()
Warning: drivers/gpu/drm/panthor/panthor_sched.c:1898 function parameter 'ptdev' not described in 'panthor_sched_report_fw_events'
Warning: drivers/gpu/drm/panthor/panthor_sched.c:1898 function parameter 'events' not described in 'panthor_sched_report_fw_events'
Warning: drivers/gpu/drm/panthor/panthor_sched.c:2783 function parameter 'ptdev' not described in 'panthor_sched_report_mmu_fault'
--- drivers/gpu/drm/panthor/panthor_sched.c | 3 +++ 1 file changed, 3 insertions(+)
drivers/gpu/drm/panthor/panthor_sched.c +3 -0
@@ -1894,6 +1894,8 @@ static void process_fw_events_work(struct work_struct *work)/** * panthor_sched_report_fw_events() - Report FW events to the scheduler. +* @ptdev: Device. +* @events: Bitmask of pending FW events to report. */ void panthor_sched_report_fw_events (struct panthor_device *ptdev,u32 events) {
@@ -2779,6 +2781,7 @@ static void panthor_group_start(struct panthor_group *group)/** * panthor_sched_report_mmu_fault() - Report MMU faults to the scheduler. +* @ptdev: Device. */ void panthor_sched_report_mmu_fault (struct panthor_device *ptdev) {
Signature · 1 line
2.53.0
Quoted 10 lines · On Sun, 5 Apr 2026 20:23:09 +0100 Yicong Hui <[email protected]> wrote:
Fix the following W=1 kerneldoc warnings by adding the missing parameter descriptions for @ptdev and @events in
panthor_sched_report_fw_events()and @ptdev inpanthor_sched_report_mmu_fault()Warning:
drivers/gpu/drm/panthor/panthor_sched.c:1898function parameter 'ptdev' not described in 'panthor_sched_report_fw_events'
Warning:drivers/gpu/drm/panthor/panthor_sched.c:1898function parameter 'events' not described in 'panthor_sched_report_fw_events'
Warning:drivers/gpu/drm/panthor/panthor_sched.c:2783function parameter 'ptdev' not described in 'panthor_sched_report_mmu_fault'Fixes de8548813824 ("drm/panthor: Add the scheduler logical block")Signed-off-by Yicong Hui <[email protected]>
Quoted 25 lines
--- drivers/gpu/drm/panthor/panthor_sched.c | 3 +++ 1 file changed, 3 insertions(+)drivers/gpu/drm/panthor/panthor_sched.c +3
-0@@ -1894,6 +1894,8 @@ static void process_fw_events_work(struct work_struct *work)/** * panthor_sched_report_fw_events() - Report FW events to the scheduler. +* @ptdev: Device. +* @events: Bitmask of pending FW events to report. */ void panthor_sched_report_fw_events (struct panthor_device *ptdev,u32 events) {@@ -2779,6 +2781,7 @@ static void panthor_group_start(struct panthor_group *group)/** * panthor_sched_report_mmu_fault() - Report MMU faults to the scheduler. +* @ptdev: Device. */ void panthor_sched_report_mmu_fault (struct panthor_device *ptdev) {
Quoted 10 lines · Yicong Hui
Fix the following W=1 kerneldoc warnings by adding the missing parameter descriptions for @ptdev and @events in
panthor_sched_report_fw_events()and @ptdev inpanthor_sched_report_mmu_fault()Warning:
drivers/gpu/drm/panthor/panthor_sched.c:1898function parameter 'ptdev' not described in 'panthor_sched_report_fw_events'
Warning:drivers/gpu/drm/panthor/panthor_sched.c:1898function parameter 'events' not described in 'panthor_sched_report_fw_events'
Warning:drivers/gpu/drm/panthor/panthor_sched.c:2783function parameter 'ptdev' not described in 'panthor_sched_report_mmu_fault'Fixes de8548813824 ("drm/panthor: Add the scheduler logical block")Signed-off-by Yicong Hui <[email protected]>
Thanks, I actually have a patch I've been meaning to send for this. There's a few more kerneldoc issues in this file (documentation doesn't get output but there's no warning) - I'll push this to drm-misc-next and send a patch for the remaining issues.
Thanks,
Steve
Quoted 25 lines
--- drivers/gpu/drm/panthor/panthor_sched.c | 3 +++ 1 file changed, 3 insertions(+)drivers/gpu/drm/panthor/panthor_sched.c +3
-0@@ -1894,6 +1894,8 @@ static void process_fw_events_work(struct work_struct *work)/** * panthor_sched_report_fw_events() - Report FW events to the scheduler. +* @ptdev: Device. +* @events: Bitmask of pending FW events to report. */ void panthor_sched_report_fw_events (struct panthor_device *ptdev,u32 events) {@@ -2779,6 +2781,7 @@ static void panthor_group_start(struct panthor_group *group)/** * panthor_sched_report_mmu_fault() - Report MMU faults to the scheduler. +* @ptdev: Device. */ void panthor_sched_report_mmu_fault (struct panthor_device *ptdev) {