Subject: Re: [PATCH net-next] net/iucv: clean up iucv kernel-doc warnings

From: Jakub Kicinski <[email-masked]>
Date: Sat, 31 Jan 2026 13:11:31 -0800

On Thu, 29 Jan 2026 21:47:59 -0800 Randy Dunlap wrote:
>  /**
> - * __iucv_message_receive
> + * __iucv_message_receive - Terminates an IUCV path.

AI code review complains this is odd wording since the main body
describes reception not termination.

>   * @path: address of iucv path structure
>   * @msg: address of iucv msg structure
>   * @flags: flags that affect how the message is received (IUCV_IPBUFLST)
> @@ -374,7 +363,7 @@ int __iucv_message_receive(struct iucv_p
>  			   size_t *residual);
>  
>  /**
> - * iucv_message_reject
> + * iucv_message_reject - Refuses a specified message
>   * @path: address of iucv path structure
>   * @msg: address of iucv msg structure
>   *
> @@ -387,7 +376,7 @@ int __iucv_message_receive(struct iucv_p
>  int iucv_message_reject(struct iucv_path *path, struct iucv_message *msg);
>  
>  /**
> - * iucv_message_reply
> + * iucv_message_reply - Refuses a specified message

Same here, refuses or replies?

>   * @path: address of iucv path structure
>   * @msg: address of iucv msg structure
>   * @flags: how the reply is sent (IUCV_IPRMDATA, IUCV_IPPRTY, IUCV_IPBUFLST)

In general -- Could we possibly delete the duplicated kdocs in 
the header. As clearly shown by this patch it's double the work
and kernel-doc will be able to find the definition wherever it is.
Kernel coding guide recommends kdoc next to definition.
-- 
pw-bot: cr