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

From: kernel test robot
Date: Mon Mar 21 2022 - 13:08:23 EST


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@xxxxxxxxx/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@xxxxxxxxx>

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@xxxxxxxxxx>
:::::: CC: Benjamin Gaignard <benjamin.gaignard@xxxxxxxxxx>

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