From patchwork Fri Jul 9 10:47:02 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ashok Reddy Soma X-Patchwork-Id: 1503006 X-Patchwork-Delegate: monstr@monstr.eu Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=85.214.62.61; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=xilinx.onmicrosoft.com header.i=@xilinx.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-xilinx-onmicrosoft-com header.b=dG6VNvDn; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4GLqcX0Sqyz9sSs for ; Fri, 9 Jul 2021 20:47:39 +1000 (AEST) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 5950F83246; Fri, 9 Jul 2021 12:47:36 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=xilinx.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=xilinx.onmicrosoft.com header.i=@xilinx.onmicrosoft.com header.b="dG6VNvDn"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 09E6D83246; Fri, 9 Jul 2021 12:47:34 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-0.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,FORGED_SPF_HELO,SPF_HELO_PASS autolearn=no autolearn_force=no version=3.4.2 Received: from NAM02-BN1-obe.outbound.protection.outlook.com (mail-bn1nam07on20627.outbound.protection.outlook.com [IPv6:2a01:111:f400:7eb2::627]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 1E52B83233 for ; Fri, 9 Jul 2021 12:47:31 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=xilinx.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=ashokred@xilinx.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=COZ6FEX09+96UojnSVgNACfiv+9WbpZaCgHK3pRtLzcDD9bSHzE3ZnDQ5RW0gba3kS0KFocK8NXQi3P8IT68831V91FcC4W+kYEHPpNOSn4E911uDypG0SIRF84v9qVe8uaf2OqFpGoe+/PSBD281vuF1ZcJjo3LGQIzh8F0uHwdfM7HZw6gsOdXjM0qTboOwnx+3GlrKGxKydvx55DI0sj0bn5YSsYcz4y/P8jJSoGpcao5TayXZLA4wv1inznxYqMSklFSbdk5svJvNax4d7nB71fKK7srxe3b9MzgwPpU10cqL+IwmJb/4PItgmx4S6JyI8ha6aY8ETC9ctNzoA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=HkGp5Udc3La73S5ZRbLr2mFxNkSaG396umibl4ltVGQ=; b=FZaIGohGCqHN+JSYuKttGSchvejvanBfgRv5GRnDkp+jDl6iRmwZUbpCI580kMKXUDpSFIC5ph3Bn8MtmzcT6EvKO+5d5C8rN8sOhmDG1llldh1a+NSc//CSjJiS3c2BiURP06W3hj+4cxjNJeha//pxR2QEhx1ykIJWsbw4BDGSfIeqtIvnDossnNrnMoodvC/685q2gS0Cp6o+jt9c3lK4qUrBIhVLNCyxoua/FqP0a3wWh0URlGPx9oSRiaL7EdMEGeG78gPgzkH1yYMFJKi3LYpBtzYYwHiBpiP4liWgcGO9tGRdaPcBtbMM6lgCfMnXuSD378/jZN0gPBzf9Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 149.199.62.198) smtp.rcpttodomain=gmail.com smtp.mailfrom=xilinx.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=xilinx.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector2-xilinx-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=HkGp5Udc3La73S5ZRbLr2mFxNkSaG396umibl4ltVGQ=; b=dG6VNvDnS5XANhBXICKc1tlsaAU0MZz6Bv/wTg/inhmqv+FBp4AbVP1rlLAZNACnzKrYG2sCizyIQv1AuMWGOMPxyVQADCRTFgw6MVVmOAGKmMWWSrd8yM4F3swID54ILbwU0Pl3/RxVSa59xm6fK/Xi34JckTbsTjeZeG3aTTU= Received: from DS7PR03CA0232.namprd03.prod.outlook.com (2603:10b6:5:3ba::27) by MN2PR02MB6862.namprd02.prod.outlook.com (2603:10b6:208:1d4::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4308.22; Fri, 9 Jul 2021 10:47:28 +0000 Received: from DM3NAM02FT048.eop-nam02.prod.protection.outlook.com (2603:10b6:5:3ba:cafe::99) by DS7PR03CA0232.outlook.office365.com (2603:10b6:5:3ba::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4308.20 via Frontend Transport; Fri, 9 Jul 2021 10:47:28 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 149.199.62.198) smtp.mailfrom=xilinx.com; gmail.com; dkim=none (message not signed) header.d=none;gmail.com; dmarc=pass action=none header.from=xilinx.com; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.62.198 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.62.198; helo=xsj-pvapexch02.xlnx.xilinx.com; Received: from xsj-pvapexch02.xlnx.xilinx.com (149.199.62.198) by DM3NAM02FT048.mail.protection.outlook.com (10.13.4.209) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.4308.20 via Frontend Transport; Fri, 9 Jul 2021 10:47:28 +0000 Received: from xsj-pvapexch02.xlnx.xilinx.com (172.19.86.41) by xsj-pvapexch02.xlnx.xilinx.com (172.19.86.41) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2176.2; Fri, 9 Jul 2021 03:47:08 -0700 Received: from smtp.xilinx.com (172.19.127.95) by xsj-pvapexch02.xlnx.xilinx.com (172.19.86.41) with Microsoft SMTP Server id 15.1.2176.2 via Frontend Transport; Fri, 9 Jul 2021 03:47:08 -0700 Envelope-to: git@xilinx.com, somaashokreddy@gmail.com, u-boot@lists.denx.de, monstr@monstr.eu, peng.fan@nxp.com, jh80.chung@samsung.com Received: from [10.140.6.65] (port=58706 helo=xhdashokred41.localdomain) by smtp.xilinx.com with esmtp (Exim 4.90) (envelope-from ) id 1m1o2E-0004a5-VL; Fri, 09 Jul 2021 03:47:07 -0700 Received: by xhdashokred41.localdomain (Postfix, from userid 2896) id 2E6591025D8; Fri, 9 Jul 2021 04:47:05 -0600 (MDT) From: Ashok Reddy Soma To: CC: , , , , , Michal Simek , Ashok Reddy Soma Subject: [PATCH v2 5/6] mmc: zynq_sdhci: Fix kernel doc warnings Date: Fri, 9 Jul 2021 04:47:02 -0600 Message-ID: <20210709104703.18843-6-ashok.reddy.soma@xilinx.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20210709104703.18843-1-ashok.reddy.soma@xilinx.com> References: <20210709104703.18843-1-ashok.reddy.soma@xilinx.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 45e7e3a9-3a83-459f-427b-08d942c6f20a X-MS-TrafficTypeDiagnostic: MN2PR02MB6862: X-Microsoft-Antispam-PRVS: X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-MS-Oob-TLC-OOBClassifiers: OLM:49; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: wWjFeO63oGSXfHATbbARkCtVd/4zyykj0U/uVOaU08BaXYBaApJARLCOEY9430j/18qEmS5/MFpZYe/JjnPZDe9nQ08PqTue9jA3zGS7XMx5OvruGzCOyyvqOL7u5fyxGQ+syh1H2WWbHBAlVAmnsZK0hQLZ6ZB0+kMIs2rJjC8ZDEcJQOQ9Cdz5qalltvFqmWqiETVIdWegS5LVijybiSJBupbWI1TdNBmnhPOL65ecqDxbtPbJVHqMTXsbjzY0dMatENMz58+4BtOxcjsfbq1ibvFpEstnDNaCxOdXih+OMM9TUDASuqJaK1/MGF1elPY0mt30yNbmvxxnKPwsaFVg9J2cnKCKVh3IfRcaXNgTxBfMjrqs/hJfvUWSwS3Dp0X+Ap0mxI/sBt3EtwkiUvpxc5oWDMowb+O0fLJeyJqTmOzy0K3zxIRLtLZvCJwgePxBvdE4zpANAMQ+SmxKHko+hCvdZtWxUrIBStTHiGpX/Tcp9c9bAkt+DMi5lVgQDDPtke7//G7TSDkCt9Uz0FezfoScndozuGOMx4XXbVGnRwb8FIanGYZVrMj9OQQ8WUAYZ8jweohgeybY5zDFNoIb//PH1kO+XTPERH7M+obH27EaqCDIjF+yiVxJRYeDk6slHzZ983/hAPQHuf26Dw01sz6PAAb1CgU3X7EhveJAObPmR9/TEicZxhEB0JlOsDFZjp2qmvuQ5TwS4nBZGw== X-Forefront-Antispam-Report: CIP:149.199.62.198; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:xsj-pvapexch02.xlnx.xilinx.com; PTR:unknown-62-198.xilinx.com; CAT:NONE; SFS:(4636009)(376002)(346002)(396003)(39860400002)(136003)(46966006)(36840700001)(36756003)(107886003)(82310400003)(54906003)(26005)(1076003)(36906005)(356005)(2616005)(186003)(5660300002)(70206006)(70586007)(6266002)(8676002)(36860700001)(7636003)(316002)(336012)(42186006)(8936002)(47076005)(83380400001)(478600001)(103116003)(4326008)(6666004)(6916009)(2906002)(82740400003); DIR:OUT; SFP:1101; X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Jul 2021 10:47:28.0452 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 45e7e3a9-3a83-459f-427b-08d942c6f20a X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.62.198]; Helo=[xsj-pvapexch02.xlnx.xilinx.com] X-MS-Exchange-CrossTenant-AuthSource: DM3NAM02FT048.eop-nam02.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR02MB6862 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.2 at phobos.denx.de X-Virus-Status: Clean From: Michal Simek Fix these kernel doc warnings: drivers/mmc/zynq_sdhci.c:181: warning: contents before sections drivers/mmc/zynq_sdhci.c:236: warning: contents before sections drivers/mmc/zynq_sdhci.c:291: warning: contents before sections drivers/mmc/zynq_sdhci.c:354: warning: contents before sections drivers/mmc/zynq_sdhci.c:467: warning: contents before sections Signed-off-by: Michal Simek Signed-off-by: Ashok Reddy Soma --- Changes in v2: - Removed @degree warning from commit description since it is fixed in patch 1/6. drivers/mmc/zynq_sdhci.c | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/drivers/mmc/zynq_sdhci.c b/drivers/mmc/zynq_sdhci.c index dd06b56838..1e6efb1cd4 100644 --- a/drivers/mmc/zynq_sdhci.c +++ b/drivers/mmc/zynq_sdhci.c @@ -181,11 +181,11 @@ static int arasan_sdhci_execute_tuning(struct mmc *mmc, u8 opcode) /** * sdhci_zynqmp_sdcardclk_set_phase - Set the SD Output Clock Tap Delays * - * Set the SD Output Clock Tap Delays for Output path - * * @host: Pointer to the sdhci_host structure. * @degrees: The clock phase shift between 0 - 359. * Return: 0 + * + * Set the SD Output Clock Tap Delays for Output path */ static int sdhci_zynqmp_sdcardclk_set_phase(struct sdhci_host *host, int degrees) @@ -237,11 +237,11 @@ static int sdhci_zynqmp_sdcardclk_set_phase(struct sdhci_host *host, /** * sdhci_zynqmp_sampleclk_set_phase - Set the SD Input Clock Tap Delays * - * Set the SD Input Clock Tap Delays for Input path - * * @host: Pointer to the sdhci_host structure. * @degrees: The clock phase shift between 0 - 359. * Return: 0 + * + * Set the SD Input Clock Tap Delays for Input path */ static int sdhci_zynqmp_sampleclk_set_phase(struct sdhci_host *host, int degrees) @@ -293,11 +293,11 @@ static int sdhci_zynqmp_sampleclk_set_phase(struct sdhci_host *host, /** * sdhci_versal_sdcardclk_set_phase - Set the SD Output Clock Tap Delays * - * Set the SD Output Clock Tap Delays for Output path - * * @host: Pointer to the sdhci_host structure. * @degrees: The clock phase shift between 0 - 359. * Return: 0 + * + * Set the SD Output Clock Tap Delays for Output path */ static int sdhci_versal_sdcardclk_set_phase(struct sdhci_host *host, int degrees) @@ -355,11 +355,11 @@ static int sdhci_versal_sdcardclk_set_phase(struct sdhci_host *host, /** * sdhci_versal_sampleclk_set_phase - Set the SD Input Clock Tap Delays * - * Set the SD Input Clock Tap Delays for Input path - * * @host: Pointer to the sdhci_host structure. * @degrees: The clock phase shift between 0 - 359. * Return: 0 + * + * Set the SD Input Clock Tap Delays for Input path */ static int sdhci_versal_sampleclk_set_phase(struct sdhci_host *host, int degrees) @@ -467,9 +467,9 @@ static void arasan_dt_read_clk_phase(struct udevice *dev, unsigned char timing, /** * arasan_dt_parse_clk_phases - Read Tap Delay values from DT * - * Called at initialization to parse the values of Tap Delays. - * * @dev: Pointer to our struct udevice. + * + * Called at initialization to parse the values of Tap Delays. */ static void arasan_dt_parse_clk_phases(struct udevice *dev) {