Re: [linux-next:master 2636/3192] drivers/fpga/dfl.c:154: warning: Function parameter or struct member 'fdata' not described in 'dfl_fpga_port_ops_get'

From: Xu Yilun
Date: Wed Dec 18 2024 - 09:57:09 EST


> These warnings may be resolved by amending commit a25cd37037c8 ("fpga:
> dfl: refactor internal DFL APIs to take/return feature device data").
>
> --- a/drivers/fpga/dfl.c
> +++ b/drivers/fpga/dfl.c
> @@ -145,7 +145,7 @@ static LIST_HEAD(dfl_port_ops_list);
>
> /**
> * dfl_fpga_port_ops_get - get matched port ops from the global list
> - * @pdata: platform data to match with associated port ops.
> + * @fdata: feature dev data to match with associated port ops.
> * Return: matched port ops on success, NULL otherwise.
> *
> * Please note that must dfl_fpga_port_ops_put after use the port_ops.
> @@ -211,7 +211,7 @@ EXPORT_SYMBOL_GPL(dfl_fpga_port_ops_del);
>
> /**
> * dfl_fpga_check_port_id - check the port id
> - * @pdata: port platform data.
> + * @fdata: port feature dev data.
> * @pport_id: port id to compare.
> *
> * Return: 1 if port device matches with given port id, otherwise 0.

I've fixed, ran scripts/kernel-doc and pushed for all 3 patches.

Thanks,
Yilun