[linux-next:master 13367/13716] drivers/gpu/drm/amd/amdgpu/../display/amdgpu_dm/amdgpu_dm_crtc.c:100: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[linux-next:master 13367/13716] drivers/gpu/drm/amd/amdgpu/../display/amdgpu_dm/amdgpu_dm_crtc.c:100: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
head:   943b9f0ab2cfbaea148dd6ac279957eb08b96904
commit: 5950efe25ee02df4983864b3bc1f460ad5c8d862 [13367/13716] drm/amd/display: Enable Panel Replay for static screen use case
config: loongarch-defconfig (https://download.01.org/0day-ci/archive/20240117/202401172119.Fc2Ic3l9-lkp@intel.com/config)
compiler: loongarch64-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20240117/202401172119.Fc2Ic3l9-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/202401172119.Fc2Ic3l9-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/amd/amdgpu/../display/amdgpu_dm/amdgpu_dm_crtc.c:100: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * The DRM vblank counter enable/disable action is used as the trigger to enable


vim +100 drivers/gpu/drm/amd/amdgpu/../display/amdgpu_dm/amdgpu_dm_crtc.c

    98	
    99	/**
 > 100	 * The DRM vblank counter enable/disable action is used as the trigger to enable
   101	 * or disable various panel self-refresh features:
   102	 *
   103	 * Panel Replay and PSR SU
   104	 * - Enable when:
   105	 *      - vblank counter is disabled
   106	 *      - entry is allowed: usermode demonstrates an adequate number of fast
   107	 *        commits)
   108	 *     - CRC capture window isn't active
   109	 * - Keep enabled even when vblank counter gets enabled
   110	 *
   111	 * PSR1
   112	 * - Enable condition same as above
   113	 * - Disable when vblank counter is enabled
   114	 */
   115	static void amdgpu_dm_crtc_set_panel_sr_feature(
   116		struct vblank_control_work *vblank_work,
   117		bool vblank_enabled, bool allow_sr_entry)
   118	{
   119		struct dc_link *link = vblank_work->stream->link;
   120		bool is_sr_active = (link->replay_settings.replay_allow_active ||
   121					 link->psr_settings.psr_allow_active);
   122		bool is_crc_window_active = false;
   123	

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