[pinchartl:rpi/v6.5/isp/v2 21/23] htmldocs: ./include/uapi/linux/bcm2835-isp.h:146: warning: Function parameter or member 'padding' not described in 'bcm2835_isp_black_level'

[pinchartl:rpi/v6.5/isp/v2 21/23] htmldocs: ./include/uapi/linux/bcm2835-isp.h:146: warning: Function parameter or member 'padding' not described in 'bcm2835_isp_black_level'

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/pinchartl/linux.git rpi/v6.5/isp/v2
head:   f21e9808068119a1ea8f1ddb5677c982b79ac10d
commit: f53111061a1c4624e8c08104ced1b968eeb173f5 [21/23] docs: admin-guide: media: bcm2835-isp: Add documentation for bcm2835-isp
reproduce: (https://download.01.org/0day-ci/archive/20230829/202308291211.kJYIPEDZ-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/202308291211.kJYIPEDZ-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> ./include/uapi/linux/bcm2835-isp.h:146: warning: Function parameter or member 'padding' not described in 'bcm2835_isp_black_level'
>> ./include/uapi/linux/bcm2835-isp.h:178: warning: Function parameter or member 'x' not described in 'bcm2835_isp_gamma'
>> ./include/uapi/linux/bcm2835-isp.h:178: warning: Function parameter or member 'y' not described in 'bcm2835_isp_gamma'
>> Documentation/userspace-api/media/drivers/index.rst:30: WARNING: toctree contains reference to nonexisting document 'userspace-api/media/drivers/bcm2835-isp'
>> Documentation/admin-guide/media/bcm2835-isp.rst: WARNING: document isn't included in any toctree
>> Documentation/admin-guide/media/bcm2835-isp.rst:76: WARNING: undefined label: v4l2-meta-fmt-bcm2835-isp-stats (if the link has no caption the label must precede a section header)

vim +146 ./include/uapi/linux/bcm2835-isp.h

2374cc3ebbe4f56 Dave Stevenson 2020-10-12  130  
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  131  /**
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  132   * struct bcm2835_isp_black_level - Sensor black level set with the
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  133   *				    V4L2_CID_USER_BCM2835_ISP_BLACK_LEVEL ctrl.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  134   *
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  135   * @enabled:		Enable black level.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  136   * @black_level_r:	Black level for red channel.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  137   * @black_level_g:	Black level for green channels.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  138   * @black_level_b:	Black level for blue channel.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  139   */
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  140  struct bcm2835_isp_black_level {
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  141  	__u32 enabled;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  142  	__u16 black_level_r;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  143  	__u16 black_level_g;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  144  	__u16 black_level_b;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  145  	__u8 padding[2]; /* Unused */
2374cc3ebbe4f56 Dave Stevenson 2020-10-12 @146  };
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  147  
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  148  /**
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  149   * struct bcm2835_isp_geq - Green equalisation parameters set with the
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  150   *			    V4L2_CID_USER_BCM2835_ISP_GEQ ctrl.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  151   *
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  152   * @enabled:	Enable green equalisation.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  153   * @offset:	Fixed offset of the green equalisation threshold.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  154   * @slope:	Slope of the green equalisation threshold.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  155   */
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  156  struct bcm2835_isp_geq {
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  157  	__u32 enabled;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  158  	__u32 offset;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  159  	struct bcm2835_isp_rational slope;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  160  };
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  161  
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  162  #define BCM2835_NUM_GAMMA_PTS 33
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  163  
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  164  /**
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  165   * struct bcm2835_isp_gamma - Gamma parameters set with the
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  166   *			      V4L2_CID_USER_BCM2835_ISP_GAMMA ctrl.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  167   *
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  168   * @enabled:	Enable gamma adjustment.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  169   * @X:		X values of the points defining the gamma curve.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  170   *		Values should be scaled to 16 bits.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  171   * @Y:		Y values of the points defining the gamma curve.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  172   *		Values should be scaled to 16 bits.
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  173   */
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  174  struct bcm2835_isp_gamma {
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  175  	__u32 enabled;
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  176  	__u16 x[BCM2835_NUM_GAMMA_PTS];
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  177  	__u16 y[BCM2835_NUM_GAMMA_PTS];
2374cc3ebbe4f56 Dave Stevenson 2020-10-12 @178  };
2374cc3ebbe4f56 Dave Stevenson 2020-10-12  179  

:::::: The code at line 146 was first introduced by commit
:::::: 2374cc3ebbe4f56da5cdd08fad8e87f568521505 uapi: bcm2835-isp: Add bcm2835-isp uapi header file

:::::: TO: Dave Stevenson <dave.stevenson@raspberrypi.com>
:::::: CC: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

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