htmldocs: ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'overlap_only' not described in 'mpcc_blnd_cfg'
From: kernel test robot
Date: Thu Aug 17 2023 - 20:42:52 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 16931859a6500d360b90aeacab3b505a3560a3ed
commit: 33fa4f1df53076d0078be091d5a88d457de54936 Documentation/gpu/amdgpu/amdgpu_dm: add DM docs for pixel blend mode
date: 1 year ago
reproduce: (https://download.01.org/0day-ci/archive/20230818/202308180803.QE0R3OlP-lkp@xxxxxxxxx/reproduce)
If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202308180803.QE0R3OlP-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'overlap_only' not described in 'mpcc_blnd_cfg'
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'bottom_gain_mode' not described in 'mpcc_blnd_cfg'
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'background_color_bpc' not described in 'mpcc_blnd_cfg'
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'top_gain' not described in 'mpcc_blnd_cfg'
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'bottom_inside_gain' not described in 'mpcc_blnd_cfg'
>> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:109: warning: Function parameter or member 'bottom_outside_gain' not described in 'mpcc_blnd_cfg'
vim +109 ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
feb4a3cd8eb007f Eric Bernstein 2017-11-06 83
43d61f6d8f4d2da Melissa Wen 2022-08-04 84 /**
43d61f6d8f4d2da Melissa Wen 2022-08-04 85 * struct mpcc_blnd_cfg - MPCC blending configuration
43d61f6d8f4d2da Melissa Wen 2022-08-04 86 *
43d61f6d8f4d2da Melissa Wen 2022-08-04 87 * @black_color: background color
43d61f6d8f4d2da Melissa Wen 2022-08-04 88 * @alpha_mode: alpha blend mode (MPCC_ALPHA_BLND_MODE)
43d61f6d8f4d2da Melissa Wen 2022-08-04 89 * @pre_multiplied_alpha: whether pixel color values were pre-multiplied by the
43d61f6d8f4d2da Melissa Wen 2022-08-04 90 * alpha channel (MPCC_ALPHA_MULTIPLIED_MODE)
43d61f6d8f4d2da Melissa Wen 2022-08-04 91 * @global_gain: used when blend mode considers both pixel alpha and plane
43d61f6d8f4d2da Melissa Wen 2022-08-04 92 * alpha value and assumes the global alpha value.
43d61f6d8f4d2da Melissa Wen 2022-08-04 93 * @global_alpha: plane alpha value
feb4a3cd8eb007f Eric Bernstein 2017-11-06 94 */
feb4a3cd8eb007f Eric Bernstein 2017-11-06 95 struct mpcc_blnd_cfg {
feb4a3cd8eb007f Eric Bernstein 2017-11-06 96 struct tg_color black_color; /* background color */
feb4a3cd8eb007f Eric Bernstein 2017-11-06 97 enum mpcc_alpha_blend_mode alpha_mode; /* alpha blend mode */
feb4a3cd8eb007f Eric Bernstein 2017-11-06 98 bool pre_multiplied_alpha; /* alpha pre-multiplied mode flag */
feb4a3cd8eb007f Eric Bernstein 2017-11-06 99 int global_gain;
feb4a3cd8eb007f Eric Bernstein 2017-11-06 100 int global_alpha;
feb4a3cd8eb007f Eric Bernstein 2017-11-06 101 bool overlap_only;
feb4a3cd8eb007f Eric Bernstein 2017-11-06 102
f789b0b82bf0aee Harry Wentland 2019-02-22 103 /* MPCC top/bottom gain settings */
f789b0b82bf0aee Harry Wentland 2019-02-22 104 int bottom_gain_mode;
f789b0b82bf0aee Harry Wentland 2019-02-22 105 int background_color_bpc;
f789b0b82bf0aee Harry Wentland 2019-02-22 106 int top_gain;
f789b0b82bf0aee Harry Wentland 2019-02-22 107 int bottom_inside_gain;
f789b0b82bf0aee Harry Wentland 2019-02-22 108 int bottom_outside_gain;
feb4a3cd8eb007f Eric Bernstein 2017-11-06 @109 };
feb4a3cd8eb007f Eric Bernstein 2017-11-06 110
:::::: The code at line 109 was first introduced by commit
:::::: feb4a3cd8eb007f4749dc8323110f42fb4682ae0 drm/amd/display: Integrating MPC pseudocode
:::::: TO: Eric Bernstein <eric.bernstein@xxxxxxx>
:::::: CC: Alex Deucher <alexander.deucher@xxxxxxx>
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki