[PATCH 6/6] Documentation/amdgpu: Fix duplicate declaration

[Alex Deucher]

Series is:
Acked-by: Alex Deucher <alexander.deucher at amd.com>

On Mon, Jul 15, 2024 at 10:50 PM Rodrigo Siqueira
<Rodrigo.Siqueira at amd.com> wrote:
>
> Address the below kernel doc warning:
>
> Documentation/gpu/amdgpu/display/display-manager:134:
> drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:3: WARNING: Duplicate C
> declaration, also defined at gpu/amdgpu/display/dcn-blocks:101.
> Declaration is '.. c:struct:: mpcc_blnd_cfg'.
> Documentation/gpu/amdgpu/display/display-manager:146:
> drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:3: WARNING: Duplicate C
> declaration, also defined at gpu/amdgpu/display/dcn-blocks:3.
> Declaration is '.. c:enum:: mpcc_alpha_blend_mode'.
>
> To address the above warnings, this commit uses the 'no-identifiers'
> option in the dcn-blocks to avoid duplication with the previous use of
> this function doc in the display-manager file. Finally, replaces the
> deprecated ':function:' in favor of ':identifiers:'.
>
> Cc: Alex Deucher <alexander.deucher at amd.com>
> Reported-by: Stephen Rothwell <sfr at canb.auug.org.au>
> Signed-off-by: Rodrigo Siqueira <Rodrigo.Siqueira at amd.com>
> ---
>  Documentation/gpu/amdgpu/display/dcn-blocks.rst      | 1 +
>  Documentation/gpu/amdgpu/display/display-manager.rst | 4 ++--
>  2 files changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/gpu/amdgpu/display/dcn-blocks.rst b/Documentation/gpu/amdgpu/display/dcn-blocks.rst
> index f80df596ef5c..5e34366f6dbe 100644
> --- a/Documentation/gpu/amdgpu/display/dcn-blocks.rst
> +++ b/Documentation/gpu/amdgpu/display/dcn-blocks.rst
> @@ -34,6 +34,7 @@ MPC
>
>  .. kernel-doc:: drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
>     :internal:
> +   :no-identifiers: mpcc_blnd_cfg mpcc_alpha_blend_mode
>
>  OPP
>  ---
> diff --git a/Documentation/gpu/amdgpu/display/display-manager.rst b/Documentation/gpu/amdgpu/display/display-manager.rst
> index 67a811e6891f..b269ff3f7a54 100644
> --- a/Documentation/gpu/amdgpu/display/display-manager.rst
> +++ b/Documentation/gpu/amdgpu/display/display-manager.rst
> @@ -132,7 +132,7 @@ The DRM blend mode and its elements are then mapped by AMDGPU display manager
>  (MPC), as follows:
>
>  .. kernel-doc:: drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
> -   :functions: mpcc_blnd_cfg
> +   :identifiers: mpcc_blnd_cfg
>
>  Therefore, the blending configuration for a single MPCC instance on the MPC
>  tree is defined by :c:type:`mpcc_blnd_cfg`, where
> @@ -144,7 +144,7 @@ alpha and plane alpha values. It sets one of the three modes for
>  :c:type:`MPCC_ALPHA_BLND_MODE`, as described below.
>
>  .. kernel-doc:: drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
> -   :functions: mpcc_alpha_blend_mode
> +   :identifiers: mpcc_alpha_blend_mode
>
>  DM then maps the elements of `enum mpcc_alpha_blend_mode` to those in the DRM
>  blend formula, as follows:
> --
> 2.43.0
>