[PATCH] drm/amd/display: Fix up kdoc formatting in display_mode_vba.c

[PATCH] drm/amd/display: Fix up kdoc formatting in display_mode_vba.c

[Srinivasan Shanmugam]

Fixes the following W=1 kernel build warning:

drivers/gpu/drm/amd/amdgpu/../display/dc/dml/display_mode_vba.c:936: warning: Cannot understand  * *************************************************************************

Cc: Aurabindo Pillai <aurabindo.pillai@amd.com>
Signed-off-by: Srinivasan Shanmugam <srinivasan.shanmugam@amd.com>
---
 drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c b/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
index 2f63ae954826..9a3ded311195 100644
--- a/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
+++ b/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
@@ -933,18 +933,16 @@ static void fetch_pipe_params(struct display_mode_lib *mode_lib)
 }
 
 /**
- * ********************************************************************************************
  * cache_debug_params: Cache any params that needed to be maintained from the initial validation
  * for debug purposes.
  *
  * The DML getters can modify some of the VBA params that we are interested in (for example when
  * calculating with dummy p-state latency), so cache any params here that we want for debugging
  *
- * @param [in] mode_lib: mode_lib input/output of validate call
+ * @mode_lib: mode_lib input/output of validate call
  *
- * @return: void
+ * Return: void
  *
- * ********************************************************************************************
  */
 static void cache_debug_params(struct display_mode_lib *mode_lib)
 {
-- 
2.25.1

Re: [PATCH] drm/amd/display: Fix up kdoc formatting in display_mode_vba.c

[Aurabindo Pillai]

Reviewed-by: Aurabindo Pillai <aurabindo.pillai@amd.com>

On 5/30/23 15:08, Srinivasan Shanmugam wrote:
> Fixes the following W=1 kernel build warning:
> 
> drivers/gpu/drm/amd/amdgpu/../display/dc/dml/display_mode_vba.c:936: warning: Cannot understand  * *************************************************************************
> 
> Cc: Aurabindo Pillai <aurabindo.pillai@amd.com>
> Signed-off-by: Srinivasan Shanmugam <srinivasan.shanmugam@amd.com>
> ---
>  drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c | 6 ++----
>  1 file changed, 2 insertions(+), 4 deletions(-)
> 
> diff --git a/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c b/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
> index 2f63ae954826..9a3ded311195 100644
> --- a/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
> +++ b/drivers/gpu/drm/amd/display/dc/dml/display_mode_vba.c
> @@ -933,18 +933,16 @@ static void fetch_pipe_params(struct display_mode_lib *mode_lib)
>  }
>  
>  /**
> - * ********************************************************************************************
>   * cache_debug_params: Cache any params that needed to be maintained from the initial validation
>   * for debug purposes.
>   *
>   * The DML getters can modify some of the VBA params that we are interested in (for example when
>   * calculating with dummy p-state latency), so cache any params here that we want for debugging
>   *
> - * @param [in] mode_lib: mode_lib input/output of validate call
> + * @mode_lib: mode_lib input/output of validate call
>   *
> - * @return: void
> + * Return: void
>   *
> - * ********************************************************************************************
>   */
>  static void cache_debug_params(struct display_mode_lib *mode_lib)
>  {