drivers/gpu/drm/sti/sti_hdmi.c:187: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

drivers/gpu/drm/sti/sti_hdmi.c:187: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

Hi Aditya,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   f443e374ae131c168a065ea1748feac6b2e76613
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 scripts: kernel-doc: improve parsing for kernel-doc comments syntax
date:   11 months ago
config: arm-allmodconfig (https://download.01.org/0day-ci/archive/20220322/202203220003.ultJrIat-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 11.2.0
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        # save the config file to linux build tree
        mkdir build_dir
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross O=build_dir ARCH=arm SHELL=/bin/bash arch/arm/mach-omap2/ drivers/gpu/drm/sti/ drivers/usb/gadget/udc/

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@intel.com>

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/sti/sti_hdmi.c:187: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * HDMI interrupt handler threaded
   drivers/gpu/drm/sti/sti_hdmi.c:219: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * HDMI interrupt handler
   drivers/gpu/drm/sti/sti_hdmi.c:241: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Set hdmi active area depending on the drm display mode selected
   drivers/gpu/drm/sti/sti_hdmi.c:262: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Overall hdmi configuration
   drivers/gpu/drm/sti/sti_hdmi.c:340: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Helper to concatenate infoframe in 32 bits word
   drivers/gpu/drm/sti/sti_hdmi.c:357: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Helper to write info frame
   drivers/gpu/drm/sti/sti_hdmi.c:427: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Prepare and configure the AVI infoframe
   drivers/gpu/drm/sti/sti_hdmi.c:470: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Prepare and configure the AUDIO infoframe
   drivers/gpu/drm/sti/sti_hdmi.c:555: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Software reset of the hdmi subsystem
--
>> arch/arm/mach-omap2/cpuidle44xx.c:88: warning: expecting prototype for omap_enter_idle_[simple/coupled](). Prototype was for omap_enter_idle_simple() instead


vim +187 drivers/gpu/drm/sti/sti_hdmi.c

5402626c83a2f19 Benjamin Gaignard 2014-07-30  185  
5402626c83a2f19 Benjamin Gaignard 2014-07-30  186  /**
5402626c83a2f19 Benjamin Gaignard 2014-07-30 @187   * HDMI interrupt handler threaded
5402626c83a2f19 Benjamin Gaignard 2014-07-30  188   *
5402626c83a2f19 Benjamin Gaignard 2014-07-30  189   * @irq: irq number
5402626c83a2f19 Benjamin Gaignard 2014-07-30  190   * @arg: connector structure
5402626c83a2f19 Benjamin Gaignard 2014-07-30  191   */
5402626c83a2f19 Benjamin Gaignard 2014-07-30  192  static irqreturn_t hdmi_irq_thread(int irq, void *arg)
5402626c83a2f19 Benjamin Gaignard 2014-07-30  193  {
5402626c83a2f19 Benjamin Gaignard 2014-07-30  194  	struct sti_hdmi *hdmi = arg;
5402626c83a2f19 Benjamin Gaignard 2014-07-30  195  
5402626c83a2f19 Benjamin Gaignard 2014-07-30  196  	/* Hot plug/unplug IRQ */
5402626c83a2f19 Benjamin Gaignard 2014-07-30  197  	if (hdmi->irq_status & HDMI_INT_HOT_PLUG) {
765692078f08d02 Benjamin Gaignard 2014-10-09  198  		hdmi->hpd = readl(hdmi->regs + HDMI_STA) & HDMI_STA_HOT_PLUG;
5402626c83a2f19 Benjamin Gaignard 2014-07-30  199  		if (hdmi->drm_dev)
5402626c83a2f19 Benjamin Gaignard 2014-07-30  200  			drm_helper_hpd_irq_event(hdmi->drm_dev);
5402626c83a2f19 Benjamin Gaignard 2014-07-30  201  	}
5402626c83a2f19 Benjamin Gaignard 2014-07-30  202  
5402626c83a2f19 Benjamin Gaignard 2014-07-30  203  	/* Sw reset and PLL lock are exclusive so we can use the same
5402626c83a2f19 Benjamin Gaignard 2014-07-30  204  	 * event to signal them
5402626c83a2f19 Benjamin Gaignard 2014-07-30  205  	 */
5402626c83a2f19 Benjamin Gaignard 2014-07-30  206  	if (hdmi->irq_status & (HDMI_INT_SW_RST | HDMI_INT_DLL_LCK)) {
5402626c83a2f19 Benjamin Gaignard 2014-07-30  207  		hdmi->event_received = true;
5402626c83a2f19 Benjamin Gaignard 2014-07-30  208  		wake_up_interruptible(&hdmi->wait_event);
5402626c83a2f19 Benjamin Gaignard 2014-07-30  209  	}
5402626c83a2f19 Benjamin Gaignard 2014-07-30  210  
2c348e505328155 Arnaud Pouliquen  2016-05-30  211  	/* Audio FIFO underrun IRQ */
2c348e505328155 Arnaud Pouliquen  2016-05-30  212  	if (hdmi->irq_status & HDMI_INT_AUDIO_FIFO_XRUN)
29ffa77668235bd Fabien Dessenne   2016-09-06  213  		DRM_INFO("Warning: audio FIFO underrun occurs!\n");
2c348e505328155 Arnaud Pouliquen  2016-05-30  214  
5402626c83a2f19 Benjamin Gaignard 2014-07-30  215  	return IRQ_HANDLED;
5402626c83a2f19 Benjamin Gaignard 2014-07-30  216  }
5402626c83a2f19 Benjamin Gaignard 2014-07-30  217  

:::::: The code at line 187 was first introduced by commit
:::::: 5402626c83a2f19da14859e2bab231a53e16ee74 drm: sti: add HDMI driver

:::::: TO: Benjamin Gaignard <benjamin.gaignard@linaro.org>
:::::: CC: Benjamin Gaignard <benjamin.gaignard@linaro.org>

-- 
0-DAY CI Kernel Test Service
https://01.org/lkp