Re: [PATCH v2 5/5] watchdog: dev: convert to kernel-doc comments

Guenter Roeck <[email protected]>
Newsgroups org.kernel.vger.linux-watchdog,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
On 6/30/26 11:54, Manuel Ebner wrote:
> On Fri, 2026-05-29 at 14:20 -0700, Randy Dunlap wrote:
>> [...]
>>
>> @@ -659,7 +659,7 @@ __ATTRIBUTE_GROUPS(wdt);
>>   #define wdt_groups	NULL
>>   #endif
>>   
>> -/*
>> +/**
>>    * watchdog_ioctl_op - call the watchdog drivers ioctl op if defined
> 
> Maybe this is better:
>    * watchdog_ioctl_op - call the watchdog drivers ioctl operation if defined
>   
>> [...]
>> @@ -732,7 +732,7 @@ static ssize_t watchdog_write(struct fil
>>   	return len;
>>   }
>>   
>> -/*
>> +/**
>>    * watchdog_ioctl - handle the different ioctl's for the watchdog device
> 
> I think it's plural:
>    * watchdog_ioctl - handle the different ioctls for the watchdog device
> 
>>    * @file:	File handle to the device
>>    * @cmd:	Watchdog command
> 

This patch is in the upstream kernel. You are a bit late.
Also, the scope of the patch was not to fix the text but
to convert function comments to kernel-doc format.

Please feel free to submit textual changes as separate patches.

Thanks,
Guenter
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.