Re: [PATCH RESEND] iopoll: fix parameter names in kernel-doc

From: Randy Dunlap

Date: Fri Mar 06 2026 - 14:39:48 EST




On 3/6/26 2:31 AM, Jani Nikula wrote:
> On Thu, 05 Mar 2026, Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:
>> Correct the parameter names to avoid kernel-doc warnings:
>>
>> Warning: include/linux/iopoll.h:169 function parameter 'sleep_us' not
>> described in 'read_poll_timeout_atomic'
>> Warning: ../include/linux/iopoll.h:169 function parameter
>> 'sleep_before_read' not described in 'read_poll_timeout_atomic'
>
> I think the right fix is to rename the parameters instead. They're
> passed on to poll_timeout_us_atomic() where the parameters are called
> delay_us and delay_before_op, emphasizing that this is atomic i.e. no
> sleep.

OK, will do.
Thanks.

--
~Randy