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

kernel test robot
2020-10-23T11:25:44Z

[-- 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 --]