[PATCH 1/5] PCI: Fix kernel-doc formatting

Bjorn Helgaas helgaas at kernel.org
Tue Jul 6 09:22:01 PDT 2021


On Sat, Jul 03, 2021 at 03:13:02PM +0000, Krzysztof Wilczyński wrote:
> Fix kernel-doc formatting of function pci_dev_set_io_state(), and
> resolve build time warnings related to kernel-doc:
> 
>   drivers/pci/pci.h:337: warning: Function parameter or member 'dev' not described in 'pci_dev_set_io_state'
>   drivers/pci/pci.h:337: warning: Function parameter or member 'new' not described in 'pci_dev_set_io_state'
> 
> No change to functionality intended.
> 
> Signed-off-by: Krzysztof Wilczyński <kw at linux.com>

I squashed these together and applied to pci/kernel-doc for v5.14,
thanks!

> ---
>  drivers/pci/pci.h | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/drivers/pci/pci.h b/drivers/pci/pci.h
> index 37c913bbc6e1..c1ac65cc4572 100644
> --- a/drivers/pci/pci.h
> +++ b/drivers/pci/pci.h
> @@ -324,8 +324,8 @@ struct pci_sriov {
>  /**
>   * pci_dev_set_io_state - Set the new error state if possible.
>   *
> - * @dev - pci device to set new error_state
> - * @new - the state we want dev to be in
> + * @dev: pci device to set new error_state
> + * @new: the state we want dev to be in
>   *
>   * Must be called with device_lock held.
>   *
> -- 
> 2.32.0
> 



More information about the linux-arm-kernel mailing list