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

drm/amdgpu: Fix function header names in amdgpu_connectors.c

Align the function headers for `amdgpu_max_hdmi_pixel_clock` and
`amdgpu_connector_dvi_mode_valid` with the function implementations so
they match the expected kdoc style.

Fixes the below:
drivers/gpu/drm/amd/amdgpu/amdgpu_connectors.c:1199: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Returns the maximum supported HDMI (TMDS) pixel clock in KHz.
drivers/gpu/drm/amd/amdgpu/amdgpu_connectors.c:1212: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Validates the given display mode on DVI and HDMI connectors.

Fixes: 585b2f685c56 ("drm/amdgpu: Respect max pixel clock for HDMI and DVI-D (v2)")
Cc: Christian König <christian.koenig@amd.com>
Cc: Alex Deucher <alexander.deucher@amd.com>
Signed-off-by: Srinivasan Shanmugam <srinivasan.shanmugam@amd.com>
Reviewed-by: Alex Deucher <alexander.deucher@amd.com>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>

authored by

Srinivasan Shanmugam and committed by
Alex Deucher
38ab33db fa7c99f0

+12 -3
+12 -3
drivers/gpu/drm/amd/amdgpu/amdgpu_connectors.c
··· 1196 1196 } 1197 1197 1198 1198 /** 1199 - * Returns the maximum supported HDMI (TMDS) pixel clock in KHz. 1199 + * amdgpu_max_hdmi_pixel_clock - Return max supported HDMI (TMDS) pixel clock 1200 + * @adev: pointer to amdgpu_device 1201 + * 1202 + * Return: maximum supported HDMI (TMDS) pixel clock in KHz. 1200 1203 */ 1201 1204 static int amdgpu_max_hdmi_pixel_clock(const struct amdgpu_device *adev) 1202 1205 { ··· 1212 1209 } 1213 1210 1214 1211 /** 1215 - * Validates the given display mode on DVI and HDMI connectors, 1216 - * including analog signals on DVI-I. 1212 + * amdgpu_connector_dvi_mode_valid - Validate a mode on DVI/HDMI connectors 1213 + * @connector: DRM connector to validate the mode on 1214 + * @mode: display mode to validate 1215 + * 1216 + * Validate the given display mode on DVI and HDMI connectors, including 1217 + * analog signals on DVI-I. 1218 + * 1219 + * Return: drm_mode_status indicating whether the mode is valid. 1217 1220 */ 1218 1221 static enum drm_mode_status amdgpu_connector_dvi_mode_valid(struct drm_connector *connector, 1219 1222 const struct drm_display_mode *mode)