Commit 2fed1746 authored by Lee Jones's avatar Lee Jones Committed by Alex Deucher

drm/amd/display/dc/dce/dce_clock_source: Fix formatting/spelling of worthy function headers

Demote the one that provides no param descriptions.

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

 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'calc_pll_cs' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'target_pix_clk_100hz' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'ref_divider' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'post_divider' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'feedback_divider_param' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:142: warning: Function parameter or member 'fract_feedback_divider_param' not described in 'calculate_fb_and_fractional_fb_divider'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:200: warning: Function parameter or member 'calc_pll_cs' not described in 'calc_fb_divider_checking_tolerance'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:200: warning: Function parameter or member 'pll_settings' not described in 'calc_fb_divider_checking_tolerance'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:200: warning: Function parameter or member 'ref_divider' not described in 'calc_fb_divider_checking_tolerance'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:200: warning: Function parameter or member 'post_divider' not described in 'calc_fb_divider_checking_tolerance'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:200: warning: Function parameter or member 'tolerance' not described in 'calc_fb_divider_checking_tolerance'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:478: warning: Function parameter or member 'clk_src' not described in 'dce110_get_pix_clk_dividers_helper'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:478: warning: Function parameter or member 'pll_settings' not described in 'dce110_get_pix_clk_dividers_helper'
 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dce_clock_source.c:478: warning: Function parameter or member 'pix_clk_params' not described in 'dce110_get_pix_clk_dividers_helper'

Cc: Harry Wentland <harry.wentland@amd.com>
Cc: Leo Li <sunpeng.li@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: Bhawanpreet Lakha <Bhawanpreet.Lakha@amd.com>
Cc: amd-gfx@lists.freedesktop.org
Cc: dri-devel@lists.freedesktop.org
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Signed-off-by: default avatarAlex Deucher <alexander.deucher@amd.com>
parent 55e92025
...@@ -113,20 +113,19 @@ static const struct spread_spectrum_data *get_ss_data_entry( ...@@ -113,20 +113,19 @@ static const struct spread_spectrum_data *get_ss_data_entry(
} }
/** /**
* Function: calculate_fb_and_fractional_fb_divider * calculate_fb_and_fractional_fb_divider - Calculates feedback and fractional
* feedback dividers values
* *
* * DESCRIPTION: Calculates feedback and fractional feedback dividers values * @calc_pll_cs: Pointer to clock source information
* @target_pix_clk_100hz: Desired frequency in 100 Hz
* @ref_divider: Reference divider (already known)
* @post_divider: Post Divider (already known)
* @feedback_divider_param: Pointer where to store
* calculated feedback divider value
* @fract_feedback_divider_param: Pointer where to store
* calculated fract feedback divider value
* *
*PARAMETERS: * return:
* targetPixelClock Desired frequency in 100 Hz
* ref_divider Reference divider (already known)
* postDivider Post Divider (already known)
* feedback_divider_param Pointer where to store
* calculated feedback divider value
* fract_feedback_divider_param Pointer where to store
* calculated fract feedback divider value
*
*RETURNS:
* It fills the locations pointed by feedback_divider_param * It fills the locations pointed by feedback_divider_param
* and fract_feedback_divider_param * and fract_feedback_divider_param
* It returns - true if feedback divider not 0 * It returns - true if feedback divider not 0
...@@ -175,22 +174,22 @@ static bool calculate_fb_and_fractional_fb_divider( ...@@ -175,22 +174,22 @@ static bool calculate_fb_and_fractional_fb_divider(
} }
/** /**
*calc_fb_divider_checking_tolerance * calc_fb_divider_checking_tolerance - Calculates Feedback and
* * Fractional Feedback divider values
*DESCRIPTION: Calculates Feedback and Fractional Feedback divider values * for passed Reference and Post divider,
* for passed Reference and Post divider, checking for tolerance. * checking for tolerance.
*PARAMETERS: * @calc_pll_cs: Pointer to clock source information
* pll_settings Pointer to structure * @pll_settings: Pointer to PLL settings
* ref_divider Reference divider (already known) * @ref_divider: Reference divider (already known)
* postDivider Post Divider (already known) * @post_divider: Post Divider (already known)
* tolerance Tolerance for Calculated Pixel Clock to be within * @tolerance: Tolerance for Calculated Pixel Clock to be within
* *
*RETURNS: * return:
* It fills the PLLSettings structure with PLL Dividers values * It fills the PLLSettings structure with PLL Dividers values
* if calculated values are within required tolerance * if calculated values are within required tolerance
* It returns - true if error is within tolerance * It returns - true if error is within tolerance
* - false if error is not within tolerance * - false if error is not within tolerance
*/ */
static bool calc_fb_divider_checking_tolerance( static bool calc_fb_divider_checking_tolerance(
struct calc_pll_clock_source *calc_pll_cs, struct calc_pll_clock_source *calc_pll_cs,
struct pll_settings *pll_settings, struct pll_settings *pll_settings,
...@@ -460,7 +459,7 @@ static bool pll_adjust_pix_clk( ...@@ -460,7 +459,7 @@ static bool pll_adjust_pix_clk(
return false; return false;
} }
/** /*
* Calculate PLL Dividers for given Clock Value. * Calculate PLL Dividers for given Clock Value.
* First will call VBIOS Adjust Exec table to check if requested Pixel clock * First will call VBIOS Adjust Exec table to check if requested Pixel clock
* will be Adjusted based on usage. * will be Adjusted based on usage.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment