phy: qualcomm: ipq806x-usb: Fix kernel-doc style

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

Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Vinod Koul <vkoul@kernel.org>
Reviewed-by: Bjorn Andersson <bjorn.andersson@linaro.org>
Link: https://lore.kernel.org/r/20211120061531.410771-1-vkoul@kernel.org
Signed-off-by: Vinod Koul <vkoul@kernel.org>
This commit is contained in:
Vinod Koul 2021-11-20 11:45:30 +05:30
Родитель 466b1516e7
Коммит 0d1c7e5544
1 изменённых файлов: 14 добавлений и 12 удалений

Просмотреть файл

@ -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. * @phy_dwc3: QCOM DWC3 phy context
* @offset - register offset. * @offset: register offset.
* @mask - register bitmask specifying what should be updated * @mask: register bitmask specifying what should be updated
* @val - value to write. * @val: value to write.
*/ */
static inline void usb_phy_write_readback(struct usb_phy *phy_dwc3, static inline void usb_phy_write_readback(struct usb_phy *phy_dwc3,
u32 offset, 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. * @phy_dwc3: QCOM DWC3 phy context
* @addr - SSPHY address to write. * @addr: SSPHY address to write.
* @val - value to write. * @val: value to write.
*/ */
static int usb_ss_write_phycreg(struct usb_phy *phy_dwc3, static int usb_ss_write_phycreg(struct usb_phy *phy_dwc3,
u32 addr, u32 val) u32 addr, u32 val)
@ -209,10 +210,11 @@ err_wait:
} }
/** /**
* Read SSPHY register. * usb_ss_read_phycreg() - Read SSPHY register.
* *
* @base - QCOM DWC3 PHY base virtual address. * @phy_dwc3: QCOM DWC3 phy context
* @addr - SSPHY address to read. * @addr: SSPHY address to read.
* @val: pointer in which read is store.
*/ */
static int usb_ss_read_phycreg(struct usb_phy *phy_dwc3, static int usb_ss_read_phycreg(struct usb_phy *phy_dwc3,
u32 addr, u32 *val) u32 addr, u32 *val)