From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E6CB3C433E0 for ; Wed, 1 Jul 2020 12:47:38 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id C359120702 for ; Wed, 1 Jul 2020 12:47:38 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="Igf8FH8P" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730725AbgGAMrh (ORCPT ); Wed, 1 Jul 2020 08:47:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34864 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730680AbgGAMrY (ORCPT ); Wed, 1 Jul 2020 08:47:24 -0400 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5D93AC03E97B for ; Wed, 1 Jul 2020 05:47:24 -0700 (PDT) Received: by mail-wr1-x441.google.com with SMTP id r12so23600909wrj.13 for ; Wed, 01 Jul 2020 05:47:24 -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=oiSKHVIhuaXmF45PUN9X+YO7mLND8zATw4VZSjon+LuxzgVlP8Jz1Ul8Q18OUWQr4c 6O5RqMvmJacuQfHWzYND6kXaBqZxA4ulkBMzjdhkDbaBxHskfTEUQrbatxQMhdYJ+H2O XAsgEHYCk7kPySpvOyA91AQpvNt4mK2cAGbbA2DPIc4C3vseLBxYFvTDlDHo5fDCQOzM 5V45xNd1z4LNPOANre7ogfWjSeKlNIFFomMhkhxolGcJBRPoFPUb09HTbqZaimtFFQi2 I0T5Ge8Aj4MLZBpYTJAVus/DOxoqA35cHijqaVUi4OuANICLiDvBjRwoezX3s6atb7Lc uraA== X-Gm-Message-State: AOAM533PVb8jy9RjLYxqok6VopeHgPtwSbEW3tym69EApZyBYjA0pDzu fMgjma9FyWMR4xzrV4IsAD2SeA== 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 Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Lee Jones , Adrian Hunter , Ritesh Harjani , Asutosh Das , Venkat Gopalakrishnan 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 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.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 --- 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 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.0 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id A72B7C433DF for ; Wed, 1 Jul 2020 12:49:44 +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 7016A20772 for ; Wed, 1 Jul 2020 12:49:44 +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 7016A20772 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+linux-arm-kernel=archiver.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-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 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.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 --- 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