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'

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'

[kernel test robot]

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@intel.com/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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202308180803.QE0R3OlP-lkp@intel.com/

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@amd.com>
:::::: CC: Alex Deucher <alexander.deucher@amd.com>

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki