drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dmub_psr.c:231: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dmub_psr.c:231: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

Hi Robin,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   b253435746d9a4a701b5f09211b9c14d3370d0da
commit: e5dfcd272722fe3948837e7f1ca7aafb471037b1 drm/amd/display: dc_link_set_psr_allow_active refactoring
date:   6 months ago
config: s390-randconfig-c005-20220420 (https://download.01.org/0day-ci/archive/20220421/202204210704.BOBjQ2pT-lkp@intel.com/config)
compiler: clang version 15.0.0 (https://github.com/llvm/llvm-project bac6cd5bf85669e3376610cfc4c4f9ca015e7b9b)
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
        # install s390 cross compiling tool for clang build
        # apt-get install binutils-s390x-linux-gnu
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=e5dfcd272722fe3948837e7f1ca7aafb471037b1
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout e5dfcd272722fe3948837e7f1ca7aafb471037b1
        # save the config file
        mkdir build_dir && cp config build_dir/.config
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross W=1 O=build_dir ARCH=s390 SHELL=/bin/bash drivers/gpu/drm/amd/amdgpu/ drivers/gpu/drm/amd/display/dc/ drivers/hid/

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/amd/amdgpu/../display/dc/dce/dmub_psr.c:231: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Set PSR power optimization flags.


vim +231 drivers/gpu/drm/amd/amdgpu/../display/dc/dce/dmub_psr.c

   229	
   230	/**
 > 231	 * Set PSR power optimization flags.
   232	 */
   233	static void dmub_psr_set_power_opt(struct dmub_psr *dmub, unsigned int power_opt)
   234	{
   235		union dmub_rb_cmd cmd;
   236		struct dc_context *dc = dmub->ctx;
   237	
   238		memset(&cmd, 0, sizeof(cmd));
   239		cmd.psr_set_power_opt.header.type = DMUB_CMD__PSR;
   240		cmd.psr_set_power_opt.header.sub_type = DMUB_CMD__SET_PSR_POWER_OPT;
   241		cmd.psr_set_power_opt.header.payload_bytes = sizeof(struct dmub_cmd_psr_set_power_opt_data);
   242		cmd.psr_set_power_opt.psr_set_power_opt_data.power_opt = power_opt;
   243	
   244		dc_dmub_srv_cmd_queue(dc->dmub_srv, &cmd);
   245		dc_dmub_srv_cmd_execute(dc->dmub_srv);
   246		dc_dmub_srv_wait_idle(dc->dmub_srv);
   247	}
   248	

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