Re: [PATCH 02/30] usb: host: pci-quirks: Demote function header from kerneldoc to comment block

From: Mathias Nyman
Date: Fri Jul 03 2020 - 06:19:41 EST


On 2.7.2020 17.45, Lee Jones wrote:
> quirk_usb_handoff_xhci()'s function header is the only one across
> the sourcefile which is denoted as a kerneldoc header. Despite
> no attempt to document its arguments. Drop it down in status from
> kerneldoc to a standard comment block to match the other headers
> in the file.
>
> Fixes the following W=1 kernel build warning:
>
> drivers/usb/host/pci-quirks.c:1145: warning: Function parameter or member 'pdev' not described in 'quirk_usb_handoff_xhci'
>
> Cc: Mathias Nyman <mathias.nyman@xxxxxxxxx>
> Cc: Martin Mares <mj@xxxxxx>
> Cc: aleksey_gorelov@xxxxxxxxxxx
> Signed-off-by: Lee Jones <lee.jones@xxxxxxxxxx>

Acked-by: Mathias Nyman <mathias.nyman@xxxxxxxxxxxxxxx>