Thread (28 messages) 28 messages, 7 authors, 2020-07-08
STALE2203d LANDED

[PATCH 14/15] mmc: host: cqhci: Demote faux kerneldoc header down to basic comment block

From: Lee Jones <hidden>
Date: 2020-07-01 12:47:38
Also in: lkml
Subsystem: emmc cmdq host controller interface (cqhci) driver, multimedia card (mmc), secure digital (sd) and sdio subsystem, the rest · Maintainers: Adrian Hunter, Asutosh Das, Ulf Hansson, Linus Torvalds

cqhci_host_alloc_tdl()'s function header is the only one in
kerneldoc format.  Which seems odd as it's not part of an
external API and isn't referenced anywhere else.  Seeing as
there has also been no attempt to describe the expected
function arguments either, we're going to assume that this is
not actually a bona fide kerneldoc use-case.

Fixes the following W=1 kernel build warning:

 drivers/mmc/host/cqhci.c:163: warning: Function parameter or member 'cq_host' not described in 'cqhci_host_alloc_tdl'

Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Ritesh Harjani <redacted>
Cc: Asutosh Das <redacted>
Cc: Venkat Gopalakrishnan <redacted>
Signed-off-by: Lee Jones <redacted>
---
 drivers/mmc/host/cqhci.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/drivers/mmc/host/cqhci.c b/drivers/mmc/host/cqhci.c
index 75934f3c117eb..8cc277b4ffe9e 100644
--- a/drivers/mmc/host/cqhci.c
+++ b/drivers/mmc/host/cqhci.c
@@ -144,7 +144,7 @@ static void cqhci_dumpregs(struct cqhci_host *cq_host)
 		CQHCI_DUMP(": ===========================================\n");
 }
 
-/**
+/*
  * The allocated descriptor table for task, link & transfer descritors
  * looks like:
  * |----------|
-- 
2.25.1


_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help