From patchwork Wed Jul 1 12:47:01 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 11636261 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id A6422913 for ; Wed, 1 Jul 2020 12:49:52 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 7E32D20702 for ; Wed, 1 Jul 2020 12:49:52 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="corA6iB/"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="Igf8FH8P" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 7E32D20702 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=Cf7slLzDBILqCjkWppwQ80veHCKcPmBaFjzq04zMEJ4=; b=corA6iB/i2xKYMFzekpUN80jY ZJzxTOd9QmuIyWCVZOabYSR8h4oHX4hA8me3sBBmpbdLNT2pvnTjuwn6D4envkvKldRUsHDSW+bWK 4eNHuC5OcT/p5BugNVjOO7jaVbFLylgwBRAA9CSQkPiC4jbPpVyzV4TFN5WZIu9r3P3PdlTQ0V0LH BDtEQX6cxrlHepl10sBntSbaPWDq/OJJWzlXProvqD6Gb6f7NcTsWfvCEkIU3yuHwz3DUodrTt7f6 UQg9PwdlwwgZFlRbmrqG/YA5doxHzplxeUVk5hxVO/j5OyjHltRQ51llQI9GfDriMAWsCeyHoc6ku 4btrYr98A==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jqc9y-0005UK-5k; Wed, 01 Jul 2020 12:48:18 +0000 Received: from mail-wr1-x441.google.com ([2a00:1450:4864:20::441]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jqc96-0004vJ-0c for linux-arm-kernel@lists.infradead.org; Wed, 01 Jul 2020 12:47:25 +0000 Received: by mail-wr1-x441.google.com with SMTP id z2so1403227wrp.2 for ; Wed, 01 Jul 2020 05:47:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=/gJoWFYQiS/u+V7Ey4cmwChdFCLsRE9Rx9263Z1oots=; b=Igf8FH8P6hdkKsVgk8CXs7RoyZeMUEAvTEJYQNZTp+t1LZgNAkLAKn1BdcIPG5ZX+l rscNT7GY/DyCGgRlpTTWOdkLo4LYCl5AlyBQlbjLGBfXsj67ylvJikQahonpLj2+TQha uGBfi+wjKp90MOfhsiMWYRykE3LoUQTwgn6t/1qoYt3cyVOAexgadrj38SqB/FGtO1gQ QoQcTgXLOTl8lEbQsPCii0mmEt4TA4/XesunG6isjLxX+Zwy2Y4t4fkNu8Nky1qAxPK7 BJZG7JB8EMZX6mj1Wi0VDor+x6Cg/whhx+TytTWoqbboaEQAa91Ca+0mUl4Dapdbwzu0 Tj7Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=/gJoWFYQiS/u+V7Ey4cmwChdFCLsRE9Rx9263Z1oots=; b=TsyaQy8axHhOa5j5gsXLBGEzDWJZoVMYkOfsLWqakYZZCfxLESnfJ9gx1hD8vkzRsT th4cDP6rYqYDrWdEvF4w8k/yifri6Mx5xscXFFZcp5+sihftAX+m2Vy1YZDvGsjIw8Vh Vt8z6AGJ3hOE+71wSCmXaUwv8Vjjbs0NpYhkXbSpec6QnqVPJz2EX6t/lnLkZgKdVKHd cMe7Eqq4XN+I40kyDmooptEbY/rqt+xo5zvwODHwOAyzhxUsz21ZDbDS35GDgCCjFZH5 5vXc1y1nTt97ISDA3/IBRXBwyQn7DCaQvM4AT3Mat8A+bVr9PwK4im9ZLd9/yWBojUIX iKzA== X-Gm-Message-State: AOAM5318CdvW5TQNWzEP210tVlaWvUF/mlfR7ky7sMJ6mp33xfDGH2pq wNi/fTLgL3ZY7SXn82xqiOpWGw== X-Google-Smtp-Source: ABdhPJxRDPkGlJlU4XJGQ/sleeyke1ZZuspWu101J6VUjlcK6F+a1bbhWf8+qWg+jb+I/TlCTyJOJA== X-Received: by 2002:a5d:6846:: with SMTP id o6mr26809049wrw.370.1593607643127; Wed, 01 Jul 2020 05:47:23 -0700 (PDT) Received: from localhost.localdomain ([2.27.35.144]) by smtp.gmail.com with ESMTPSA id o29sm7817862wra.5.2020.07.01.05.47.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 01 Jul 2020 05:47:22 -0700 (PDT) From: Lee Jones To: ulf.hansson@linaro.org Subject: [PATCH 14/15] mmc: host: cqhci: Demote faux kerneldoc header down to basic comment block Date: Wed, 1 Jul 2020 13:47:01 +0100 Message-Id: <20200701124702.908713-15-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200701124702.908713-1-lee.jones@linaro.org> References: <20200701124702.908713-1-lee.jones@linaro.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200701_084724_218775_48D77FEF X-CRM114-Status: GOOD ( 14.79 ) X-Spam-Score: -0.2 (/) X-Spam-Report: SpamAssassin version 3.4.4 on merlin.infradead.org summary: Content analysis details: (-0.2 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [2a00:1450:4864:20:0:0:0:441 listed in] [list.dnswl.org] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Ritesh Harjani , Venkat Gopalakrishnan , linux-kernel@vger.kernel.org, Adrian Hunter , Lee Jones , linux-arm-kernel@lists.infradead.org, Asutosh Das Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org 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 Cc: Ritesh Harjani Cc: Asutosh Das Cc: Venkat Gopalakrishnan Signed-off-by: Lee Jones Acked-by: Adrian Hunter --- 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: * |----------|