==========
kdoc - FAILED


drivers/net/phy/phy.c:166: warning: No description found for return value of 'phy_config_interrupt'
drivers/net/phy/phy.c:182: warning: No description found for return value of 'phy_restart_aneg'
drivers/net/phy/phy.c:203: warning: No description found for return value of 'phy_aneg_done'
drivers/net/phy/phy.c:228: warning: No description found for return value of 'phy_find_valid'
drivers/net/phy/phy.c:245: warning: No description found for return value of 'phy_supported_speeds'
drivers/net/phy/phy.c:259: warning: No description found for return value of 'phy_check_valid'
drivers/net/phy/phy.c:326: warning: No description found for return value of 'phy_mii_ioctl'
drivers/net/phy/phy.c:453: warning: No description found for return value of 'phy_do_ioctl'
drivers/net/phy/phy.c:472: warning: No description found for return value of 'phy_do_ioctl_running'
drivers/net/phy/phy.c:490: warning: No description found for return value of '__phy_hwtstamp_get'
drivers/net/phy/phy.c:507: warning: No description found for return value of '__phy_hwtstamp_set'
drivers/net/phy/phy.c:559: warning: No description found for return value of 'phy_ethtool_get_strings'
drivers/net/phy/phy.c:577: warning: No description found for return value of 'phy_ethtool_get_sset_count'
drivers/net/phy/phy.c:606: warning: No description found for return value of 'phy_ethtool_get_stats'
drivers/net/phy/phy.c:672: warning: No description found for return value of 'phy_ethtool_get_plca_cfg'
drivers/net/phy/phy.c:706: warning: No description found for return value of 'plca_check_valid'
drivers/net/phy/phy.c:734: warning: No description found for return value of 'phy_ethtool_set_plca_cfg'
drivers/net/phy/phy.c:833: warning: No description found for return value of 'phy_ethtool_get_plca_status'
drivers/net/phy/phy.c:862: warning: No description found for return value of 'phy_start_cable_test'
drivers/net/phy/phy.c:933: warning: No description found for return value of 'phy_start_cable_test_tdr'
drivers/net/phy/phy.c:1017: warning: No description found for return value of 'phy_check_link_status'
drivers/net/phy/phy.c:1064: warning: No description found for return value of 'phy_inband_caps'
drivers/net/phy/phy.c:1114: warning: No description found for return value of '_phy_start_aneg'
drivers/net/phy/phy.c:1146: warning: No description found for return value of 'phy_start_aneg'
drivers/net/phy/phy.c:1250: warning: No description found for return value of 'phy_speed_down'
drivers/net/phy/phy.c:1291: warning: No description found for return value of 'phy_speed_up'
drivers/net/phy/phy.c:1390: warning: No description found for return value of 'phy_disable_interrupts'
drivers/net/phy/phy.c:1403: warning: No description found for return value of 'phy_interrupt'
drivers/net/phy/phy.c:1441: warning: No description found for return value of 'phy_enable_interrupts'
drivers/net/phy/phy.c:1698: warning: No description found for return value of 'phy_init_eee'
drivers/net/phy/phy.c:1729: warning: No description found for return value of 'phy_get_eee_err'
drivers/net/phy/phy.c:1752: warning: No description found for return value of 'phy_ethtool_get_eee'
drivers/net/phy/phy.c:1810: warning: No description found for return value of 'phy_ethtool_set_eee'
drivers/net/phy/phy.c:1841: warning: No description found for return value of 'phy_ethtool_set_wol'
drivers/net/phy/phy.c:1903: warning: No description found for return value of 'phy_ethtool_nway_reset'
include/linux/phy.h:227: warning: No description found for return value of 'phy_modes'
include/linux/phy.h:483: warning: No description found for return value of 'mdiobus_alloc'
include/linux/phy.h:1149: warning: Incorrect use of kernel-doc format:          * get_phy_stats - Retrieve PHY statistics.
include/linux/phy.h:1169: warning: Incorrect use of kernel-doc format:          * get_link_stats - Retrieve link statistics.
include/linux/phy.h:1284: warning: Function parameter or struct member 'get_phy_stats' not described in 'phy_driver'
include/linux/phy.h:1284: warning: Function parameter or struct member 'get_link_stats' not described in 'phy_driver'
include/linux/phy.h:1305: warning: No description found for return value of 'phy_id_compare'
include/linux/phy.h:1319: warning: No description found for return value of 'phydev_id_compare'
include/linux/phy.h:1372: warning: No description found for return value of 'phy_is_started'
include/linux/phy.h:1390: warning: No description found for return value of 'phy_read'
include/linux/phy.h:1416: warning: No description found for return value of '__phy_read'
include/linux/phy.h:1431: warning: No description found for return value of 'phy_write'
include/linux/phy.h:1444: warning: No description found for return value of '__phy_write'
include/linux/phy.h:1463: warning: No description found for return value of '__phy_modify_changed'
include/linux/phy.h:1551: warning: No description found for return value of '__phy_set_bits'
include/linux/phy.h:1565: warning: No description found for return value of '__phy_clear_bits'
include/linux/phy.h:1576: warning: No description found for return value of 'phy_set_bits'
include/linux/phy.h:1587: warning: No description found for return value of 'phy_clear_bits'
include/linux/phy.h:1603: warning: No description found for return value of '__phy_set_bits_mmd'
include/linux/phy.h:1619: warning: No description found for return value of '__phy_clear_bits_mmd'
include/linux/phy.h:1633: warning: No description found for return value of 'phy_set_bits_mmd'
include/linux/phy.h:1647: warning: No description found for return value of 'phy_clear_bits_mmd'
include/linux/phy.h:1659: warning: No description found for return value of 'phy_interrupt_is_valid'
include/linux/phy.h:1669: warning: No description found for return value of 'phy_polling_mode'
include/linux/phy.h:1682: warning: No description found for return value of 'phy_has_hwtstamp'
include/linux/phy.h:1691: warning: No description found for return value of 'phy_has_rxtstamp'
include/linux/phy.h:1701: warning: No description found for return value of 'phy_has_tsinfo'
include/linux/phy.h:1710: warning: No description found for return value of 'phy_has_txtstamp'
include/linux/phy.h:1759: warning: No description found for return value of 'phy_is_internal'
include/linux/phy.h:1768: warning: No description found for return value of 'phy_on_sfp'
include/linux/phy.h:1778: warning: No description found for return value of 'phy_interface_mode_is_rgmii'
include/linux/phy.h:1792: warning: No description found for return value of 'phy_interface_mode_is_8023z'
include/linux/phy.h:1803: warning: No description found for return value of 'phy_interface_is_rgmii'
include/linux/phy.h:1813: warning: No description found for return value of 'phy_is_pseudo_fixed_link'
drivers/net/phy/phy.c:166: warning: No description found for return value of 'phy_config_interrupt'
drivers/net/phy/phy.c:182: warning: No description found for return value of 'phy_restart_aneg'
drivers/net/phy/phy.c:203: warning: No description found for return value of 'phy_aneg_done'
drivers/net/phy/phy.c:228: warning: No description found for return value of 'phy_find_valid'
drivers/net/phy/phy.c:245: warning: No description found for return value of 'phy_supported_speeds'
drivers/net/phy/phy.c:259: warning: No description found for return value of 'phy_check_valid'
drivers/net/phy/phy.c:326: warning: No description found for return value of 'phy_mii_ioctl'
drivers/net/phy/phy.c:453: warning: No description found for return value of 'phy_do_ioctl'
drivers/net/phy/phy.c:472: warning: No description found for return value of 'phy_do_ioctl_running'
drivers/net/phy/phy.c:490: warning: No description found for return value of '__phy_hwtstamp_get'
drivers/net/phy/phy.c:507: warning: No description found for return value of '__phy_hwtstamp_set'
drivers/net/phy/phy.c:559: warning: No description found for return value of 'phy_ethtool_get_strings'
drivers/net/phy/phy.c:577: warning: No description found for return value of 'phy_ethtool_get_sset_count'
drivers/net/phy/phy.c:606: warning: No description found for return value of 'phy_ethtool_get_stats'
drivers/net/phy/phy.c:672: warning: No description found for return value of 'phy_ethtool_get_plca_cfg'
drivers/net/phy/phy.c:706: warning: No description found for return value of 'plca_check_valid'
drivers/net/phy/phy.c:734: warning: No description found for return value of 'phy_ethtool_set_plca_cfg'
drivers/net/phy/phy.c:833: warning: No description found for return value of 'phy_ethtool_get_plca_status'
drivers/net/phy/phy.c:862: warning: No description found for return value of 'phy_start_cable_test'
drivers/net/phy/phy.c:933: warning: No description found for return value of 'phy_start_cable_test_tdr'
drivers/net/phy/phy.c:1017: warning: No description found for return value of 'phy_check_link_status'
drivers/net/phy/phy.c:1064: warning: No description found for return value of 'phy_inband_caps'
drivers/net/phy/phy.c:1114: warning: No description found for return value of '_phy_start_aneg'
drivers/net/phy/phy.c:1146: warning: No description found for return value of 'phy_start_aneg'
drivers/net/phy/phy.c:1250: warning: No description found for return value of 'phy_speed_down'
drivers/net/phy/phy.c:1291: warning: No description found for return value of 'phy_speed_up'
drivers/net/phy/phy.c:1390: warning: No description found for return value of 'phy_disable_interrupts'
drivers/net/phy/phy.c:1403: warning: No description found for return value of 'phy_interrupt'
drivers/net/phy/phy.c:1441: warning: No description found for return value of 'phy_enable_interrupts'
drivers/net/phy/phy.c:1718: warning: No description found for return value of 'phy_init_eee'
drivers/net/phy/phy.c:1749: warning: No description found for return value of 'phy_get_eee_err'
drivers/net/phy/phy.c:1772: warning: No description found for return value of 'phy_ethtool_get_eee'
drivers/net/phy/phy.c:1830: warning: No description found for return value of 'phy_ethtool_set_eee'
drivers/net/phy/phy.c:1861: warning: No description found for return value of 'phy_ethtool_set_wol'
drivers/net/phy/phy.c:1923: warning: No description found for return value of 'phy_ethtool_nway_reset'
include/linux/phy.h:227: warning: No description found for return value of 'phy_modes'
include/linux/phy.h:483: warning: No description found for return value of 'mdiobus_alloc'
include/linux/phy.h:1149: warning: Incorrect use of kernel-doc format:          * get_phy_stats - Retrieve PHY statistics.
include/linux/phy.h:1169: warning: Incorrect use of kernel-doc format:          * get_link_stats - Retrieve link statistics.
include/linux/phy.h:1186: warning: Incorrect use of kernel-doc format:          * update_stats - Trigger periodic statistics updates.
include/linux/phy.h:1302: warning: Function parameter or struct member 'get_phy_stats' not described in 'phy_driver'
include/linux/phy.h:1302: warning: Function parameter or struct member 'get_link_stats' not described in 'phy_driver'
include/linux/phy.h:1302: warning: Function parameter or struct member 'update_stats' not described in 'phy_driver'
include/linux/phy.h:1323: warning: No description found for return value of 'phy_id_compare'
include/linux/phy.h:1337: warning: No description found for return value of 'phydev_id_compare'
include/linux/phy.h:1390: warning: No description found for return value of 'phy_is_started'
include/linux/phy.h:1408: warning: No description found for return value of 'phy_read'
include/linux/phy.h:1434: warning: No description found for return value of '__phy_read'
include/linux/phy.h:1449: warning: No description found for return value of 'phy_write'
include/linux/phy.h:1462: warning: No description found for return value of '__phy_write'
include/linux/phy.h:1481: warning: No description found for return value of '__phy_modify_changed'
include/linux/phy.h:1569: warning: No description found for return value of '__phy_set_bits'
include/linux/phy.h:1583: warning: No description found for return value of '__phy_clear_bits'
include/linux/phy.h:1594: warning: No description found for return value of 'phy_set_bits'
include/linux/phy.h:1605: warning: No description found for return value of 'phy_clear_bits'
include/linux/phy.h:1621: warning: No description found for return value of '__phy_set_bits_mmd'
include/linux/phy.h:1637: warning: No description found for return value of '__phy_clear_bits_mmd'
include/linux/phy.h:1651: warning: No description found for return value of 'phy_set_bits_mmd'
include/linux/phy.h:1665: warning: No description found for return value of 'phy_clear_bits_mmd'
include/linux/phy.h:1677: warning: No description found for return value of 'phy_interrupt_is_valid'
include/linux/phy.h:1687: warning: No description found for return value of 'phy_polling_mode'
include/linux/phy.h:1703: warning: No description found for return value of 'phy_has_hwtstamp'
include/linux/phy.h:1712: warning: No description found for return value of 'phy_has_rxtstamp'
include/linux/phy.h:1722: warning: No description found for return value of 'phy_has_tsinfo'
include/linux/phy.h:1731: warning: No description found for return value of 'phy_has_txtstamp'
include/linux/phy.h:1780: warning: No description found for return value of 'phy_is_internal'
include/linux/phy.h:1789: warning: No description found for return value of 'phy_on_sfp'
include/linux/phy.h:1799: warning: No description found for return value of 'phy_interface_mode_is_rgmii'
include/linux/phy.h:1813: warning: No description found for return value of 'phy_interface_mode_is_8023z'
include/linux/phy.h:1824: warning: No description found for return value of 'phy_interface_is_rgmii'
include/linux/phy.h:1834: warning: No description found for return value of 'phy_is_pseudo_fixed_link'
New warnings added
30,35c30,35
< drivers/net/phy/phy.c:1698: warning: No description found for return value of 'phy_init_eee'
< drivers/net/phy/phy.c:1729: warning: No description found for return value of 'phy_get_eee_err'
< drivers/net/phy/phy.c:1752: warning: No description found for return value of 'phy_ethtool_get_eee'
< drivers/net/phy/phy.c:1810: warning: No description found for return value of 'phy_ethtool_set_eee'
< drivers/net/phy/phy.c:1841: warning: No description found for return value of 'phy_ethtool_set_wol'
< drivers/net/phy/phy.c:1903: warning: No description found for return value of 'phy_ethtool_nway_reset'
---
> drivers/net/phy/phy.c:1718: warning: No description found for return value of 'phy_init_eee'
> drivers/net/phy/phy.c:1749: warning: No description found for return value of 'phy_get_eee_err'
> drivers/net/phy/phy.c:1772: warning: No description found for return value of 'phy_ethtool_get_eee'
> drivers/net/phy/phy.c:1830: warning: No description found for return value of 'phy_ethtool_set_eee'
> drivers/net/phy/phy.c:1861: warning: No description found for return value of 'phy_ethtool_set_wol'
> drivers/net/phy/phy.c:1923: warning: No description found for return value of 'phy_ethtool_nway_reset'
40,69c40,71
< include/linux/phy.h:1284: warning: Function parameter or struct member 'get_phy_stats' not described in 'phy_driver'
< include/linux/phy.h:1284: warning: Function parameter or struct member 'get_link_stats' not described in 'phy_driver'
< include/linux/phy.h:1305: warning: No description found for return value of 'phy_id_compare'
< include/linux/phy.h:1319: warning: No description found for return value of 'phydev_id_compare'
< include/linux/phy.h:1372: warning: No description found for return value of 'phy_is_started'
< include/linux/phy.h:1390: warning: No description found for return value of 'phy_read'
< include/linux/phy.h:1416: warning: No description found for return value of '__phy_read'
< include/linux/phy.h:1431: warning: No description found for return value of 'phy_write'
< include/linux/phy.h:1444: warning: No description found for return value of '__phy_write'
< include/linux/phy.h:1463: warning: No description found for return value of '__phy_modify_changed'
< include/linux/phy.h:1551: warning: No description found for return value of '__phy_set_bits'
< include/linux/phy.h:1565: warning: No description found for return value of '__phy_clear_bits'
< include/linux/phy.h:1576: warning: No description found for return value of 'phy_set_bits'
< include/linux/phy.h:1587: warning: No description found for return value of 'phy_clear_bits'
< include/linux/phy.h:1603: warning: No description found for return value of '__phy_set_bits_mmd'
< include/linux/phy.h:1619: warning: No description found for return value of '__phy_clear_bits_mmd'
< include/linux/phy.h:1633: warning: No description found for return value of 'phy_set_bits_mmd'
< include/linux/phy.h:1647: warning: No description found for return value of 'phy_clear_bits_mmd'
< include/linux/phy.h:1659: warning: No description found for return value of 'phy_interrupt_is_valid'
< include/linux/phy.h:1669: warning: No description found for return value of 'phy_polling_mode'
< include/linux/phy.h:1682: warning: No description found for return value of 'phy_has_hwtstamp'
< include/linux/phy.h:1691: warning: No description found for return value of 'phy_has_rxtstamp'
< include/linux/phy.h:1701: warning: No description found for return value of 'phy_has_tsinfo'
< include/linux/phy.h:1710: warning: No description found for return value of 'phy_has_txtstamp'
< include/linux/phy.h:1759: warning: No description found for return value of 'phy_is_internal'
< include/linux/phy.h:1768: warning: No description found for return value of 'phy_on_sfp'
< include/linux/phy.h:1778: warning: No description found for return value of 'phy_interface_mode_is_rgmii'
< include/linux/phy.h:1792: warning: No description found for return value of 'phy_interface_mode_is_8023z'
< include/linux/phy.h:1803: warning: No description found for return value of 'phy_interface_is_rgmii'
< include/linux/phy.h:1813: warning: No description found for return value of 'phy_is_pseudo_fixed_link'
---
> include/linux/phy.h:1186: warning: Incorrect use of kernel-doc format:          * update_stats - Trigger periodic statistics updates.
> include/linux/phy.h:1302: warning: Function parameter or struct member 'get_phy_stats' not described in 'phy_driver'
> include/linux/phy.h:1302: warning: Function parameter or struct member 'get_link_stats' not described in 'phy_driver'
> include/linux/phy.h:1302: warning: Function parameter or struct member 'update_stats' not described in 'phy_driver'
> include/linux/phy.h:1323: warning: No description found for return value of 'phy_id_compare'
> include/linux/phy.h:1337: warning: No description found for return value of 'phydev_id_compare'
> include/linux/phy.h:1390: warning: No description found for return value of 'phy_is_started'
> include/linux/phy.h:1408: warning: No description found for return value of 'phy_read'
> include/linux/phy.h:1434: warning: No description found for return value of '__phy_read'
> include/linux/phy.h:1449: warning: No description found for return value of 'phy_write'
> include/linux/phy.h:1462: warning: No description found for return value of '__phy_write'
> include/linux/phy.h:1481: warning: No description found for return value of '__phy_modify_changed'
> include/linux/phy.h:1569: warning: No description found for return value of '__phy_set_bits'
> include/linux/phy.h:1583: warning: No description found for return value of '__phy_clear_bits'
> include/linux/phy.h:1594: warning: No description found for return value of 'phy_set_bits'
> include/linux/phy.h:1605: warning: No description found for return value of 'phy_clear_bits'
> include/linux/phy.h:1621: warning: No description found for return value of '__phy_set_bits_mmd'
> include/linux/phy.h:1637: warning: No description found for return value of '__phy_clear_bits_mmd'
> include/linux/phy.h:1651: warning: No description found for return value of 'phy_set_bits_mmd'
> include/linux/phy.h:1665: warning: No description found for return value of 'phy_clear_bits_mmd'
> include/linux/phy.h:1677: warning: No description found for return value of 'phy_interrupt_is_valid'
> include/linux/phy.h:1687: warning: No description found for return value of 'phy_polling_mode'
> include/linux/phy.h:1703: warning: No description found for return value of 'phy_has_hwtstamp'
> include/linux/phy.h:1712: warning: No description found for return value of 'phy_has_rxtstamp'
> include/linux/phy.h:1722: warning: No description found for return value of 'phy_has_tsinfo'
> include/linux/phy.h:1731: warning: No description found for return value of 'phy_has_txtstamp'
> include/linux/phy.h:1780: warning: No description found for return value of 'phy_is_internal'
> include/linux/phy.h:1789: warning: No description found for return value of 'phy_on_sfp'
> include/linux/phy.h:1799: warning: No description found for return value of 'phy_interface_mode_is_rgmii'
> include/linux/phy.h:1813: warning: No description found for return value of 'phy_interface_mode_is_8023z'
> include/linux/phy.h:1824: warning: No description found for return value of 'phy_interface_is_rgmii'
> include/linux/phy.h:1834: warning: No description found for return value of 'phy_is_pseudo_fixed_link'
Per-file breakdown
2c2
<      34 include/linux/phy.h
---
>      36 include/linux/phy.h