Re: [PATCH v6 2/8] usb: dwc3: core: Access XHCI address space temporarily to read port info

[kernel test robot]

Hi Krishna,

kernel test robot noticed the following build warnings:

[auto build test WARNING on usb/usb-linus]
[also build test WARNING on robh/for-next linus/master v6.3-rc5 next-20230405]
[cannot apply to usb/usb-testing usb/usb-next pza/reset/next pza/imx-drm/next]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]

url:    https://github.com/intel-lab-lkp/linux/commits/Krishna-Kurapati/dt-bindings-usb-Add-bindings-for-multiport-properties-on-DWC3-controller/20230405-210221
base:   https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/usb.git usb-linus
patch link:    https://lore.kernel.org/r/20230405125759.4201-3-quic_kriskura%40quicinc.com
patch subject: [PATCH v6 2/8] usb: dwc3: core: Access XHCI address space temporarily to read port info
reproduce:
        # https://github.com/intel-lab-lkp/linux/commit/a0de434ac81429422ecdf84fe968bd8c3f73445b
        git remote add linux-review https://github.com/intel-lab-lkp/linux
        git fetch --no-tags linux-review Krishna-Kurapati/dt-bindings-usb-Add-bindings-for-multiport-properties-on-DWC3-controller/20230405-210221
        git checkout a0de434ac81429422ecdf84fe968bd8c3f73445b
        make menuconfig
        # enable CONFIG_COMPILE_TEST, CONFIG_WARN_MISSING_DOCUMENTS, CONFIG_WARN_ABI_ERRORS
        make htmldocs

If you fix the issue, kindly add following tag where applicable
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Link: https://lore.kernel.org/oe-kbuild-all/202304060712.gqBA4oqQ-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> ./drivers/usb/dwc3/core.h:1666: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

vim +1666 ./drivers/usb/dwc3/core.h

  1664	
  1665	/**
> 1666	 * Find the offset of the extended capabilities with capability ID id.
  1667	 *
  1668	 * @base	PCI MMIO registers base address.
  1669	 * @start	address at which to start looking, (0 or HCC_PARAMS to start at
  1670	 *		beginning of list)
  1671	 * @id		Extended capability ID to search for, or 0 for the next
  1672	 *		capability
  1673	 *
  1674	 * Returns the offset of the next matching extended capability structure.
  1675	 * Some capabilities can occur several times, e.g., the XHCI_EXT_CAPS_PROTOCOL,
  1676	 * and this provides a way to find them all.
  1677	 */
  1678	

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