net: phy: Fixup parameters in kerneldoc
authorAndrew Lunn <andrew@lunn.ch>
Tue, 7 Jul 2020 01:49:34 +0000 (03:49 +0200)
committerDavid S. Miller <davem@davemloft.net>
Tue, 7 Jul 2020 19:47:10 +0000 (12:47 -0700)
Correct the kerneldoc for a few structure and function calls,
as reported by C=1 W=1.

Cc: Alexandru Ardelean <alexaundru.ardelean@analog.com>
Reviewed-by: Florian Fainelli <f.fainelli@gmail.com>
Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Signed-off-by: David S. Miller <davem@davemloft.net>
drivers/net/phy/adin.c
drivers/net/phy/mdio-boardinfo.c
drivers/net/phy/mdio_device.c

index c7eabe4..7471a8b 100644 (file)
 
 /**
  * struct adin_cfg_reg_map - map a config value to aregister value
- * @cfg                value in device configuration
- * @reg                value in the register
+ * @cfg:       value in device configuration
+ * @reg:       value in the register
  */
 struct adin_cfg_reg_map {
        int cfg;
@@ -135,9 +135,9 @@ static const struct adin_cfg_reg_map adin_rmii_fifo_depths[] = {
 
 /**
  * struct adin_clause45_mmd_map - map to convert Clause 45 regs to Clause 22
- * @devad              device address used in Clause 45 access
- * @cl45_regnum                register address defined by Clause 45
- * @adin_regnum                equivalent register address accessible via Clause 22
+ * @devad:             device address used in Clause 45 access
+ * @cl45_regnum:       register address defined by Clause 45
+ * @adin_regnum:       equivalent register address accessible via Clause 22
  */
 struct adin_clause45_mmd_map {
        int devad;
@@ -174,7 +174,7 @@ static const struct adin_hw_stat adin_hw_stats[] = {
 
 /**
  * struct adin_priv - ADIN PHY driver private data
- * stats               statistic counters for the PHY
+ * @stats:             statistic counters for the PHY
  */
 struct adin_priv {
        u64                     stats[ARRAY_SIZE(adin_hw_stats)];
index d9b54c6..033df43 100644 (file)
@@ -17,7 +17,8 @@ static DEFINE_MUTEX(mdio_board_lock);
 /**
  * mdiobus_setup_mdiodev_from_board_info - create and setup MDIO devices
  * from pre-collected board specific MDIO information
- * @mdiodev: MDIO device pointer
+ * @bus: Bus the board_info belongs to
+ * @cb: Callback to create device on bus
  * Context: can sleep
  */
 void mdiobus_setup_mdiodev_from_board_info(struct mii_bus *bus,
index be61550..0f625a1 100644 (file)
@@ -181,7 +181,7 @@ static int mdio_remove(struct device *dev)
 
 /**
  * mdio_driver_register - register an mdio_driver with the MDIO layer
- * @new_driver: new mdio_driver to register
+ * @drv: new mdio_driver to register
  */
 int mdio_driver_register(struct mdio_driver *drv)
 {