Re: [PATCH v2] kernel-doc: validate kernel-doc markup with the actual names

[kernel test robot <lkp@intel.com>]

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

Hi Mauro,

I love your patch! Perhaps something to improve:

[auto build test WARNING on linus/master]
[also build test WARNING on next-20201023]
[cannot apply to lwn/docs-next linux/master v5.9]
[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]

url:    https://github.com/0day-ci/linux/commits/Mauro-Carvalho-Chehab/kernel-doc-validate-kernel-doc-markup-with-the-actual-names/20201023-170132
base:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git f9893351acaecf0a414baf9942b48d5bb5c688c6
config: parisc-defconfig (attached as .config)
compiler: hppa-linux-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://github.com/0day-ci/linux/commit/234e4a9d3907dbf2a71da9a2f49007e19d2a2e68
        git remote add linux-review https://github.com/0day-ci/linux
        git fetch --no-tags linux-review Mauro-Carvalho-Chehab/kernel-doc-validate-kernel-doc-markup-with-the-actual-names/20201023-170132
        git checkout 234e4a9d3907dbf2a71da9a2f49007e19d2a2e68
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-9.3.0 make.cross ARCH=parisc 

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/tty/serial/mux.c:118: warning: Function parameter or member 'port' not described in 'mux_set_mctrl'
   drivers/tty/serial/mux.c:118: warning: Excess function parameter 'ports' description in 'mux_set_mctrl'
>> drivers/tty/serial/mux.c:371: warning: expecting prototype for mux_drv_poll(). Prototype was for mux_poll() instead

vim +371 drivers/tty/serial/mux.c

^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  363  
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  364  /**
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  365   * mux_drv_poll - Mux poll function.
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  366   * @unused: Unused variable
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  367   *
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  368   * This function periodically polls the Serial MUX to check for new data.
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  369   */
e99e88a9d2b0674 drivers/tty/serial/mux.c Kees Cook      2017-10-16  370  static void mux_poll(struct timer_list *unused)
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16 @371  {  
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  372  	int i;
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  373  
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  374  	for(i = 0; i < port_cnt; ++i) {
4bd5d82779466a2 drivers/serial/mux.c     Ryan Bradetich 2006-11-03  375  		if(!mux_ports[i].enabled)
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  376  			continue;
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  377  
4bd5d82779466a2 drivers/serial/mux.c     Ryan Bradetich 2006-11-03  378  		mux_read(&mux_ports[i].port);
4bd5d82779466a2 drivers/serial/mux.c     Ryan Bradetich 2006-11-03  379  		mux_write(&mux_ports[i].port);
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  380  	}
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  381  
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  382  	mod_timer(&mux_timer, jiffies + MUX_POLL_DELAY);
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  383  }
^1da177e4c3f415 drivers/serial/mux.c     Linus Torvalds 2005-04-16  384  

---
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: 18434 bytes --]