drivers/gpu/drm/drm_connector.c:2215: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_hdmi_colorspace_property'

drivers/gpu/drm/drm_connector.c:2215: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_hdmi_colorspace_property'

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   4853c74bd7ab7fdb83f319bd9ace8a08c031e9b6
commit: c265f340eaa87aa5f979adfb23d7463af67b7f27 drm/connector: Allow drivers to pass list of supported colorspaces
date:   10 weeks ago
config: sh-randconfig-r001-20230817 (https://download.01.org/0day-ci/archive/20230817/202308171526.DciyDwCK-lkp@intel.com/config)
compiler: sh4-linux-gcc (GCC) 12.3.0
reproduce: (https://download.01.org/0day-ci/archive/20230817/202308171526.DciyDwCK-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/202308171526.DciyDwCK-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/drm_connector.c:2215: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_hdmi_colorspace_property'
>> drivers/gpu/drm/drm_connector.c:2239: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_dp_colorspace_property'


vim +2215 drivers/gpu/drm/drm_connector.c

c627087cb164d1 Harry Wentland  2022-11-29  2202  
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2203  /**
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2204   * drm_mode_create_hdmi_colorspace_property - create hdmi colorspace property
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2205   * @connector: connector to create the Colorspace property on.
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2206   *
d2c6a405846c24 Uma Shankar     2019-02-19  2207   * Called by a driver the first time it's needed, must be attached to desired
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2208   * HDMI connectors.
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2209   *
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2210   * Returns:
84e543bc9d1dc5 Antonio Borneo  2020-06-26  2211   * Zero on success, negative errno on failure.
d2c6a405846c24 Uma Shankar     2019-02-19  2212   */
c265f340eaa87a Harry Wentland  2022-11-29  2213  int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector,
c265f340eaa87a Harry Wentland  2022-11-29  2214  					     u32 supported_colorspaces)
d2c6a405846c24 Uma Shankar     2019-02-19 @2215  {
c265f340eaa87a Harry Wentland  2022-11-29  2216  	u32 colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2217  
c265f340eaa87a Harry Wentland  2022-11-29  2218  	if (supported_colorspaces)
c265f340eaa87a Harry Wentland  2022-11-29  2219  		colorspaces = supported_colorspaces & hdmi_colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2220  	else
c265f340eaa87a Harry Wentland  2022-11-29  2221  		colorspaces = hdmi_colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2222  
c265f340eaa87a Harry Wentland  2022-11-29  2223  	return drm_mode_create_colorspace_property(connector, colorspaces);
d2c6a405846c24 Uma Shankar     2019-02-19  2224  }
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19  2225  EXPORT_SYMBOL(drm_mode_create_hdmi_colorspace_property);
d2c6a405846c24 Uma Shankar     2019-02-19  2226  
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2227  /**
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2228   * drm_mode_create_dp_colorspace_property - create dp colorspace property
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2229   * @connector: connector to create the Colorspace property on.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2230   *
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2231   * Called by a driver the first time it's needed, must be attached to desired
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2232   * DP connectors.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2233   *
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2234   * Returns:
84e543bc9d1dc5 Antonio Borneo  2020-06-26  2235   * Zero on success, negative errno on failure.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2236   */
c265f340eaa87a Harry Wentland  2022-11-29  2237  int drm_mode_create_dp_colorspace_property(struct drm_connector *connector,
c265f340eaa87a Harry Wentland  2022-11-29  2238  					   u32 supported_colorspaces)
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 @2239  {
c265f340eaa87a Harry Wentland  2022-11-29  2240  	u32 colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2241  
c265f340eaa87a Harry Wentland  2022-11-29  2242  	if (supported_colorspaces)
c265f340eaa87a Harry Wentland  2022-11-29  2243  		colorspaces = supported_colorspaces & dp_colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2244  	else
c265f340eaa87a Harry Wentland  2022-11-29  2245  		colorspaces = dp_colorspaces;
c265f340eaa87a Harry Wentland  2022-11-29  2246  
c265f340eaa87a Harry Wentland  2022-11-29  2247  	return drm_mode_create_colorspace_property(connector, colorspaces);
d2c6a405846c24 Uma Shankar     2019-02-19  2248  }
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19  2249  EXPORT_SYMBOL(drm_mode_create_dp_colorspace_property);
d2c6a405846c24 Uma Shankar     2019-02-19  2250  

:::::: The code at line 2215 was first introduced by commit
:::::: d2c6a405846c24439f85c7a8da21545f12874638 drm: Add HDMI colorspace property

:::::: TO: Uma Shankar <uma.shankar@intel.com>
:::::: CC: Maarten Lankhorst <maarten.lankhorst@linux.intel.com>

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