Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

comedi: drivers: ni_tio: Fix slightly broken kernel-doc and demote others

Fixes the following W=1 kernel build warning(s):

drivers/staging/comedi/drivers/ni_tio.c:1515: warning: Function parameter or member 'counter_dev' not described in 'ni_tio_get_routing'
drivers/staging/comedi/drivers/ni_tio.c:1515: warning: Function parameter or member 'dest' not described in 'ni_tio_get_routing'
drivers/staging/comedi/drivers/ni_tio.c:1515: warning: expecting prototype for Retrieves the register value of the current source of the output selector for(). Prototype was for ni_tio_get_routing() instead
drivers/staging/comedi/drivers/ni_tio.c:1544: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/staging/comedi/drivers/ni_tio.c:1584: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Cc: Ian Abbott <abbotti@mev.co.uk>
Cc: H Hartley Sweeten <hsweeten@visionengravers.com>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Mori Hess <fmhess@users.sourceforge.net>
Cc: "J.P. Mellor" <jpmellor@rose-hulman.edu>
Cc: Herman.Bruyninckx@mech.kuleuven.ac.be
Cc: Wim.Meeussen@mech.kuleuven.ac.be
Cc: Klaas.Gadeyne@mech.kuleuven.ac.be
Cc: Comedi <comedi@comedi.org>
Cc: linux-staging@lists.linux.dev
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20210520122538.3470259-4-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
7b89d91c 4d070b8b

+6 -6
+6 -6
drivers/comedi/drivers/ni_tio.c
··· 1501 1501 } 1502 1502 EXPORT_SYMBOL_GPL(ni_tio_insn_config); 1503 1503 1504 - /** 1504 + /* 1505 1505 * Retrieves the register value of the current source of the output selector for 1506 1506 * the given destination. 1507 1507 * ··· 1541 1541 EXPORT_SYMBOL_GPL(ni_tio_get_routing); 1542 1542 1543 1543 /** 1544 - * Sets the register value of the selector MUX for the given destination. 1545 - * @counter_dev:Pointer to general counter device. 1546 - * @destination:Device-global identifier of route destination. 1547 - * @register_value: 1544 + * ni_tio_set_routing() - Sets the register value of the selector MUX for the given destination. 1545 + * @counter_dev: Pointer to general counter device. 1546 + * @dest: Device-global identifier of route destination. 1547 + * @reg: 1548 1548 * The first several bits of this value should store the desired 1549 1549 * value to write to the register. All other bits are for 1550 1550 * transmitting information that modify the mode of the particular ··· 1580 1580 } 1581 1581 EXPORT_SYMBOL_GPL(ni_tio_set_routing); 1582 1582 1583 - /** 1583 + /* 1584 1584 * Sets the given destination MUX to its default value or disable it. 1585 1585 * 1586 1586 * Return: 0 if successful; -EINVAL if terminal is unknown.