[at91-linux:preview/at91-soc 1/8] drivers/clk/at91/sama7g5.c:39: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

* [at91-linux:preview/at91-soc 1/8] drivers/clk/at91/sama7g5.c:39: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
@ 2021-06-02 11:31 ` kernel test robot
  0 siblings, 0 replies; 2+ messages in thread
From: kernel test robot @ 2021-06-02 11:31 UTC (permalink / raw)
  To: Eugen Hristev; +Cc: kbuild-all, Nicolas Ferre, Claudiu Beznea, linux-doc

[-- Attachment #1: Type: text/plain, Size: 4267 bytes --]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/at91/linux.git preview/at91-soc
head:   48f78efa7ea5b868c98e454106043462d0505ea2
commit: 8139097bc26a91e3642236c656aeed5ba1bbefb1 [1/8] ARM: at91: add new SoC sama7g5
config: arm-defconfig (attached as .config)
compiler: arm-linux-gnueabi-gcc (GCC) 9.3.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/at91/linux.git/commit/?id=8139097bc26a91e3642236c656aeed5ba1bbefb1
        git remote add at91-linux https://git.kernel.org/pub/scm/linux/kernel/git/at91/linux.git
        git fetch --no-tags at91-linux preview/at91-soc
        git checkout 8139097bc26a91e3642236c656aeed5ba1bbefb1
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-9.3.0 make.cross ARCH=arm 

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/clk/at91/sama7g5.c:39: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * PLL clocks identifiers
   drivers/clk/at91/sama7g5.c:60: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * PLL type identifiers
   drivers/clk/at91/sama7g5.c:122: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * PLL clocks description
   drivers/clk/at91/sama7g5.c:289: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Master clock (MCK[1..4]) description
   drivers/clk/at91/sama7g5.c:341: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * System clock description
   drivers/clk/at91/sama7g5.c:365: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Peripheral clock description
   drivers/clk/at91/sama7g5.c:453: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Generic clock description

vim +39 drivers/clk/at91/sama7g5.c

cb783bbbcf54c3 Claudiu Beznea 2020-07-22  37  
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  38  /**
cb783bbbcf54c3 Claudiu Beznea 2020-07-22 @39   * PLL clocks identifiers
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  40   * @PLL_ID_CPU:		CPU PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  41   * @PLL_ID_SYS:		System PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  42   * @PLL_ID_DDR:		DDR PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  43   * @PLL_ID_IMG:		Image subsystem PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  44   * @PLL_ID_BAUD:	Baud PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  45   * @PLL_ID_AUDIO:	Audio PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  46   * @PLL_ID_ETH:		Ethernet PLL identifier
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  47   */
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  48  enum pll_ids {
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  49  	PLL_ID_CPU,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  50  	PLL_ID_SYS,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  51  	PLL_ID_DDR,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  52  	PLL_ID_IMG,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  53  	PLL_ID_BAUD,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  54  	PLL_ID_AUDIO,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  55  	PLL_ID_ETH,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  56  	PLL_ID_MAX,
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  57  };
cb783bbbcf54c3 Claudiu Beznea 2020-07-22  58  

:::::: The code at line 39 was first introduced by commit
:::::: cb783bbbcf54c36256006895c215e86c5e7266d8 clk: at91: sama7g5: add clock support for sama7g5

:::::: TO: Claudiu Beznea <claudiu.beznea@microchip.com>
:::::: CC: Stephen Boyd <sboyd@kernel.org>

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 54746 bytes --]

^ permalink raw reply	[flat|nested] 2+ messages in thread