Use the correct kernel-doc format & notation to eliminate kernel-doc warnings: Warning: include/linux/platform_data/mlxreg.h:24 Enum value 'MLX_WDT_TYPE1' not described in enum 'mlxreg_wdt_type' Warning: include/linux/platform_data/mlxreg.h:24 Enum value 'MLX_WDT_TYPE2' not described in enum 'mlxreg_wdt_type' Warning: include/linux/platform_data/mlxreg.h:24 Enum value 'MLX_WDT_TYPE3' not described in enum 'mlxreg_wdt_type' Warning: include/linux/platform_data/mlxreg.h:37 bad line: PHYs ready / unready state; Warning: include/linux/platform_data/mlxreg.h:153 struct member 'np' not described in 'mlxreg_core_data' Warning: include/linux/platform_data/mlxreg.h:153 struct member 'hpdev' not described in 'mlxreg_core_data'
Showing the changes to include/linux/platform_data (1 of 1 file). Show all
Unified · Split
| @@ -13,10 +13,10 @@ · 12 unmodified lines | ||
| 13 | 13 | /** |
| 14 | 14 | * enum mlxreg_wdt_type - type of HW watchdog |
| 15 | 15 | * |
| 16 | − * TYPE1 HW watchdog implementation exist in old systems. | |
| 17 | − * All new systems have TYPE2 HW watchdog. | |
| 18 | − * TYPE3 HW watchdog can exist on all systems with new CPLD. | |
| 19 | − * TYPE3 is selected by WD capability bit. | |
| 16 | + * @MLX_WDT_TYPE1: HW watchdog implementation in old systems. | |
| 17 | + * @MLX_WDT_TYPE2: All new systems have TYPE2 HW watchdog. | |
| 18 | + * @MLX_WDT_TYPE3: HW watchdog that can exist on all systems with new CPLD. | |
| 19 | + * TYPE3 is selected by WD capability bit. | |
| 20 | 20 | */ |
| 21 | 21 | enum mlxreg_wdt_type { |
| 22 | 22 | MLX_WDT_TYPE1, |
| @@ -35,7 +35,7 @@ enum mlxreg_wdt_type { · 12 unmodified lines | ||
| 35 | 35 | * @MLXREG_HOTPLUG_LC_SYNCED: entry for line card synchronization events, coming |
| 36 | 36 | * after hardware-firmware synchronization handshake; |
| 37 | 37 | * @MLXREG_HOTPLUG_LC_READY: entry for line card ready events, indicating line card |
| 38 | − PHYs ready / unready state; | |
| 38 | + * PHYs ready / unready state; | |
| 39 | 39 | * @MLXREG_HOTPLUG_LC_ACTIVE: entry for line card active events, indicating firmware |
| 40 | 40 | * availability / unavailability for the ports on line card; |
| 41 | 41 | * @MLXREG_HOTPLUG_LC_THERMAL: entry for line card thermal shutdown events, positive |
| @@ -123,8 +123,8 @@ struct mlxreg_hotplug_device { · 81 unmodified lines | ||
| 123 | 123 | * @reg_pwr: attribute power register; |
| 124 | 124 | * @reg_ena: attribute enable register; |
| 125 | 125 | * @mode: access mode; |
| 126 | − * @np - pointer to node platform associated with attribute; | |
| 127 | − * @hpdev - hotplug device data; | |
| 126 | + * @np: pointer to node platform associated with attribute; | |
| 127 | + * @hpdev: hotplug device data; | |
| 128 | 128 | * @notifier: pointer to event notifier block; |
| 129 | 129 | * @health_cntr: dynamic device health indication counter; |
| 130 | 130 | * @attached: true if device has been attached after good health indication; |