[PATCH 2/2] i3c: document i3c_xfers

[Frank Li]

On Tue, Dec 02, 2025 at 04:38:03PM +0100, alexandre.belloni at bootlin.com wrote:
> From: Alexandre Belloni <alexandre.belloni at bootlin.com>
>
> i3c_xfers was left undocumented, document it.
>
> Reported-by: Stephen Rothwell <sfr at canb.auug.org.au>
> Signed-off-by: Alexandre Belloni <alexandre.belloni at bootlin.com>
> ---

Reviewed-by: Frank Li <Frank.Li at nxp.com>

>  include/linux/i3c/master.h | 6 +++++-
>  1 file changed, 5 insertions(+), 1 deletion(-)
>
> diff --git a/include/linux/i3c/master.h b/include/linux/i3c/master.h
> index d0d5b3a9049f..2fd850f4678b 100644
> --- a/include/linux/i3c/master.h
> +++ b/include/linux/i3c/master.h
> @@ -418,7 +418,11 @@ struct i3c_bus {
>   * @send_ccc_cmd: send a CCC command
>   *		  This method is mandatory.
>   * @priv_xfers: do one or several private I3C SDR transfers
> - *		This method is mandatory.
> + *		This method is mandatory when i3c_xfers is not implemented. It
> + *		is deprecated.
> + * @i3c_xfers: do one or several I3C SDR or HDR transfers
> + *	       This method is mandatory when priv_xfers is not implemented but
> + *	       should be implemented instead of priv_xfers.
>   * @attach_i2c_dev: called every time an I2C device is attached to the bus.
>   *		    This is a good place to attach master controller specific
>   *		    data to I2C devices.
> --
> 2.52.0
>