From patchwork Tue Nov 16 10:39:46 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621959 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BF2B6C433F5 for ; Tue, 16 Nov 2021 10:40:38 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 8190360F44 for ; Tue, 16 Nov 2021 10:40:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 8190360F44 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=BvhdtxU5x4XBRAtfaG1RgPuFp3UEGlSXZtWiVK2npQA=; b=oadms+mxNstnNj 4CsR3dERkIq0r119TxSpqXY+O+75UUucHTnZ1KOHrJupPM1NT4P7bpUGi5i+EAMA3DQTIf8Be2NZS aKPqdpJYZopyua+IW3uclcMImg6nluLVdSerMfU5lq5DvEyKWSK+oXLCkgvKdr519wErDywP/R6OL 0vz0Hwt09W34nQeRahMwiWIzg7TjvsswUComO+X8y5d8QlSlfLk94Ui0kERr7AIFBrPgUHx+wpWn5 x2LL2bX8GUZAVwSSumi5q/1zezB+R8E0Sjf27nqQqLgNx5s3h16u+Kzr6GSRoCe9NThRElKsobwxH cI7wIBLa8MjhZkL/lSPA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtF-001F8g-Qf; Tue, 16 Nov 2021 10:40:37 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvsc-001Ey5-UR for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:00 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 96FDB63219; Tue, 16 Nov 2021 10:39:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059198; bh=KXVulQyk9zj7rAfwDnBQuE3jExJ9gnFzn/aqFe3RSzU=; h=From:To:Cc:Subject:Date:From; b=BpsHgfdJK0JErilME0uqhNp7mPH2m8XWz7IpHoWAQ9TzUPprWQbiPnQlihisP7axc V05AW2yBmfWGpIV554iUB0GbGFjIDpaPywnKIOHXB+JUMHkC/LwnnJyVJ1VCoNPJHL 09mgPmyC+JjTjuc5N7KA68oA94bQ/IppDLP+OZ3aLVuSBYgfjyvSOX/g6XGAGSnIoL itl8d1Cv4FeVFV/Uer6e0nngMi1sb+memK0uPGs9WLt0aeXzN1gTKR6a55O1+6f7+W KWbFxkuwZpWlDNC8TgTpGTO7HUz1iqzABFI4a9IH6vpsYjIiShcBKNdfJLwfZ6qclq Ome9uuHYVJ/lw== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Konstantin Porotchkin , linux-kernel@vger.kernel.org Subject: [PATCH 1/6] phy: mvebu-cp110-utmi: Fix kernel-doc warns Date: Tue, 16 Nov 2021 16:09:46 +0530 Message-Id: <20211116103951.34482-1-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_023959_061373_A1BF55F6 X-CRM114-Status: UNSURE ( 7.86 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org Fix the format and add description for ops to fix the below warnings: drivers/phy/marvell/phy-mvebu-cp110-utmi.c:94: warning: Function parameter or member 'syscon' not described in 'mvebu_cp110_utmi' drivers/phy/marvell/phy-mvebu-cp110-utmi.c:94: warning: Function parameter or member 'ops' not described in 'mvebu_cp110_utmi' Signed-off-by: Vinod Koul --- drivers/phy/marvell/phy-mvebu-cp110-utmi.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/phy/marvell/phy-mvebu-cp110-utmi.c b/drivers/phy/marvell/phy-mvebu-cp110-utmi.c index 08d178a4dc13..aa27c7994610 100644 --- a/drivers/phy/marvell/phy-mvebu-cp110-utmi.c +++ b/drivers/phy/marvell/phy-mvebu-cp110-utmi.c @@ -82,9 +82,9 @@ * struct mvebu_cp110_utmi - PHY driver data * * @regs: PHY registers - * @syscom: Regmap with system controller registers + * @syscon: Regmap with system controller registers * @dev: device driver handle - * @caps: PHY capabilities + * @ops: phy ops */ struct mvebu_cp110_utmi { void __iomem *regs; From patchwork Tue Nov 16 10:39:47 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621961 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3A5CFC433EF for ; Tue, 16 Nov 2021 10:40:39 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 05405613AC for ; Tue, 16 Nov 2021 10:40:39 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 05405613AC Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=jmY+6mM19KRb9zmcIyb2+fqoIl9DU+WIMu0GvDaKmrs=; b=twOb+Ydt6qX0Xe cErnQcMB5UDnclbrrFkp0xHJYrqEJ0i6LmJxY0WsM6kLG/j6IdKNbQCmnyAeRCJBGfJGV6xcWEVe9 ufk616lBjNAA/DkHymHYeQc+NB7v83vTX56axomWNyBpPCtYiZMDee0CiR0o1yqqxgdHjoqWrRhDZ sCVeLYloO5JXUJueX8xSrYvs8efSbhfHddGGJgL8b/2uzHMnomlADGk2xojVRWjFKGr5LFh3Js6lC kQiqipnI27zhzrpB0B+JuWiaBGM9J4VoE67HV56inEziJgljF1oKsw5MDmxihXzRidUlWbnS4k5ED 7GaTrqsUnZMf10KnMeGA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtG-001F8o-6M; Tue, 16 Nov 2021 10:40:38 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvsg-001Ezf-4m for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:03 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 5E52960F44; Tue, 16 Nov 2021 10:39:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059201; bh=XQNhhOwY7CNCcEEDeCs8Qr9sMVB4unBMSmPawoOiXGs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KMNXEVQIj5ecNinUXIskocjhA5ebXZHxafEfWSSoyZKscqC676ixPWFVXGxkBLT4l E5V4djFgVl6Eru079C3HSPX4bHN84nfILjwqwcaIotCM58/65oICT9MHs2d2qI/E+1 +7AbIRZ2XiN3GYlbSaWGTjbViUCCWf2KbhD2gBxa+msiIc7+TSzccIUOwHUTNLYMGJ QglozS3sdAhomB74li73hx6STbgi1j6rK2OMouTx2492tPhhGK/5VWoNDcLgR6P8GR uuoDjp9wZXC9GNxs2KW4XIgMzNs7I5AX3RdHOErYN97xLn2K+LXqh/AgglAO1XX7Qs w5YdXj2KBE4mw== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Andy Gross , Bjorn Andersson , linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/6] phy: qualcomm: ipq806x-usb: Fix kernel-doc style Date: Tue, 16 Nov 2021 16:09:47 +0530 Message-Id: <20211116103951.34482-2-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211116103951.34482-1-vkoul@kernel.org> References: <20211116103951.34482-1-vkoul@kernel.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_024002_277073_52A4C7B7 X-CRM114-Status: UNSURE ( 8.97 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org The functions are documented but there were style issues, so fix the style and add missing description for phy_dwc3 drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c:130: drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c:174: drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c:212: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst Signed-off-by: Vinod Koul Reviewed-by: Randy Dunlap --- drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c | 26 +++++++++++---------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c b/drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c index bfff0c8c9130..e1b8fa911416 100644 --- a/drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c +++ b/drivers/phy/qualcomm/phy-qcom-ipq806x-usb.c @@ -127,12 +127,13 @@ struct phy_drvdata { }; /** - * Write register and read back masked value to confirm it is written + * usb_phy_write_readback - Write register and read back masked value to + * confirm it is written * - * @base - QCOM DWC3 PHY base virtual address. - * @offset - register offset. - * @mask - register bitmask specifying what should be updated - * @val - value to write. + * @phy_dwc3: QCOM DWC3 PHY base virtual address. + * @offset: register offset. + * @mask: register bitmask specifying what should be updated + * @val: value to write. */ static inline void usb_phy_write_readback(struct usb_phy *phy_dwc3, u32 offset, @@ -171,11 +172,11 @@ static int wait_for_latch(void __iomem *addr) } /** - * Write SSPHY register + * usb_ss_write_phycreg - Write SSPHY register * - * @base - QCOM DWC3 PHY base virtual address. - * @addr - SSPHY address to write. - * @val - value to write. + * @phy_dwc3: QCOM DWC3 PHY base virtual address. + * @addr: SSPHY address to write. + * @val: value to write. */ static int usb_ss_write_phycreg(struct usb_phy *phy_dwc3, u32 addr, u32 val) @@ -209,10 +210,11 @@ static int usb_ss_write_phycreg(struct usb_phy *phy_dwc3, } /** - * Read SSPHY register. + * usb_ss_read_phycreg - Read SSPHY register. * - * @base - QCOM DWC3 PHY base virtual address. - * @addr - SSPHY address to read. + * @phy_dwc3: QCOM DWC3 PHY base virtual address. + * @addr: SSPHY address to read. + * @val: pointer in which read is store. */ static int usb_ss_read_phycreg(struct usb_phy *phy_dwc3, u32 addr, u32 *val) From patchwork Tue Nov 16 10:39:48 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621967 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E0656C433FE for ; Tue, 16 Nov 2021 10:40:39 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 9E00E61C15 for ; Tue, 16 Nov 2021 10:40:39 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 9E00E61C15 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=jTyFiT6PG5ga9vyjvGreNe1Wc1hjEuGiqKaT+rQQdVQ=; b=vMMezzrkeEMjvO 97TEJ8EdSem3x2A5JivAZYtZpo5fGnrnd5U5OPAgRuewJnbHy8HHC5evqb61XVQ2MmSx/M72Oy5Eu isX3iuoufpdssrUEQgYr5PNzjStqJAZY7cJuHHQNv3dlgyPuZ3DNd+Z+L1urx+zMhrOtBT9XeCeQb XZP4s3DPIcCh40uuL4HBi6xYd0skhEkQEQENXT6SvuSw+0G1yixcHTfHRsMFPdd6nfacHSP3Ws0wP wenBnhnISHGy67bBeUb2ULH2fXf1dALw1mAI7xO38QJpuIRF7TZkEb56zu5ok6sYrqkTNu298y35M niRdgPuLsNjJOpAJv69g==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtG-001F8v-MB; Tue, 16 Nov 2021 10:40:38 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvsj-001F0d-8o for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:06 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 6B1B36321B; Tue, 16 Nov 2021 10:40:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059204; bh=LKtUNo+Ptcd/YQ16xYGBnhORd2bTIpSekrD4tpIsZdQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UzwjbUFweX+788xhBrvLd9Xh/zFX58bQe92APMBTm8LEnJT7XzdLDoLnFFlZmsgzm M3x1dyTkT/VxEI5/6yQSp7RZxMnMtecpmx1mpVza27Ap8LVDGMmALiMjIHRxXIocRS 1sJgNAhUWMXmsaCsuKM5jLwn42e+UC0NnMKm7uW9F/q4YupjqZQCnvd89n6G3siOzu TRVyabPV5eBsYy8hEDW2T5ne3874s7tCYTJvkuIB/ulMyQqzreRCFuVSC+BXhq3PBM x2C/sOG/yvEyuViQwivz+llKeWUCemC1xqqCIXZ9X3AUlqd3ag7XKHxeDy+K7HGSoZ uJR1bBbrukSlA== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Andy Gross , Bjorn Andersson , linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 3/6] phy: qualcomm: qmp: Add missing struct documentation Date: Tue, 16 Nov 2021 16:09:48 +0530 Message-Id: <20211116103951.34482-3-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211116103951.34482-1-vkoul@kernel.org> References: <20211116103951.34482-1-vkoul@kernel.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_024005_369331_0A930F52 X-CRM114-Status: UNSURE ( 6.79 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org dp-* members were added to qmp_phy_combo_cfg but documentation was missed, so add that. drivers/phy/qualcomm/phy-qcom-qmp.c:2995: warning: Function parameter or member 'dp_aux_cfg' not described in 'qmp_phy' drivers/phy/qualcomm/phy-qcom-qmp.c:2995: warning: Function parameter or member 'dp_opts' not described in 'qmp_phy' drivers/phy/qualcomm/phy-qcom-qmp.c:2995: warning: Function parameter or member 'dp_clks' not described in 'qmp_phy' Signed-off-by: Vinod Koul Reviewed-by: Bjorn Andersson --- drivers/phy/qualcomm/phy-qcom-qmp.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/drivers/phy/qualcomm/phy-qcom-qmp.c b/drivers/phy/qualcomm/phy-qcom-qmp.c index 456a59d8c7d0..c96639d5f581 100644 --- a/drivers/phy/qualcomm/phy-qcom-qmp.c +++ b/drivers/phy/qualcomm/phy-qcom-qmp.c @@ -2973,6 +2973,9 @@ struct qmp_phy_combo_cfg { * @qmp: QMP phy to which this lane belongs * @lane_rst: lane's reset controller * @mode: current PHY mode + * @dp_aux_cfg: Display port aux config + * @dp_opts: Display port optional config + * @dp_clks: Display port clocks */ struct qmp_phy { struct phy *phy; From patchwork Tue Nov 16 10:39:49 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621963 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 28037C4332F for ; Tue, 16 Nov 2021 10:40:40 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 E978F61C15 for ; Tue, 16 Nov 2021 10:40:39 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org E978F61C15 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=eB+M414wFB5SltGI+c6oZ0Qa9INOWyMz3I4Etu9gFoU=; b=xtruwbSNyQu+JL 4xRGUG2OosqY5mKOR4yVNJW1S5cICIpH/rPHZuY4eVYtYfPlgRLuEli1Yfu8VFJnKhh5sNyt0ompT YuFNRsHGaGqnZ/2NE2gzWIOXRymU2eeFJTmEj2FtfH6xZ2yQlCfxxAX5kZ+FVd9qXYC9K0mgN72wd dz3syFTw+L2cxtF9Z6Y+MOkvB5cH5FMtKIBQUl979R2XJuPzvp/nVAFON8gGgoFVmXRCrHfnX06wO d7N/+NSQjLOLA9MNa6mAuZLgeEFtYoh6B3aZ/dCxDDiO4vdO+Gz64nQLroI6QrhMB79ZuuuO4lEbH FsP5W5gs7s0EfdceKfdw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtH-001F9K-2u; Tue, 16 Nov 2021 10:40:39 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvsm-001F1a-JD for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:09 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 9AD4063220; Tue, 16 Nov 2021 10:40:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059208; bh=Qc8ZBQhWfMzGFC9zpZm7g87nQ9jQMAL3DvjJ2hBhgmM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=kzPqL3UyQcmcZiJX6U3NS438wu6gGJ1n5sDkidLASCsTuQS6gzeFIvT5RsAMrHNx2 Nf8q6PwMoO/Y7VOpSrAKYJe6hZbOS2Y792wKPu/CPeJOVShT+bqn7uIEJD2tKIRQkz m63fPTlvlkBwvvx91nSxXh/oqdTL/zyP//c95XclNT7scFNO6KOG1THq/UesFJS/EU ik70F4f0TjZ87JA7D1+gz+Zbh3hGE4Xa+bfS8cUWQxh9/S0T4qUZHocSRjgYPj/6nB 3j/24P2A00o0Q9dri5OusssRrvBxEie4HUj62Pg/DP8/1nEuTAmdSxvbRnf/M0f86u QGpSQ8S1D0iVg== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Andy Gross , Bjorn Andersson , linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/6] phy: qualcomm: usb-hsic: Fix the kernel-doc warn Date: Tue, 16 Nov 2021 16:09:49 +0530 Message-Id: <20211116103951.34482-4-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211116103951.34482-1-vkoul@kernel.org> References: <20211116103951.34482-1-vkoul@kernel.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_024008_715515_93E25DE8 X-CRM114-Status: UNSURE ( 8.78 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org The comment is not kernel-doc one and starts with /**, so fix that. drivers/phy/qualcomm/phy-qcom-usb-hsic.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst Signed-off-by: Vinod Koul Reviewed-by: Bjorn Andersson --- drivers/phy/qualcomm/phy-qcom-usb-hsic.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/phy/qualcomm/phy-qcom-usb-hsic.c b/drivers/phy/qualcomm/phy-qcom-usb-hsic.c index 04d18d52f700..716a77748ed8 100644 --- a/drivers/phy/qualcomm/phy-qcom-usb-hsic.c +++ b/drivers/phy/qualcomm/phy-qcom-usb-hsic.c @@ -1,5 +1,5 @@ // SPDX-License-Identifier: GPL-2.0-only -/** +/* * Copyright (C) 2016 Linaro Ltd */ #include From patchwork Tue Nov 16 10:39:50 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621965 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9DB49C433F5 for ; Tue, 16 Nov 2021 10:40:40 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 6A20960F44 for ; Tue, 16 Nov 2021 10:40:40 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 6A20960F44 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=hw8rR8OkaK/ikGKbTztPUzh8Jr4TXJcrAq3Ic5H5i/c=; b=axKUVdvjzl1kdW /ftxT+76g5buV4qWixeTEbAdhDJ+XkAeW0utGwvPz+QsnnUl1QkYO5GG9uJJXKyDJBklfMJiAy2+9 MALJFRuVFF/znjxLWkbYBIbVrXm9gQ5v/s0edX8zOJ3GRV1DygW8OBUFzgx27GizmCPaaA2Piy6Uq IfRBPJZJgZywlTPTtnSuz+BCGASR18ptHm54L/vtV704hsx2GOvTc2sKDol0Ggc+axjWg1GvfnbBh PaAXrX4BeV4DDJMDbrjS6GuwQ0rvlu1wtFtEd6sNgGxq4t3zWvO5YU6ZyYHI4WFpKaGjJlSG0PFet m50KWnRptTuOrel4XglA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtH-001F9Z-Ju; Tue, 16 Nov 2021 10:40:39 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvsp-001F2G-NO for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:13 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 02A606321A; Tue, 16 Nov 2021 10:40:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059211; bh=iJwYXvXaD2Nx4JOgAG9JX3K+yBIfm4s3ShpHVYk75Ng=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FJSLVVXMro/VYVZx+Q/HlBDJdgK99TC8JMjD1/eEe4i/jWeJyEANge4hI36tY0ECn o8ZfnUqBxjUXUNAdG/X9GAKHF4DSFARnj8t4IsVVCIX3vtQ0++9YjMKbFjIxJEZ71m E/SS3R7mruo8BqjXiuth1BvK4Sfz1F9bN02i3bRxiWQk/2T27dGK4QjJ4IYmmhCqTA M1R/VJdOptNgWv5L3QCY66ijqVgCLBxV5ciOmcenIH4zBKDrtkjcvzWA14Ki846VEA ie2ygtF8TwJAwf1IU8iETqOe73SudZtAfGkfMGhYpMsYuYc2b7vjC+oMzCFnpfwIvP 5ZVwNntyf4QTQ== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Roger Quadros , Liam Beguin , linux-kernel@vger.kernel.org Subject: [PATCH 5/6] phy: ti: omap-usb2: Fix the kernel-doc style Date: Tue, 16 Nov 2021 16:09:50 +0530 Message-Id: <20211116103951.34482-5-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211116103951.34482-1-vkoul@kernel.org> References: <20211116103951.34482-1-vkoul@kernel.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_024011_824533_CE7D9FF3 X-CRM114-Status: UNSURE ( 8.09 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org The documentation uses incorrect style, so fix that. drivers/phy/ti/phy-omap-usb2.c:102: warning: Function parameter or member 'comparator' not described in 'omap_usb2_set_comparator' While at it, use a single line for function description Signed-off-by: Vinod Koul Reviewed-by: Liam Beguin --- drivers/phy/ti/phy-omap-usb2.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/drivers/phy/ti/phy-omap-usb2.c b/drivers/phy/ti/phy-omap-usb2.c index ebceb1520ce8..2102b7f73ffa 100644 --- a/drivers/phy/ti/phy-omap-usb2.c +++ b/drivers/phy/ti/phy-omap-usb2.c @@ -89,9 +89,9 @@ static inline void omap_usb_writel(void __iomem *addr, unsigned int offset, } /** - * omap_usb2_set_comparator - links the comparator present in the system with - * this phy - * @comparator - the companion phy(comparator) for this phy + * omap_usb2_set_comparator - links the comparator present in the system with this phy + * + * @comparator: the companion phy(comparator) for this phy * * The phy companion driver should call this API passing the phy_companion * filled with set_vbus and start_srp to be used by usb phy. From patchwork Tue Nov 16 10:39:51 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinod Koul X-Patchwork-Id: 12621969 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 317ABC433EF for ; Tue, 16 Nov 2021 10:40:41 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 ED374613AC for ; Tue, 16 Nov 2021 10:40:40 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org ED374613AC Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=kKxfDT6M9BV45l0G2MeVyANxRdqj3izF8qhdxxNDm80=; b=2yEKf0HITcbNDC BGZbuhFcFzM6R6HM8pkPKtNlPHVZsc4APl+yyWiYM0U7B0XGHeMvSddLp0+NHqP7L6LDGbuaP8Enp zrD+X3c9sZzsIWaebQCxhS19Ozb8OJd44kOAF0JqceVAJrb7ePz3VT+hFABPUjxbNdJihw6fxy5B0 rwLfd7gOpcWyMVufNwnXzYjyrwnJBgQ7FvxFDm7ywycwGV01earTxOIXqIJ24OVeFFVbygXuTOOrK 8nT+AEc7O0CxjmAWfvyxI5B3ax3TM0uaowEan/ur0FCaxOIHtuRjQZxV6HeRgSWRn57AqixOay0+7 vvV7U21CmRwpTd0TohWQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvtI-001F9p-3k; Tue, 16 Nov 2021 10:40:40 +0000 Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mmvss-001F34-OG for linux-phy@lists.infradead.org; Tue, 16 Nov 2021 10:40:16 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 0380C61A58; Tue, 16 Nov 2021 10:40:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1637059214; bh=d2c7/cvf4goFuY/ZG1KO0aHiDqa+L1wLp9mPZr+E3SI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=aIUOpCTIhwWaRvPJOwenE9tcC9LKRQ+cHbYLsun0xPkjVpvCA9b+2dx9aSsVUCSAM MAeJcF3JrDfjE6dHoSW/UOZGknL6V+kT71cgzfzTOW3LyT4l0IMF5XsLPp0+EN3Zw0 owYufzd99YhukQ8QB1UupBtGFEuhBbJf5p7s62+1ZImk2RplkeCqPxIyK4EPcZ6HRW dV+UIAoDkMwd4m2OT8iE4qEzZkqgz7zMyeZKr9WhjJhR3XPR1K6pM4J8q5o6P+pBqg 7Fxfiy3ErSa4IiGE1EaAagblS4p917XK+0sJcFLn4eoISAKgmBWuA/7y0YQpvuoXoA usk2OEFNU2ehg== From: Vinod Koul To: Kishon Vijay Abraham I Cc: linux-phy@lists.infradead.org, Vinod Koul , Roger Quadros , Liam Beguin , linux-kernel@vger.kernel.org Subject: [PATCH 6/6] phy: ti: tusb1210: Fix the kernel-doc warn Date: Tue, 16 Nov 2021 16:09:51 +0530 Message-Id: <20211116103951.34482-6-vkoul@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211116103951.34482-1-vkoul@kernel.org> References: <20211116103951.34482-1-vkoul@kernel.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211116_024014_852696_7CF89D9B X-CRM114-Status: UNSURE ( 8.24 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org The comment is not kernel-doc one and starts with /**, so fix that. drivers/phy/ti/phy-tusb1210.c:16: warning: expecting prototype for tusb1210.c(). Prototype was for TUSB1210_VENDOR_SPECIFIC2() instead Signed-off-by: Vinod Koul Reviewed-by: Liam Beguin --- drivers/phy/ti/phy-tusb1210.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/phy/ti/phy-tusb1210.c b/drivers/phy/ti/phy-tusb1210.c index a63213f5972a..15c1c79e5c29 100644 --- a/drivers/phy/ti/phy-tusb1210.c +++ b/drivers/phy/ti/phy-tusb1210.c @@ -1,5 +1,5 @@ // SPDX-License-Identifier: GPL-2.0-only -/** +/* * tusb1210.c - TUSB1210 USB ULPI PHY driver * * Copyright (C) 2015 Intel Corporation