[PATCH 0/6] drm/amd/display: Address kernel doc warnings

Rodrigo Siqueira Rodrigo.Siqueira at amd.com
Tue Jul 16 02:27:22 UTC 2024


This patchset fixes many of the kernel-doc warnings caused by the
display documentation. This series addresses the following warnings:

./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/opp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/inc/hw/opp.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/link/hwss/link_hwss_dio.h:1: warning: no structured comments found
./drivers/gpu/drm/amd/display/dc/link/hwss/link_hwss_dio.h:1: warning: no structured comments found

/home/siqueira/Documents/Repositories/kernels/amd-next_dal-dev/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'.
/home/siqueira/Documents/Repositories/kernels/amd-next_dal-dev/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'.
/home/siqueira/Documents/Repositories/kernels/amd-next_dal-dev/Documentation/gpu/amdgpu/display/display-manager.rst:3: WARNING: Duplicate C declaration, also defined at gpu/amdgpu/display/dcn-blocks:101.
Declaration is '.. c:struct:: mpcc_blnd_cfg'.
/home/siqueira/Documents/Repositories/kernels/amd-next_dal-dev/Documentation/gpu/amdgpu/display/display-manager.rst:3: WARNING: Duplicate C declaration, also defined at gpu/amdgpu/display/dcn-blocks:3.
Declaration is '.. c:enum:: mpcc_alpha_blend_mode'.

I tested it on amd-staging-drm-next.

Cc: Alex Deucher <alexander.deucher at amd.com>
Cc: Stephen Rothwell <sfr at canb.auug.org.au>

Thanks
Siqueira


Rodrigo Siqueira (6):
  drm/amd/display: Move DIO documentation to the right place
  Documentation/gpu: Remove ':export:' option from DCN documentation
  Documentation/gpu: Adjust DCN documentation paths
  drm/amd/display: Add simple struct doc to remove doc build warning
  Documentation/gpu: Remove undocumented files from dcn-blockshubbub.h
  Documentation/amdgpu: Fix duplicate declaration

 .../gpu/amdgpu/display/dcn-blocks.rst         | 35 ++++---------------
 .../gpu/amdgpu/display/display-manager.rst    |  4 +--
 drivers/gpu/drm/amd/display/dc/inc/hw/dpp.h   | 22 +++++++++---
 drivers/gpu/drm/amd/display/dc/inc/hw/opp.h   | 15 ++++++++
 .../amd/display/dc/link/hwss/link_hwss_dio.c  | 29 +++++++++++++++
 .../amd/display/dc/link/hwss/link_hwss_dio.h  |  9 -----
 6 files changed, 69 insertions(+), 45 deletions(-)

-- 
2.43.0



More information about the amd-gfx mailing list