2021-05-26 13:27:41

by Lee Jones

Subject: [PATCH 02/24] usb: dwc2: platform: Provide function name for 'dwc2_check_core_version()'

Fixes the following W=1 kernel build warning(s):

drivers/usb/dwc2/platform.c:411: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Cc: Minas Harutyunyan <[email protected]>
Cc: Greg Kroah-Hartman <[email protected]>
Cc: Philipp Zabel <[email protected]>
Cc: Liam Girdwood <[email protected]>
Cc: Mark Brown <[email protected]>
Cc: Matthijs Kooijman <[email protected]>
Cc: [email protected]
Signed-off-by: Lee Jones <[email protected]>
---
drivers/usb/dwc2/platform.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/drivers/usb/dwc2/platform.c b/drivers/usb/dwc2/platform.c
index 520a0beef77ca..c8f18f3ba9e35 100644
--- a/drivers/usb/dwc2/platform.c
+++ b/drivers/usb/dwc2/platform.c
@@ -408,7 +408,7 @@ static bool dwc2_check_core_endianness(struct dwc2_hsotg *hsotg)
}

/**
- * Check core version
+ * dwc2_check_core_version() - Check core version
*
* @hsotg: Programming view of the DWC_otg controller
*
--
2.31.1

2021-05-26 15:12:37

by Minas Harutyunyan

Subject: Re: [PATCH 02/24] usb: dwc2: platform: Provide function name for 'dwc2_check_core_version()'

On 5/26/2021 5:00 PM, Lee Jones wrote:
> Fixes the following W=1 kernel build warning(s):
>
> drivers/usb/dwc2/platform.c:411: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>
> Cc: Minas Harutyunyan <[email protected]>
> Cc: Greg Kroah-Hartman <[email protected]>
> Cc: Philipp Zabel <[email protected]>
> Cc: Liam Girdwood <[email protected]>
> Cc: Mark Brown <[email protected]>
> Cc: Matthijs Kooijman <[email protected]>
> Cc: [email protected]
> Signed-off-by: Lee Jones <[email protected]>


Acked-by: Minas Harutyunyan <[email protected]>


> ---
> drivers/usb/dwc2/platform.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/drivers/usb/dwc2/platform.c b/drivers/usb/dwc2/platform.c
> index 520a0beef77ca..c8f18f3ba9e35 100644
> --- a/drivers/usb/dwc2/platform.c
> +++ b/drivers/usb/dwc2/platform.c
> @@ -408,7 +408,7 @@ static bool dwc2_check_core_endianness(struct dwc2_hsotg *hsotg)
> }
>
> /**
> - * Check core version
> + * dwc2_check_core_version() - Check core version
> *
> * @hsotg: Programming view of the DWC_otg controller
> *
>