Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

drm/amd/pm/powerplay/hwmgr/vega10_hwmgr: Kernel-doc headers must contain function names

Fixes the following W=1 kernel build warning(s):

drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:547: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:603: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:629: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1006: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1155: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1608: warning: expecting prototype for Populates single SMC GFXSCLK structure using the provided engine clock(). Prototype was for vega10_populate_single_gfx_level() instead
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1663: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1713: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:1862: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:2546: warning: expecting prototype for Initializes the SMC table and uploads it(). Prototype was for vega10_init_smc_table() instead
drivers/gpu/drm/amd/amdgpu/../pm/powerplay/hwmgr/vega10_hwmgr.c:2922: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Cc: Evan Quan <evan.quan@amd.com>
Cc: Alex Deucher <alexander.deucher@amd.com>
Cc: "Christian König" <christian.koenig@amd.com>
Cc: David Airlie <airlied@linux.ie>
Cc: Daniel Vetter <daniel@ffwll.ch>
Cc: amd-gfx@lists.freedesktop.org
Cc: dri-devel@lists.freedesktop.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>

authored by

Lee Jones and committed by
Alex Deucher
3818cd13 0fc955e5

+15 -11
+15 -11
drivers/gpu/drm/amd/pm/powerplay/hwmgr/vega10_hwmgr.c
··· 544 544 545 545 #define ATOM_VIRTUAL_VOLTAGE_ID0 0xff01 546 546 /** 547 - * Get Leakage VDDC based on leakage ID. 547 + * vega10_get_evv_voltages - Get Leakage VDDC based on leakage ID. 548 548 * 549 549 * @hwmgr: the address of the powerplay hardware manager. 550 550 * return: always 0. ··· 600 600 } 601 601 602 602 /** 603 - * Change virtual leakage voltage to actual value. 603 + * vega10_patch_with_vdd_leakage - Change virtual leakage voltage to actual value. 604 604 * 605 605 * @hwmgr: the address of the powerplay hardware manager. 606 606 * @voltage: pointer to changing voltage ··· 626 626 } 627 627 628 628 /** 629 - * Patch voltage lookup table by EVV leakages. 629 + * vega10_patch_lookup_table_with_leakage - Patch voltage lookup table by EVV leakages. 630 630 * 631 631 * @hwmgr: the address of the powerplay hardware manager. 632 632 * @lookup_table: pointer to voltage lookup table ··· 1003 1003 } 1004 1004 1005 1005 /** 1006 - * Remove repeated voltage values and create table with unique values. 1006 + * vega10_trim_voltage_table - Remove repeated voltage values and create table with unique values. 1007 1007 * 1008 1008 * @hwmgr: the address of the powerplay hardware manager. 1009 1009 * @vol_table: the pointer to changing voltage table ··· 1152 1152 } 1153 1153 1154 1154 /** 1155 - * Create Voltage Tables. 1155 + * vega10_construct_voltage_tables - Create Voltage Tables. 1156 1156 * 1157 1157 * @hwmgr: the address of the powerplay hardware manager. 1158 1158 * return: always 0 ··· 1595 1595 } 1596 1596 1597 1597 /** 1598 - * Populates single SMC GFXSCLK structure using the provided engine clock 1598 + * vega10_populate_single_gfx_level - Populates single SMC GFXSCLK structure 1599 + * using the provided engine clock 1599 1600 * 1600 1601 * @hwmgr: the address of the hardware manager 1601 1602 * @gfx_clock: the GFX clock to use to populate the structure. ··· 1661 1660 } 1662 1661 1663 1662 /** 1664 - * Populates single SMC SOCCLK structure using the provided clock. 1663 + * vega10_populate_single_soc_level - Populates single SMC SOCCLK structure 1664 + * using the provided clock. 1665 1665 * 1666 1666 * @hwmgr: the address of the hardware manager. 1667 1667 * @soc_clock: the SOC clock to use to populate the structure. ··· 1712 1710 } 1713 1711 1714 1712 /** 1715 - * Populates all SMC SCLK levels' structure based on the trimmed allowed dpm engine clock states 1713 + * vega10_populate_all_graphic_levels - Populates all SMC SCLK levels' structure 1714 + * based on the trimmed allowed dpm engine clock states 1716 1715 * 1717 1716 * @hwmgr: the address of the hardware manager 1718 1717 */ ··· 1862 1859 } 1863 1860 1864 1861 /** 1865 - * Populates all SMC MCLK levels' structure based on the trimmed allowed dpm memory clock states. 1862 + * vega10_populate_all_memory_levels - Populates all SMC MCLK levels' structure 1863 + * based on the trimmed allowed dpm memory clock states. 1866 1864 * 1867 1865 * @hwmgr: the address of the hardware manager. 1868 1866 * return: PP_Result_OK on success. ··· 2541 2537 } 2542 2538 2543 2539 /** 2544 - * Initializes the SMC table and uploads it 2540 + * vega10_init_smc_table - Initializes the SMC table and uploads it 2545 2541 * 2546 2542 * @hwmgr: the address of the powerplay hardware manager. 2547 2543 * return: always 0 ··· 2923 2919 } 2924 2920 2925 2921 /** 2926 - * Tell SMC to enabled the supported DPMs. 2922 + * vega10_start_dpm - Tell SMC to enabled the supported DPMs. 2927 2923 * 2928 2924 * @hwmgr: the address of the powerplay hardware manager. 2929 2925 * @bitmap: bitmap for the features to enabled.