2021-07-23 02:27:43

by Randy Dunlap

Subject: [PATCH] phy: qualcomm: phy-qcom-usb-hs: repair non-kernel-doc comment

Fix errant use of "/**" to begin a comment although the comment
is not kernel-doc notation. Just use "/*" instead.

Fixes this kernel-doc warning:

drivers/phy/qualcomm/phy-qcom-usb-hs.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Copyright (C) 2016 Linaro Ltd

Signed-off-by: Randy Dunlap <[email protected]>
Reported-by: kernel test robot <[email protected]>
Cc: Andy Gross <[email protected]>
Cc: Bjorn Andersson <[email protected]>
Cc: [email protected]
Cc: Kishon Vijay Abraham I <[email protected]>
Cc: Vinod Koul <[email protected]>
Cc: [email protected]
---
drivers/phy/qualcomm/phy-qcom-usb-hs.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

--- linux-next-20210722.orig/drivers/phy/qualcomm/phy-qcom-usb-hs.c
+++ linux-next-20210722/drivers/phy/qualcomm/phy-qcom-usb-hs.c
@@ -1,5 +1,5 @@
// SPDX-License-Identifier: GPL-2.0-only
-/**
+/*
* Copyright (C) 2016 Linaro Ltd
*/
#include <linux/module.h>

2021-08-06 17:50:50

by Vinod Koul

Subject: Re: [PATCH] phy: qualcomm: phy-qcom-usb-hs: repair non-kernel-doc comment

On 22-07-21, 19:25, Randy Dunlap wrote:
> Fix errant use of "/**" to begin a comment although the comment
> is not kernel-doc notation. Just use "/*" instead.
>
> Fixes this kernel-doc warning:
>
> drivers/phy/qualcomm/phy-qcom-usb-hs.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> * Copyright (C) 2016 Linaro Ltd

Applied, thanks

--
~Vinod